install.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af432424136ff55777bd92ff4f83f01594612ef1 Maintainer: satoruyoshida Status: ready -->
<!-- Credits: mumumu -->
<chapter xml:id="mysqlnd.install" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

  <title>インストール</title>

  <para>
    <emphasis role="bold">Unix へのインストール</emphasis>
  </para>

  <para>
    MySQL Native Driver を使うには、MySQL データベース拡張モジュールを MySQL Native Driver のサポート付でコンパイルすることを指定して PHP をビルドする必要があります。
    これは、PHP のソースコードをビルドする前に、設定オプションを通じて行なわれます。
  </para>

  <para>
    例えば MySQL Native Driver を用いて、
    MySQL 拡張モジュール <literal>mysqli</literal> と、
    PDO MYSQL をビルドするには、以下のコマンドを使います。
  </para>

<programlisting role="shell">
<![CDATA[
./configure --with-mysql=mysqlnd \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
[other options]
]]>
</programlisting>

  <para>
    <emphasis role="bold">Windows へのインストール</emphasis>
  </para>

  <para>
    公式な Windows 版の PHP では、
    MySQL Native Driver がデフォルトで使用可能です。
    そのため、使用するための追加の構成は不要です。
    この場合は MySQLデータベース拡張モジュールは全て MySQL Native Driver を使用します。
  </para>

  <para>
    <emphasis role="bold">SHA-256 認証プラグインのサポート</emphasis>
  </para>

  <para>
    MySQL Native Driver で MySQL SHA-256 認証プラグインを使ったアカウントによる
    MySQL への接続をするには、PHP の OpenSSL 機能を組み込んで有効にしておく必要があります。
    たとえば、PHP を次のような設定でビルドします。
  </para>

<programlisting role="shell">
<![CDATA[
./configure --with-mysql=mysqlnd \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
--with-openssl
[その他のオプション]
]]>
</programlisting>

<para>
 Autotoolsでは、 <option role="configure">--with-openssl</option> オプションを使用して
 <literal>openssl</literal> 拡張機能とともにビルドする場合、 <literal>mysqlnd</literal> の拡張SSLサポートは自動的に有効になります。
 <literal>openssl</literal> 拡張機能なしでビルドする場合は、<option role="configure">--with-mysqlnd-ssl</option>
 Autotools オプションを使用することで、明示的に拡張SSLサポートを有効化できます。
</para>

<simplesect role="changelog">
 &reftitle.changelog;
 <para>
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.4.0</entry>
      <entry>
       <literal>openssl</literal> 拡張機能なしでビルドする場合に、拡張SSLサポートを明示的に有効にできるよう、
       <option role="configure">--with-mysqlnd-ssl</option> Autotools 設定オプションが、追加されました。
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </para>
</simplesect>

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