archived-doc-ja/reference/mysqli/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 90787fda14dcb0976a9738423e6c6013c037d048 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi,mumumu -->
<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></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>bool</type>
   </term>
   <listitem>
    <para>
     PHP 側から、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>
     LOCAL DATA 文によるファイルのロードを、
     ここで指定したディレクトリに制限する機能を有効にします。
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mysqli.allow-persistent">
   <term>
    <parameter>mysqli.allow_persistent</parameter>
    <type>bool</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 ポート番号。デフォルトが指定されない場合は、
     環境変数 <envar>MYSQL_TCP_PORT</envar>・
     <filename>/etc/services</filename> の
     <literal>mysql-tcp</literal>エントリ・コンパイル時の
     <constant>MYSQL_PORT</constant> 定数の順番でポートが取得されます。
     Win32 では、<constant>MYSQL_PORT</constant> 定数のみが使用されます。
    </para>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ini.mysqli.default-socket">
   <term>
    <parameter>mysqli.default_socket</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     他にソケット名が指定されない場合、ローカルな
     データベースサーバーに接続する時のデフォルトのソケット名。
    </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_password</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>
     このオプションを有効にすると、接続を閉じて時持続的接続プールに接続を戻す前に、
     この接続で保留中だったあらゆるトランザクションがロールバックされます。
     このオプションが無効だった場合、接続が再利用されるとき、または実際に閉じられるときだけ、
     保留中のトランザクションがロールバックされます。
    </para>
   </listitem>
  </varlistentry>
  
 </variablelist>
 </para>
 <para>
   <literal>MYSQL_OPT_READ_TIMEOUT</literal> を、
   API コールや実行時の設定で指定することはできません。
   もしそんなことができてしまうと、<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
-->