<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/mysqli.setup.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'mysqli.installation.php',
    1 => 'インストール手順',
    2 => 'インストール手順',
  ),
  'up' => 
  array (
    0 => 'mysqli.setup.php',
    1 => 'インストール/設定',
  ),
  'prev' => 
  array (
    0 => 'mysqli.requirements.php',
    1 => '要件',
  ),
  'next' => 
  array (
    0 => 'mysqli.configuration.php',
    1 => '実行時設定',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'reference/mysqli/configure.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="mysqli.installation" class="section">

<h2 class="title">インストール手順</h2>

 <p class="para">
  <code class="literal">mysqli</code> 拡張モジュールが使えるようになったのは PHP バージョン
  5.0.0 以降です。また、MySQL Native Driver が PHP に含まれるようになったのはバージョン 5.3.0 以降です。
 </p>

 <div class="section" id="mysqli.installation.linux">

  <h2 class="title">Linux でのインストール</h2>

  <p class="para">
   一般的な Unix ディストリビューションには、バイナリ版の PHP がインストールされています。
   これらのバイナリ版は、通常は MySQL 拡張モジュールに対応したものになっています。
   しかし、拡張モジュールライブラリ自身を別パッケージでインストールする必要があるでしょう。
   使用しているディストリビューションのパッケージマネージャで確認してみましょう。
  </p>
  
  <p class="para">
   たとえば Ubuntu なら、<code class="literal">php5-mysql</code> パッケージをインストールすれば、
   ext/mysql、ext/mysqli、そして pdo_mysql をインストールできます。CentOS の場合は
   <code class="literal">php-mysql</code> パッケージを使えば、同じものをインストールできます。
  </p>

  <p class="para">
   この拡張モジュールを自分でコンパイルすることもできます。
   PHP をソースからビルドすれば、使いたい MySQL 拡張モジュールを指定したり
   各拡張モジュールが使用するクライアントライブラリを選択したりすることができます。
  </p>

  <p class="para">
   クライアントライブラリには MySQL Native Driver を使うことを推奨します。
   そのほうがパフォーマンスが向上し、MySQL Client Library
   を使用した場合には使えない機能も使用することができます。
   <a href="mysqli.overview.php#mysqli.overview.mysqlnd" class="link">PHP の MySQL Native
   Driver とは?</a>
   に、MySQL Native Driver の利点が簡単にまとめられています。
  </p>

  <p class="para">
   <code class="literal">/path/to/mysql_config</code> は、MySQL Server に含まれる
   <code class="literal">mysql_config</code> プログラムの場所を表します。
  </p>

  <table id="mysqli.installation.time.matrix" class="doctable table">
   <caption><strong>mysqli のコンパイル時のサポート表</strong></caption>
   
    <thead>
     <tr>
      <th>PHP バージョン</th>
      <th>デフォルト</th>
      <th>設定オプション: <a href="mysqlnd.overview.php" class="link">mysqlnd</a></th>
      <th>設定オプション: <code class="literal">libmysqlclient</code></th>
      <th>変更履歴</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>5.4.x 以降</td>
      <td>mysqlnd</td>
      <td><strong class="option configure">--with-mysqli</strong></td>
      <td><strong class="option configure">--with-mysqli=/path/to/mysql_config</strong></td>
      <td>mysqlnd がデフォルトになりました。</td>
     </tr>

     <tr>
      <td>5.3.x</td>
      <td>libmysqlclient</td>
      <td><strong class="option configure">--with-mysqli=mysqlnd</strong></td>
      <td><strong class="option configure">--with-mysqli=/path/to/mysql_config</strong></td>
      <td>mysqlnd が使えるようになりました。</td>
     </tr>

     <tr>
      <td>5.0.x, 5.1.x, 5.2.x</td>
      <td>libmysqlclient</td>
      <td>利用できません</td>
      <td><strong class="option configure">--with-mysqli=/path/to/mysql_config</strong></td>
      <td>mysqlnd は使えません。</td>
     </tr>

    </tbody>
   
  </table>


  <p class="para">
   MySQL 拡張モジュールとクライアントライブラリの組み合わせは自由であることに注意しましょう。
   たとえば、MySQL 拡張モジュールは MySQL Client Library (libmysqlclient) を使うようにして有効にし、
   一方 <code class="literal">mysqli</code> 拡張モジュールは MySQL Native Driver
   を使うようにするということも可能です。
   しかし、それ以外にも拡張モジュールとクライアントライブラリのすべての組み合わせが使用可能です。
  </p>

 </div>

 <div class="section" id="mysqli.installation.windows">

  <h2 class="title">Windows システムでのインストール</h2>

  <p class="para">
   Windows の場合、<var class="filename">php_mysqli.dll</var> を <var class="filename">php.ini</var> で有効にする必要があります。
  </p>

  <p class="para">
   その他の PHP 拡張モジュール (<var class="filename">php_mysqli.dll</var> など)
   を有効にするときと同様、PHP のディレクティブ
   <a href="ini.core.php#ini.extension-dir" class="link">extension_dir</a>
   を設定して PHP 拡張モジュールのある場所を指定する必要があります。
   <a href="install.windows.manual.php" class="link">Windows
   での手動インストールの手順</a> も参照ください。
   <code class="literal">extension_dir</code> の値は、たとえば <var class="filename">c:\php\ext</var> のようになります。
  </p>

  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
    ウェブサーバーの起動時に
    <code class="literal">&quot;Unable to load dynamic library
    &#039;./php_mysqli.dll&#039;&quot;</code>
    のようなエラーが出たら、それは
    <var class="filename">php_mysqli.dll</var>  をシステムが見つけられないことが原因です。
   </p>
  </p></blockquote>

 </div>

</div><?php manual_footer($setup); ?>