インストール手順

警告

この拡張モジュールは PHP 5.5.0 で非推奨になり、PHP 7.0.0 で削除されました。 MySQLi あるいは PDO_MySQL を使うべきです。詳細な情報は MySQL: API の選択を参照ください。この関数の代替として、これらが使えます。

コンパイルするには、単純に --with-mysql[=DIR] 設定オプションを利用してください。ここで、オプションの [DIR] は MySQL がインストールされているディレクトリを表します。

この MySQL 拡張モジュールは MySQL 4.1.0 以降とも互換性がありますが、それ以降のバージョンが提供する新機能はサポートしていません。この機能を使用するには、 MySQLi 拡張モジュールを使用してください。

もし mysql 拡張モジュールと mysqli 拡張モジュールを同時にインストールしたい場合は、衝突を避けるために両方で同じクライアントライブラリを用いる必要があります。

Linux へのインストール

注意: [DIR] は MySQL クライアントライブラリファイル (ヘッダやライブラリファイル) へのパスです。これらのファイルは » MySQL からダウンロードできます。

**ext/mysql のコンパイル時のサポート表**
PHP バージョン	デフォルト	設定オプション: mysqlnd	設定オプション: `libmysqlclient`	変更履歴
4.x.x	libmysqlclient	利用できません	--without-mysql で無効化	MySQL はデフォルトで有効になります。MySQL クライアントライブラリも同梱されています。
5.0.x, 5.1.x, 5.2.x	libmysqlclient	利用できません	--with-mysql=[DIR]	MySQL はデフォルトでは有効にならなくなりました。また、MySQL クライアントライブラリも同梱されなくなりました。
5.3.x	libmysqlclient	--with-mysql=mysqlnd	--with-mysql=[DIR]	mysqlnd が使えるようになりました。
5.4.x	mysqlnd	--with-mysql	--with-mysql=[DIR]	mysqlnd がデフォルトになりました。

Windows へのインストール

PHP 5.0.x, 5.1.x, 5.2.x

MySQL はもはやデフォルトでは有効となりません。したがって php.ini で php_mysql.dll DLL を有効にしておく必要があります。また、PHP が MySQL クライアントライブラリにアクセスできなければなりません。 libmysqlclient.dll というファイルが Windows 版の PHP 配布ファイルに含まれており、PHP が MySQL と話すためにはこのファイルが Windows の PATH にある必要があります。そのための方法については、 "Windows で PHP のディレクトリを PATH に追加するにはどうすればいいのですか?" という FAQ を参照ください。 libmysqlclient.dll を Windows のシステムディレクトリにコピーしても動作しますが (システムディレクトリは、デフォルトでシステムの PATH に含まれています)、お勧めしません。

(php_mysql.dll も含めた) PHP 拡張モジュールを有効にするには、PHP ディレクティブ extension_dir に拡張モジュールの存在する場所を設定するべきです。 Windows へのマニュアルインストール方法も参照ください。PHP 5 での extension_dir の例は c:\php\ext です。

注意: Web サーバーの起動時に以下のようなエラーが発生する場合： "Unable to load dynamic library './php_mysql.dll'" これは php_mysql.dll や libmysqlclient.dll がシステムによって見つけられなかったことが原因です。

PHP 5.3.0+

MySQL Native Driver がデフォルトで有効になります。 php_mysql.dll は含まれますが、libmysqlclient.dll はもはや必須ではなく、使われません。

MySQL インストールの注意

警告

この拡張モジュールと recode 拡張モジュールを同時にロードした場合、 PHP のクラッシュと起動に関する問題が発生する可能性があります。より詳細な情報については、recode 拡張モジュールを参照ください。

注意: latin（デフォルト）以外の文字セットを必要とする場合、使用する文字セットのサポートを有効にしてコンパイルした（バンドル版でない） libmysqlclient をインストールする必要があります。