導入

以下の関数は、MySQLデータベースサーバーへのアクセスを可能にします。 MySQLに関するより詳細な情報は、 http://www.mysql.com/にあります。

MySQL のドキュメントは、http://dev.mysql.com/doc/にあります。

要件

以下の関数を利用可能とするには、MySQLサポートを指定してPHPをコン パイルする必要があります。

インストール手順

configureオプション--with-mysql[=DIR]を 使用することにより、PHPからMySQLデータベースへのアクセス が可能となります。

PHP 4では、オプション --with-mysqlはデフォルトで有効と なっています。この動作を無効にするには、configureオプション --without-mysqlを使用する必要が あるでしょう。また、PHP 4でMySQLインストールDIRへのパスを指定しなかった 場合、PHPはバンドルされたMySQLクライアントライブラリを 使用します。 Windowsでは、DLLは附属せず、PHP 4に組込まれています。 (auth-mysqlのような)MySQLを使用する他のアプリケーショを実行するユーザは、 バンドルされたライブラリを使うべきではなく、むしろ、 --with-mysql=/path/to/mysql のようにMySQLのインストールディレクトリを指定するべきです。 これにより、PHPがMySQLによりインストールされた クライアントライブラリを使用するようになり、衝突が回避されます。

PHP 5では、MySQLはもはやデフォルトでは有効とならず、PHPにMySQLライブラリも 付属しません。 この理由の詳細については、 FAQ を参照して下さい。

このMySQL拡張モジュールは、4.1.0以降のMySQLのバージョンでは動作しません。 これ以降については、MySQLiを使用して 下さい。

実行用の設定

これらの関数の動作は、php.iniの設定により変化します。

以下に設定ディレクティブの簡単な説明を示します。

リソース型

MySQLモジュールでは、2種類のリソース型が使用されています。 最初のリソースはデータベース接続のリンクIDで、2番目のリソースは、 クエリ結果を保持するリソースです。

定義済みの定数

これらの定数は、この拡張モジュールで定義されており、 この拡張モジュールがPHP内部にコンパイルされているか実行時に動的にロー ドされるかのどちらかの場合のみ使用可能です。

Since PHP 4.3.0 it is possible to specify additional client flags for the mysql_connect() and mysql_pconnect() functions. The following constants are defined:

The function mysql_fetch_array() uses a constant for the different types of result arrays. The following constants are defined:

例

以下は、MySQLデータベースに接続し、クエリを実行し、結果レコードを 出力、接続を断する例です。

例 1. MySQL拡張モジュールに関する例 <?php // データベースに接続し、選択する $link = mysql_connect("mysql_host", "mysql_login", "mysql_password")     or die("Could not connect"); print "Connected successfully"; mysql_select_db("my_database")     or die("Could not select database"); // SQLクエリを実行する $query = "SELECT * FROM my_table"; $result = mysql_query($query)     or die("Query failed"); // HTMLに結果を出力する print "<table>\n"; while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) {     print "\t<tr>\n";     foreach ($line as $col_value) {         print "\t\t<td>$col_value</td>\n";     }     print "\t</tr>\n"; } print "</table>\n"; // 接続を閉じる mysql_close($link); ?>