MaxDB PHP 拡張モジュール

PHP関数リファレンス

MaxDB PHP 拡張モジュール

以下の定数が定義されています。 この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、 実行時に動的にロードされている場合のみ使用可能です。
以下の定数が、maxdb_options() で使用するために定義されています。これらの定数についての詳細な情報は » http://dev.mysql.com/doc/maxdb/ を参照ください。 表 150. MaxDB PHP クライアント定数

定数	説明
MAXDB_COMPNAME	SQLDBC ランタイム環境を初期化するために使用するコンポーネント名。
MAXDB_APPLICATION	データベースに接続しているアプリケーション。
MAXDB_APPVERSION	アプリケーションのバージョン。
MAXDB_SQLMODE	SQL モード。
MAXDB_UNICODE	unicode (UCS2) クライアントによる接続の場合に TRUE、そうでない場合に FALSE。
MAXDB_TIMEOUT	データベースへの接続がシステムによって閉じられるまでの 最大無活動時間。
MAXDB_ISOLATIONLEVEL	共有ロックおよび排他ロックを暗黙的に要求/開放するかどうか、 またどのように行うかを指定します。
MAXDB_PACKETCOUNT	接続に使用するリクエストパケットの数。
MAXDB_STATEMENTCACHESIZE	接続内での再利用のためにキャッシュされるプリペアドステートメントの数。
MAXDB_CURSORPREFIX	自動的に命名される結果テーブルに使用するプレフィックス。

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

定数	説明
MAXDB_ASSOC	フィールド名をインデックスとする配列で、カラムを返します。
MAXDB_ASSOC_UPPER	大文字に変換したフィールド名をインデックスとする配列で、 カラムを返します。
MAXDB_ASSOC_LOWER	小文字に変換したフィールド名をインデックスとする配列で、 カラムを返します。
MAXDB_BOTH	数値インデックスおよびフィールド名インデックスの両方を含む配列で、 カラムを返します。
MAXDB_NUM	フィールドの数値インデックスを持つ配列で、カラムを返します。 インデックスは 0 から始まり、これが結果の最初のフィールドを表します。

例

MaxDB PHP マニュアルの全ての例は、MaxDB から得られるデモデータベース HOTELDB を使用しています。このデータベースについての情報は » http://dev.mysql.com/doc/maxdb/en/98/11b83fa6b33c17e10000000a114084/frameset.htm で得られます。
MaxDB PHP マニュアルのデータベースを使用するには、チュートリアルのデータを データベースに読み込む必要があります。その後、php.ini の中の maxdb.default_db に、チュートリアルデータを含むデータベースを設定します。
この単純な例では、MaxDB データベースへの接続・クエリの実行・ 結果の行の表示・接続の切断の方法を示します。 例 1065. 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 文に変数をバインドする方法を示します。 例 1066. 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 のプロシージャを使用する方法を示します。 例 1067. データベースプロシージャの使用
<?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);
?>

目次

maxdb_affected_rows — 直前の MaxDB の操作で変更された行数を取得する

maxdb_autocommit — データベースの変更内容の自動コミット機能を有効あるいは無効にする

maxdb_bind_param — maxdb_stmt_bind_param() のエイリアス

maxdb_bind_result — maxdb_stmt_bind_result() のエイリアス

maxdb_change_user — 指定したデータベース接続のユーザを変更する

maxdb_character_set_name — データベース接続のデフォルトの文字セットを返す

maxdb_client_encoding — maxdb_character_set_name() のエイリアス

maxdb_close_long_data — maxdb_stmt_close_long_data() のエイリアス

maxdb_close — 事前にオープンされたデータベース接続を閉じる

maxdb_commit — 現在のトランザクションをコミットする

maxdb_connect_errno — 直近の接続コールのエラーコードを返す

maxdb_connect_error — 直近の接続エラーについての説明を文字列で返す

maxdb_connect — MaxDB サーバへの新しい接続をオープンする

maxdb_data_seek — 結果ポインタを、結果の任意の行に移動する

maxdb_debug — デバッグ操作を行う

maxdb_disable_reads_from_master — マスタからの読み込みを無効にする

maxdb_disable_rpl_parse — RPL のパースを無効にする

maxdb_dump_debug_info — デバッグ情報をログに出力する

maxdb_embedded_connect — 組み込み MaxDB サーバへの接続をオープンする

maxdb_enable_reads_from_master — マスタからの読み込みを有効にする

maxdb_enable_rpl_parse — RPL のパースを有効にする

maxdb_errno — 直近の関数コールのエラーコードを返す

maxdb_error — 直近のエラーについて説明する文字列を返す

maxdb_escape_string — maxdb_real_escape_string() のエイリアス

maxdb_execute — maxdb_stmt_execute() のエイリアス

maxdb_fetch_array — 結果の行を連想配列、数値添字配列あるいはその両方で取得する

maxdb_fetch_assoc — 結果の行を連想配列として取得する

maxdb_fetch_field_direct — 単一のフィールドのメタデータを取得する

maxdb_fetch_field — 結果セットの次のフィールドを返す

maxdb_fetch_fields — 結果セット内のフィールドを表すリソースの配列を返す

maxdb_fetch_lengths — 結果セットの現在の行のカラムの長さを返す

maxdb_fetch_object — 結果セットの現在の行をオブジェクトとして返す

