インストール

Unix へのインストール

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

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

./configure --with-mysql=mysqlnd \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
[other options]

Windows へのインストール

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

SHA-256 認証プラグインのサポート

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

./configure --with-mysql=mysqlnd \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
--with-openssl
[その他のオプション]

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

変更履歴

バージョン 説明
8.4.0 openssl 拡張機能なしでビルドする場合に、拡張SSLサポートを明示的に有効にできるよう、 --with-mysqlnd-ssl Autotools 設定オプションが、追加されました。