archived-doc-pt-br/reference/mysqli/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 90787fda14dcb0976a9738423e6c6013c037d048 Maintainer: leonardolara Status: ready --><!-- CREDITS: diegopires,fernandoc,ae,leonardolara -->
<section xml:id="mysqli.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table xml:id="mysqli.configuration.options">
   <title>Opções de configuração do MySQLi</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="mysqli.configuration.list">
     <row>
      <entry><link linkend="ini.mysqli.allow-local-infile">mysqli.allow_local_infile</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Antes do PHP 7.2.16 e 7.3.3 o padrão era "1".</entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.local-infile-directory">mysqli.local_infile_directory</link></entry>
      <entry></entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponível desde o PHP 8.1.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.allow-persistent">mysqli.allow_persistent</link></entry>
      <entry>"1"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.max-persistent">mysqli.max_persistent</link></entry>
      <entry>"-1"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.max-links">mysqli.max_links</link></entry>
      <entry>"-1"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-port">mysqli.default_port</link></entry>
      <entry>"3306"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-socket">mysqli.default_socket</link></entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-host">mysqli.default_host</link></entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-user">mysqli.default_user</link></entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-pw">mysqli.default_pw</link></entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.reconnect">mysqli.reconnect</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Removido no PHP 8.2.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.rollback-on-cached-plink">mysqli.rollback_on_cached_plink</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
 <para>
  Para maiores detalhes e definições das constantes INI_* acima, veja
  o capítulo sobre <link linkend="configuration.changes">mudanças de
  configuração</link>.
 </para>

 &ini.descriptions.title;

 <para>
 <variablelist>

  <varlistentry xml:id="ini.mysqli.allow-local-infile">
   <term>
    <parameter>mysqli.allow_local_infile</parameter>
    <type>bool</type>
   </term>
   <listitem>
    <para>
     Permite acessar, direto do PHP, arquivos locais com comandos
     LOAD DATA
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mysqli.local-infile-directory">
   <term>
    <parameter>mysqli.local_infile_directory</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     Permite restringir o carregamento de LOCAL DATA para arquivos localizados
     neste diretório.
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mysqli.allow-persistent">
   <term>
    <parameter>mysqli.allow_persistent</parameter>
    <type>bool</type>
   </term>
   <listitem>
    <para>
     Habilita a possibilidade de criar conexões persistentes usando
     <function>mysqli_connect</function>.
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ini.mysqli.max-persistent">
   <term>
    <parameter>mysqli.max_persistent</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     Número máximo de conexões simultâneas que podem ser estabelecidas. Definir como
     0 para ilimitadas.
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ini.mysqli.max-links">
   <term>
    <parameter>mysqli.max_links</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     O número máximo de conexões MySQL por processo.
    </para>
   </listitem>
  </varlistentry>
   <varlistentry xml:id="ini.mysqli.default-port">
   <term>
    <parameter>mysqli.default_port</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     O número da porta TCP padrão para usar ao conectar ao
     servidor de banco de dados se não for especificada outra porta. Se
     não for especificado um padrão, então a porta será obtida da
     variável de ambiênte <literal>MYSQL_TCP_PORT</literal>,
     a entrada <literal>mysql-tcp</literal> em
     <filename>/etc/services</filename> ou a constante em tempo de compilação
     <literal>MYSQL_PORT</literal>, nesta ordem. Em Win32
     será usada apenas a constante <literal>MYSQL_PORT</literal>.
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mysqli.default-socket">
   <term>
    <parameter>mysqli.default_socket</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     O nome padrão do socket para usar ao conectar com um servidor
     de banco de dados local, se não for especificado outro nome de socket.
    </para>
   </listitem>
  </varlistentry>
   <varlistentry xml:id="ini.mysqli.default-host">
   <term>
    <parameter>mysqli.default_host</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     O servidor padrão para usar ao conectar com o servidor
     de banco de dados se não for especificado um servidor. Não se aplica em
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mysqli.default-user">
   <term>
    <parameter>mysqli.default_user</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     O nome de usuário padrão para usar ao conectar com o
     servidor de banco de dados. Não se aplica em
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mysqli.default-pw">
   <term>
    <parameter>mysqli.default_pw</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     A senha padrão para usar ao conectar ao servidor de
     banco de dados se não for especificado outra senha. Não se aplica em
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mysqli.reconnect">
   <term>
    <parameter>mysqli.reconnect</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     Reconectar automaticamente ao perder a conexão.
    </para>
    <note>
     <simpara>Esta configuração do &php.ini; é ignorada pelo driver mysqlnd,
      e foi removida no PHP 8.2.0.
     </simpara>
    </note>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mysqli.rollback-on-cached-plink">
   <term>
    <parameter>mysqli.rollback_on_cached_plink</parameter>
    <type>bool</type>
   </term>
   <listitem>
    <para>
     Se essa opção for ativada, o fechamento de uma conexão persistente fará o rollback
     de todas as transações pendentes dessa conexão antes que
     ela seja colocada de volta no pool de conexão persistente.
     Caso contrário, as transações pendentes serão revertidas apenas quando a conexão for reutilizada ou quando for realmente fechada.
    </para>
   </listitem>
  </varlistentry>

 </variablelist>
 </para>
 <para>
   Usuários não podem modificar <literal>MYSQL_OPT_READ_TIMEOUT</literal> via chamada de API
   ou configuração em tempo de execução. Note que se fosse possível haveria
   diferenças entre como a <literal>libmysqlclient</literal> e
   os streams iriam interpretar o valor de <literal>MYSQL_OPT_READ_TIMEOUT</literal>.
 </para>
</section>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->