maxdb_fetch_row — 結果の行を数値添字の配列として取得する

maxdb_fetch — maxdb_stmt_fetch() のエイリアス

maxdb_field_count — 直近のクエリのカラム数を返す

maxdb_field_seek — 結果ポインタを、指定したフィールドオフセットに移動する

maxdb_field_tell — 結果ポインタの現在のフィールドオフセットを取得する

maxdb_free_result — 結果に関連付けられたメモリを開放する

maxdb_get_client_info — MaxDB クライアントのバージョンを文字列で返す

maxdb_get_client_version — MaxDB クライアントの情報を取得する

maxdb_get_host_info — 使用している接続の型を表す文字列を返す

maxdb_get_metadata — maxdb_stmt_result_metadata() のエイリアス

maxdb_get_proto_info — 使用している MaxDB プロトコルのバージョンを返す

maxdb_get_server_info — MaxDB サーバのバージョンを返す

maxdb_get_server_version — MaxDB サーバのバージョンを整数値で返す

maxdb_info — 直近に実行したクエリについての情報を取得する

maxdb_init — MaxDB を初期化し、maxdb_real_connect で使用するリソースを返す

maxdb_insert_id — 直近のクエリで使用した、自動生成 ID を返す

maxdb_kill — MaxDB サーバから切断する

maxdb_master_query — マスタ/スレーブ構成において、クエリをマスタ側で実行することを強制する

maxdb_more_results — 複数クエリの結果の中に結果セットがまだあるかどうかを調べる

maxdb_multi_query — データベース上でクエリを実行する

maxdb_next_result — multi_query の、次の結果を準備する

maxdb_num_fields — 結果のフィールド数を取得する

maxdb_num_rows — 結果の行数を取得する

maxdb_options — オプションを設定する

maxdb_param_count — maxdb_stmt_param_count() のエイリアス

maxdb_ping — サーバとの接続を確認し、接続が確立されていない場合は再接続を試みる

maxdb_prepare — 後で実行するための SQL 文を準備する

maxdb_query — データベース上でクエリを実行する

maxdb_real_connect — MaxDB サーバへの接続をオープンする

maxdb_real_escape_string — 現在の接続の文字セットを考慮したうえで、 SQL 文で使用される文字列中の特殊文字をエスケープする

maxdb_real_query — SQL クエリを実行する

maxdb_report — 内部のレポート関数を有効あるいは無効にする

maxdb_rollback — 現在のトランザクションをロールバックする

maxdb_rpl_parse_enabled — RPL のパースが有効かどうかを調べる

maxdb_rpl_probe — RPL を調べる

maxdb_rpl_query_type — RPL クエリ型を返す

maxdb_select_db — データベースクエリ用のデフォルトデータベースを選択する

maxdb_send_long_data — maxdb_stmt_send_long_data() のエイリアス

maxdb_send_query — クエリを送信する

maxdb_server_end — 埋め込みサーバをシャットダウンする

maxdb_server_init — 埋め込みサーバを初期化する

maxdb_set_opt — maxdb_options() のエイリアス

maxdb_sqlstate — 直近の MaxDB 操作の SQLSTATE エラーを返します

maxdb_ssl_set — SSL を使用したセキュアな接続を確立するために使用する

maxdb_stat — 現在のシステム状態を取得する

maxdb_stmt_affected_rows — 直近のステートメントによって変更、削除 あるいは挿入された行の数を返す

maxdb_stmt_bind_param — プリペアドステートメントに、変数をパラメータとしてバインドする

maxdb_stmt_bind_result — 結果を保存するために、変数をプリペアドステートメントにバインドする

maxdb_stmt_close_long_data — maxdb_stmt_send_long_data() のシーケンスを終了する

maxdb_stmt_close — プリペアドステートメントを閉じる

maxdb_stmt_data_seek — ステートメントの結果セットの、任意の行に移動する

maxdb_stmt_errno — 直近のステートメントコール時のエラーコードを返す

maxdb_stmt_error — 直近のステートメントコール時のエラー文字列を返す

maxdb_stmt_execute — プリペアドクエリを実行する

maxdb_stmt_fetch — プリペアドステートメントの結果を取得し、バインド変数に格納する

maxdb_stmt_free_result — 指定したステートメントハンドルの結果を保存しているメモリを開放する

maxdb_stmt_init — ステートメントを初期化し、maxdb_stmt_prepare で使用するリソースを返す

maxdb_stmt_num_rows — ステートメントの結果セットの行数を返す

maxdb_stmt_param_count — 指定したステートメントのパラメータ数を返す

maxdb_stmt_prepare — 後で実行するための SQL 文を準備する

maxdb_stmt_reset — プリペアドステートメントをリセットする

maxdb_stmt_result_metadata — プリペアドステートメントから、結果セットのメタデータを返す

maxdb_stmt_send_long_data — データを複数ブロックで送信する

maxdb_stmt_sqlstate — 事前のステートメントの捜査からの SQLSTATE エラーを返す

maxdb_stmt_store_result — プリペアドステートメントから結果を転送する

maxdb_store_result — 直近のクエリから結果セットを転送する

maxdb_thread_id — 現在の接続のスレッド ID を返す

maxdb_thread_safe — スレッドセーフであるかどうかを返す

maxdb_use_result — 結果セットの取得を開始する

maxdb_warning_count — 指定したリンクの直近のクエリで発生した警告の数を返す