導入

MaxDB PHP 拡張モジュールにより、MaxDB 7.5.0 以降にアクセスできるようになります。 MaxDB データベースサーバについての詳細な情報は http://www.mysql.com/products/maxdb/ で得られます。

MaxDB PHP 拡張モジュールは、MySQL の mysqli 拡張モジュールと互換性があります。 これらの間にはほんの少しの違いしかなく、その違いは MaxDB と MySQL の違いに基づくものです。

mysqli との主な相違点は、以下のようになります。

maxdb_character_set_name() - ascii あるいは unicode しか返しません。

maxdb_get_client_info() - 異なるバージョン文字列を返します。

maxdb_get_client_version() - 異なるバージョン文字列を返します。

maxdb_get_host_info() - localhost あるいはホスト名を返します。

maxdb_get_server_info() - 異なるバージョン文字列を返します。

maxdb_get_server_version() - 異なるバージョン文字列を返します。

maxdb_kill() - 単にセッションを切断するだけです。

maxdb_multi_query() - 複数の SQL 文を扱うことはできません。

maxdb_next_result() - 常に false を返します。

maxdb_options() - サポートするオプションが異なります。

maxdb_report() - サポートする繰り返しモードが異なります。

maxdb_stat() - 異なるシステム状態文字列を返します。

maxdb_stmt_store_result() - MaxDB では不要です。

maxdb_store_result() - MaxDB では不要です。

MaxDB についてのドキュメントは http://dev.mysql.com/doc/maxdb/ にあります。

要件

これらの関数を使用するには、MaxDB のサポートを有効にして PHP をコンパイルする必要があります。さらに、MaxDB サーバにアクセスするために MaxDB SQLDBC ランタイムライブラリが必要です。

MaxDB SQLDBC についてのドキュメントは http://dev.mysql.com/doc/maxdb/ にあります。

MaxDB SQLDBC パッケージは http://dev.mysql.com/downloads/maxdb/clients.html からダウンロードします。

インストール手順

設定オプション --with-maxdb[=DIR] を使用すると、PHP から MaxDB データベースへのアクセス機能が有効となります。 [DIR] には、MaxDB SQLDBC パッケージのインストールされているディレクトリを指定します。

Windows ユーザは、php.ini の中で php_maxdb.dll を有効にする必要があります。

実行時設定

php.ini の設定により動作が変化します。

PHP_INI_* 定数の詳細および定義については 付録G を参照してください。

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

定義済みクラス

定義済み定数

以下の定数が定義されています。 この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、 実行時に動的にロードされている場合のみ使用可能です。

以下の定数が、maxdb_options() で使用するために定義されています。これらの定数についての詳細な情報は http://dev.mysql.com/doc/maxdb/ を参照ください。

maxdb_fetch_array() 関数は、 結果の配列の型を指定するために定数を使用します。 以下の定数が定義されています。

例

MaxDB PHP マニュアルの全ての例は、MaxDB から得られるデモデータベース HOTELDB を使用しています。このデータベースについての情報は http://dev.mysql.com/doc/maxdb/en/98/11b83fa6b33c17e10000000a114084/frameset.htm で得られます。

MaxDB PHP マニュアルのデータベースを使用するには、チュートリアルのデータを データベースに読み込む必要があります。その後、php.ini の中の maxdb.default_db に、チュートリアルデータを含むデータベースを設定します。

この単純な例では、MaxDB データベースへの接続・クエリの実行・ 結果の行の表示・接続の切断の方法を示します。

例 1. MaxDB 拡張モジュールの概要 <?php $link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");     /* 接続を調べます */ if (maxdb_connect_errno()) {    printf("接続に失敗しました: %s\n", maxdb_connect_error());    exit(); } /* SQL クエリを実行します */ $query = "SELECT * FROM hotel.city"; $result = maxdb_query($link, $query) or die("クエリに失敗しました: " . maxdb_error()); /* 結果を HTML で表示します */ echo "<table>\n"; while ($line = maxdb_fetch_array($result, MAXDB_ASSOC)) {     echo "  <tr>\n";     foreach ($line as $col_value) {         echo "    <td>$col_value</td>\n";     }     echo "  </tr>\n"; } echo "</table>\n"; /* 結果セットを開放します */ maxdb_free_result($result); /* 接続を閉じます */ maxdb_close($link); ?>

以下の例では、SELECT INTO 文に変数をバインドする方法を示します。

例 2. SELECT INTO 文の使用例 <?php $link = maxdb_connect("localhost", "MONA", "RED", "DEMODB"); /* 接続を調べます */ if (!$link) {    printf("接続に失敗しました: %s\n", maxdb_connect_error());    exit(); }     /* SQL クエリを実行します */ $stmt = maxdb_prepare ($link, "SELECT percentage INTO ? FROM hotel.countrylanguage where language = ?"); if (!$stmt) {   printf ("準備に失敗しました: %s\n", maxdb_error($link)); } $name = "Mbundu"; maxdb_stmt_bind_param($stmt, 'ds', $percentage, $name); maxdb_stmt_execute($stmt); printf ("%f\n", $percentage); maxdb_stmt_close ($stmt); ?>

以下の例では、MaxDB のプロシージャを使用する方法を示します。

例 3. データベースプロシージャの使用 <?php $link = maxdb_connect("localhost", "MONA", "RED", "DEMODB"); /* 接続を調べます */ if (!$link) {    printf("接続に失敗しました: %s\n", maxdb_connect_error());    exit(); } maxdb_report (MAXDB_REPORT_OFF); maxdb_query($link,"DROP DBPROC test_proc"); maxdb_report (MAXDB_REPORT_ERROR); $query = "create dbproc test_proc (INOUT e_text char(72)) AS select * from SYSDBA.DUAL; fetch into :e_text;"; maxdb_query($link, $query); /* SQL クエリを実行します */ $stmt = maxdb_prepare ($link, "CALL test_proc (?)"); if (!$stmt) {   printf ("準備に失敗しました: %s\n", maxdb_error($link)); } maxdb_stmt_bind_param($stmt, 's', $result); maxdb_stmt_execute($stmt); printf ("%s\n", $result); maxdb_stmt_close ($stmt); ?>