ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f26734be49cca400204fcf3243271c7ff138823d Maintainer: HonestQiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<section xml:id="mysqli.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table xml:id="mysqli.configuration.options">
   <title>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>在 PHP 7.2.16 和 7.3.3 之前，默认值为 "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>自 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>自PHP 5.0.0起可用。</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>自 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>
 关于前面出现的INI_*系列常量的详细定义，请参阅<link linkend="configuration.changes">配置的修改</link>一章。
 </para>

 &ini.descriptions.title;

 <para>
 <variablelist>
  
  
  <varlistentry xml:id="ini.mysqli.allow-local-infile">
   <term>
    <parameter>mysqli.allow_local_infile</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     允许Mysql的Load Data语句访问PHP角度看的本地文件。
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mysqli.local-infile-directory">
   <term>
    <parameter>mysqli.local_infile_directory</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     限制加载 LOCAL DATA 文件为指定的目录。
    </para>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.mysqli.allow-persistent">
   <term>
    <parameter>mysqli.allow_persistent</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
    开启使用<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>
    可以创建的持久化连接的最大数量，设置为0表明不限制。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ini.mysqli.max-links">
   <term>
    <parameter>mysqli.max_links</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
    每个进程中Mysql连接的最大数量。
    </para>
   </listitem>
  </varlistentry>
   <varlistentry xml:id="ini.mysqli.default-port">
   <term>
    <parameter>mysqli.default_port</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
    当没有指定其他端口号时使用的默认的用于连接数据库服务器的TCP端口号。如果没有设置默认值，
    端口号将会按照顺序从环境变量<literal>MYSQL_TCP_PORT</literal>，<filename>/etc/services</filename>
    文件中的<literal>mysql-tcp</literal>条目或编译期的<literal>MYSQL_PORT</literal>常量等位置获取。
    Win32仅使用<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>
    当连接到本地数据库服务器时如果没有指定其他socket名称，使用的默认socket名称。
    </para>
   </listitem>
  </varlistentry>
  
  

  
   <varlistentry xml:id="ini.mysqli.default-host">
   <term>
    <parameter>mysqli.default_host</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
    当连接到数据库服务器时， 如果没有指定其他主机地址，使用的默认服务器主机。
    </para>
   </listitem>
  </varlistentry>

  

  
  <varlistentry xml:id="ini.mysqli.default-user">
   <term>
    <parameter>mysqli.default_user</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
    当连接到数据库服务器时，如果没有指定其他用户名，使用的默认用户名。
    </para>
   </listitem>
  </varlistentry>
  
    <varlistentry xml:id="ini.mysqli.default-pw">
   <term>
    <parameter>mysqli.default_pw</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
    当连接到数据库服务器时，如果没有指定其他密码，使用的默认密码。
    </para>
   </listitem>
  </varlistentry>
  
  
    <varlistentry xml:id="ini.mysqli.reconnect">
   <term>
    <parameter>mysqli.reconnect</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
    连接丢失时是否自动重新连接。
    </para>
    <note>
     <simpara>mysqlnd 驱动已此忽略此 &php.ini; 设置，并于 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>
     If this option is enabled, closing a persistent connection will rollback
     any pending transactions of this connection before it is put back into the
     persistent connection pool. Otherwise, pending transactions will be rolled
     back only when the connection is reused, or when it is actually closed.
    </para>
   </listitem>
  </varlistentry>
  
 </variablelist>
 </para>
 <para>
 用户不能通过API调用或运行时配置来设置<literal>MYSQL_OPT_READ_TIMEOUT</literal>。
 注意，如果可能这样做那么<literal>libmysqlclient</literal>和流对<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
-->