reference.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6b5b64c2552eba77e78556b9ab62f6d64aacff8e Maintainer: takagi Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
 <reference xml:id="ref.pdo-mysql" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="bundledexternal" ?>
  <title>MySQL 関数 (PDO_MYSQL)</title>
  <titleabbrev>MySQL (PDO)</titleabbrev>
  <partintro>

   <section xml:id="ref.pdo-mysql.intro">
   &reftitle.intro;
    <para>
     PDO_MYSQL は、PHP から MySQL データベースへのアクセスを可能にするための
     <link linkend="intro.pdo">PHP Data
     Objects (PDO) インターフェイス</link> を実装したドライバです。
    </para>
    <para>
     PDO_MYSQLは、
     デフォルトでエミュレートされたプリペアドステートメントを使います。
    </para>

    <para>
      <emphasis role="bold">MySQL 8</emphasis>
    </para>

    <para>
     PHP 7.1.16 より前のバージョン、もしくは PHP 7.2.4 より前の 7.2系の PHP では、
     MySQL 8 サーバーのデフォルトパスワードプラグインを
     <emphasis>mysql_native_password</emphasis> に設定するようにしてください。
     さもないと、
     <emphasis>The server requested authentication method unknown to the client [caching_sha2_password]</emphasis>
     のようなエラーを見ることになります。たとえあなたが
     <emphasis>caching_sha2_password</emphasis> を使っていなくても、です。
    </para>
    <para>
     これは MySQL 8 のデフォルトが 古い PHP (mysqlnd) 
     のリリースが認識していないプラグイン caching_sha2_password だからです。
     かわりに、<filename>my.cnf</filename> の設定を
     <literal>default_authentication_plugin=mysql_native_password</literal>
     と変更してください。
     <emphasis>caching_sha2_password</emphasis> プラグインは、
     PHP 7.4.4 以降で完全にサポートされました。
     これより前のバージョンでは、
     <link linkend="book.mysql-xdevapi">mysql_xdevapi</link>
     拡張モジュールでサポートされています。
    </para>

    <warning>
     <para>
      注意: MySQL のテーブル型 (ストレージエンジン) の中には、
      トランザクションをサポートしていないものがあります。
      トランザクションをサポートしていないテーブル型を使用して
      トランザクションを使用するコードを書くと、
      MySQL はトランザクションが正常に使用できたかのように振舞います。
      さらに、DDL クエリを実行する際には、
      実行中のトランザクションが暗黙的にコミットされます。
     </para>
    </warning>
    <note>
     <para>
      MySQL ドライバは、
      <methodname>PDOStatement::bindParam</methodname> メソッドで
      <constant>PDO::PARAM_INPUT_OUTPUT</constant>
      を適切にサポートしていません。使うことはできますが、
      値が更新されません。(つまり、出力が無視されています)
     </para>
    </note>
   </section>
   &reference.pdo-mysql.configure;
   &reference.pdo-mysql.constants;
   &reference.pdo-mysql.ini;
  </partintro>

  <refentry xml:id="ref.pdo-mysql.connection">
   <refnamediv>
    <refname>PDO_MYSQL DSN</refname>
    <refpurpose>MySQL データベースに接続する</refpurpose>
   </refnamediv>

   <refsect1 role="description">
    &reftitle.description;
    <para>
     PDO_MYSQL データソース名 (DSN) は以下の要素で構成されます。
     <variablelist>
      <varlistentry>
       <term>DSN 接頭辞</term>
       <listitem>
        <para>
        DSN 接頭辞は <userinput>mysql:</userinput> です。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><literal>host</literal></term>
       <listitem>
        <para>
         データベースサーバーが存在するホスト名を指定します。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><literal>port</literal></term>
       <listitem>
        <para>
         データベースサーバーが待機しているポートを指定します。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><literal>dbname</literal></term>
       <listitem>
        <para>
         データベース名を指定します。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><literal>unix_socket</literal></term>
       <listitem>
        <para>
         MySQL の unix ソケットを指定します (<literal>host</literal>
         あるいは <literal>port</literal> と同時に使用することはできません)。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><literal>charset</literal></term>
       <listitem>
        <para>
         文字セット。詳細は、
         <link linkend="mysqlinfo.concepts.charset">文字セットの概念</link>
         を参照ください。
        </para>
       </listitem>
      </varlistentry>
     </variablelist>
    </para>
   </refsect1>

   <refsect1 role="examples">
    &reftitle.examples;
    <para>
     <example>
      <title>PDO_MYSQL DSN の例</title>
      <para>
       以下の例は、MySQL データベースに接続するための PDO_MYSQL DSN
       を表します。
       <programlisting>
<![CDATA[
mysql:host=localhost;dbname=testdb
]]>
       </programlisting>
       より完全な例は、このようになります。
       <programlisting>
<![CDATA[
mysql:host=localhost;port=3307;dbname=testdb
mysql:unix_socket=/tmp/mysql.sock;dbname=testdb
]]>
       </programlisting>
      </para>
     </example>
    </para>
   </refsect1>

   <refsect1 role="notes">
    &reftitle.notes;
    <note>
     <title>Unix のみ</title>
     <para>
      ホスト名を <literal>"localhost"</literal> にすると、
      サーバーへの接続はドメインソケットを使って行われます。
      libmysqlclient を使って PDO_MYSQL をコンパイルした場合は、
      ソケットファイルの場所は libmysqlclient のコンパイル時の場所になります。
      mysqlnd を使って PDO_MYSQL をコンパイルした場合は、デフォルトのソケットは
      <link linkend="ini.pdo-mysql.default-socket">
      pdo_mysql.default_socket</link> の設定を使って作られます。
     </para>
    </note>
   </refsect1>
  </refentry>

 </reference>

<!-- 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
-->