定義済み定数

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

PDO::PARAM_BOOL (int)

ブールデータ型を表します。

PDO::PARAM_NULL (int)

SQL NULL データ型を表します。

PDO::PARAM_INT (int)

SQL INTEGER データ型を表します。

PDO::PARAM_STR (int)

SQL CHAR, VARCHAR, または他の文字列データ型を表します。

PDO::PARAM_STR_NATL (int)

事前定義された文字セットを使用する文字列であることを示すフラグです。 PHP 7.2.0 以降で利用可能です。

PDO::PARAM_STR_CHAR (int)

通常の文字セットを使用する文字列であることを示すフラグです。 PHP 7.2.0 以降で利用可能です。

PDO::PARAM_LOB (int)

SQL ラージオブジェクト型を表します。

PDO::PARAM_STMT (int)

レコードセット型を表します。この型は現在どのドライバでもサポートされていません。

PDO::PARAM_INPUT_OUTPUT (int)

パラメータがストアドプロシージャ用の入力パラメータであることを指定します。 この値は、PDO::PARAM_* データ型とのビットORとして指定する必要があります。

PDO::FETCH_DEFAULT (int)

デフォルトの取得方法を使うことを指定します。 PHP 8.0.7 以降で利用可能です。

PDO::FETCH_LAZY (int)

取得する方法として、 結果セットが返すカラム名と同じ名前のプロパティを有するオブジェクトとして各行を返す方法を 指定します。 PDO::FETCH_LAZY は、アクセスされたものと同じ名前のプロパティ名を作成する PDORow オブジェクトを返します。 PDOStatement::fetchAll() の中では使えません。

PDO::FETCH_ASSOC (int)

結果セットの対応するカラム名にふられているものと同じキーを付けた 連想配列として各行を返す取得方法を指定します。 もし結果セットが複数のカラムを同名で含む場合、 PDO::FETCH_ASSOC はカラム名毎に 1 つの値のみ返します。

PDO::FETCH_NAMED (int)

結果セットの対応するカラム名にふられているものと同じキーを付けた 連想配列として各行を返す取得方法を指定します。 もし結果セットが複数のカラムを同名で含む場合、 PDO::FETCH_NAMED はカラム名毎に値の配列を返します。

PDO::FETCH_NUM (int)

結果セットの対応するカラム番号にふられているものと同じ添字を付けた 配列として各行を返す取得方法を指定します。番号は0から始まります。

PDO::FETCH_BOTH (int)

結果セットと同じカラム名と0から始まるカラム番号を付けた配列として各行を返す 方法を指定します。

PDO::FETCH_OBJ (int)

結果セットが返すカラム名と同じ名前のプロパティを有する オブジェクトとして各行を返す方法を指定します。

PDO::FETCH_BOUND (int)

結果セットのカラムの値を PDOStatement::bindParam() または PDOStatement::bindColumn() メソッドでバインドされた PHP変数に代入し、TRUEを返すという取得方法を指定します。

PDO::FETCH_COLUMN (int)

結果セットの次の行から指定された一つのカラムのみを返す取得方法を指定します。

PDO::FETCH_CLASS (int)

指定されたクラスの新規インスタンスを返す取得方法を指定します。

注意: 結果セットのカラムをクラスのプロパティにマップしつつ、 オブジェクトは初期化されます。 この処理はコンストラクタをコールするまえに行われるので、 プロパティのアクセス権に関係なく、たとえ readonly としてマークされていてもプロパティの値を集めることができます。 クラスにプロパティが存在しない場合は、マジックメソッド __set() が存在すればコールされます。 マジックメソッドが存在しない場合、public プロパティが動的に作成されます。 しかしながら、PDO::FETCH_PROPS_LATE が指定されている場合は、プロパティの値を集める 前 にコンストラクタがコールされます。

PDO::FETCH_INTO (int)

カラムをクラスのプロパティにマップしつつ、 指定されたクラスの既存のインスタンスを更新する取得方法を指定します。

PDO::FETCH_FUNC (int)

データをその場で扱う方法を完全にカスタマイズできるようにします (PDOStatement::fetchAll() の中でしか使えません)。

PDO::FETCH_GROUP (int)

値で返すグループ。 PDO::FETCH_COLUMN あるいは PDO::FETCH_KEY_PAIR と組み合わせます。

PDO::FETCH_UNIQUE (int)

一意な値だけを取得します。

PDO::FETCH_KEY_PAIR (int)

ふたつのカラムからなる結果を配列で取得します。最初のカラムの値がキー、二番目のカラムの内容が値となります。

PDO::FETCH_CLASSTYPE (int)

最初のカラムの値からクラス名を決定します。

PDO::FETCH_SERIALIZE (int)

PDO::FETCH_INTO と同様ですが、 シリアライズした文字列としてオブジェクトを提供します。 このフラグを設定した場合はコンストラクタが呼ばれません。 PHP 8.1.0 以降は、この定数は推奨されなくなりました。

PDO::FETCH_PROPS_LATE (int)

コンストラクタを呼んでからプロパティを設定します。

PDO::ATTR_AUTOCOMMIT (int)

この値が false の場合、PDO は接続がトランザクションを開始できるように オートコミットを無効にしようとします。

PDO::ATTR_PREFETCH (int)

独自アプリケーションにおけるメモリ使用量に対する速度のバランスを 調整するためのプリフェッチサイズを設定します。 全てのデータベースとドライバの組み合わせでプリフェッチサイズの設定を サポートしているわけではありません。

PDO::ATTR_TIMEOUT (int)

データベースとの通信に対するタイムアウト値を秒で設定します。

PDO::ATTR_ERRMODE (int)

PDO::ATTR_SERVER_VERSION (int)

PDO::ATTR_CLIENT_VERSION (int)

PDO::ATTR_SERVER_INFO (int)

PDO::ATTR_CONNECTION_STATUS (int)

PDO::ATTR_CASE (int)

PDO::CASE_* 定数で指定されたケースにカラム名を変更します。

PDO::ATTR_CURSOR_NAME (int)

PDO::ATTR_CURSOR (int)

PDO::ATTR_DRIVER_NAME (int)

ドライバ名を返します。

例1 PDO::ATTR_DRIVER_NAME の使用例

<?php
if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
echo "mysql 上で動作しています。何か mysql 固有のことをここで行います\n";
}
?>

PDO::ATTR_ORACLE_NULLS (int)

空文字を SQL の NULL 値に変換します。

PDO::ATTR_PERSISTENT (int)

新規接続を生成するよりもむしろ持続的接続を要求します。

PDO::ATTR_STATEMENT_CLASS (int)

Sets the class name of which statements are returned as.

PDO::ATTR_FETCH_CATALOG_NAMES (int)

結果セット中の各カラム名にカタログ名を追加します。 カタログ名とカラム名は、小数点 (.) で区切られます。

PDO::ATTR_FETCH_TABLE_NAMES (int)

結果セット中の各カラム名にテーブル名を追加します。 テーブル名とカラム名は、小数点 (.) で区切られます。

PDO::ATTR_STRINGIFY_FETCHES (int)

全てのフェッチする値 (null を除く) を強制的に文字列として扱います。 PDO::ATTR_ORACLE_NULLS を PDO::NULL_TO_STRING に設定しない限り、 null は変更されません。

PDO::ATTR_MAX_COLUMN_LEN (int)

カラム名の最大の長さを設定します。

PDO::ATTR_DEFAULT_FETCH_MODE (int)

PDO::ATTR_EMULATE_PREPARES (int)

PDO::ATTR_DEFAULT_STR_PARAM (int)

デフォルトの文字列のパラメータタイプを設定します。 PDO::PARAM_STR_NATL と PDO::PARAM_STR_CHAR のうち、いずれかひとつを選べます。 PHP 7.2.0 以降で利用可能です。

PDO::ERRMODE_SILENT (int)

エラー時にエラーもしくは例外を発生しません。 開発者の方は明示的にエラーをチェックするようにしてください。 これはデフォルトのモードです。

PDO::ERRMODE_WARNING (int)

エラーが発生した場合、PHP の E_WARNING メッセージを発行します。

PDO::ERRMODE_EXCEPTION (int)

エラーが発生した場合、PDOException をスローします。

PDO::CASE_NATURAL (int)

カラム名をデータベースドライバにより返されたままにします。

PDO::CASE_LOWER (int)

カラム名を小文字にします。

PDO::CASE_UPPER (int)

カラム名を大文字にします。

PDO::NULL_NATURAL (int)

PDO::NULL_EMPTY_STRING (int)

PDO::NULL_TO_STRING (int)

PDO::FETCH_ORI_NEXT (int)

結果セットの次の行を取得します。スクローラブルなカーソルでのみ有効です。

PDO::FETCH_ORI_PRIOR (int)

結果セットの前の行を取得します。スクローラブルなカーソルでのみ有効です。

PDO::FETCH_ORI_FIRST (int)

結果セットの先頭の行を取得します。スクローラブルなカーソルでのみ有効です。

PDO::FETCH_ORI_LAST (int)

結果セットの最後の行を取得します。スクローラブルなカーソルでのみ有効です。

PDO::FETCH_ORI_ABS (int)

結果セットから行番号で指定した行を取得します。スクローラブルなカーソルでのみ有効です。

PDO::FETCH_ORI_REL (int)

結果セットのカーソルの現在の位置を基準とする相対位置により指定された行を 取得します。スクローラブルなカーソルでのみ有効です。

PDO::CURSOR_FWDONLY (int)

前進のみ可能なカーソルを有する PDOStatement オブジェクトを生成します。 これにより、アプリケーションの性能は改善しますが、 PDOStatementオブジェクトは前方にある結果セットから一度に一行を 取得するという制約を受けます。

PDO::CURSOR_SCROLL (int)

スクローラブルカーソルを有する PDOStatement オブジェクトを作成します。 結果セットから取得した行を制御するための PDO::FETCH_ORI_* 定数を指定して ください。

PDO::ERR_CANT_MAP (int)

PDO::ERR_SYNTAX (int)

PDO::ERR_CONSTRAINT (int)

PDO::ERR_NOT_FOUND (int)

PDO::ERR_ALREADY_EXISTS (int)

PDO::ERR_NOT_IMPLEMENTED (int)

PDO::ERR_MISMATCH (int)

PDO::ERR_TRUNCATED (int)

PDO::ERR_DISCONNECTED (int)

PDO::ERR_NO_PERM (int)

PDO::ERR_NONE (string)

SQLSTATE '00000' は SQL ステートメントがエラーや警告がなく発行に成功したことを意味します。 この定数はエラーが発生したかどうかを判別するために PDO::errorCode() もしくは PDOStatement::errorCode() をチェックする際に 便利です。この場合、通常はエラー状態を発生したメソッドからの戻りコードを 検査することによって検知します。

PDO::PARAM_EVT_ALLOC (int)

割り当てられたときに発生するイベント。

PDO::PARAM_EVT_FREE (int)

割り当てが解除されたときに発生するイベント。

PDO::PARAM_EVT_EXEC_PRE (int)

プリペアドステートメントの実行前に発生するイベント。

PDO::PARAM_EVT_EXEC_POST (int)

プリペアドステートメントの実行後に発生するイベント。

PDO::PARAM_EVT_FETCH_PRE (int)

結果セットから結果を取得する前に発生するイベント。

PDO::PARAM_EVT_FETCH_POST (int)

結果セットから結果を取得した後に発生するイベント。

PDO::PARAM_EVT_NORMALIZE (int)

バインドパラメータの登録時に発生するイベント。 これにより、ドライバがパラメータ名を正規化できるようになります。

PDO::SQLITE_DETERMINISTIC (int)

PDO::sqliteCreateFunction() で作られる関数が決定論的であることを指定します。 つまり、同じ入力が与えられると、単一のSQLステートメントの範疇では同じ結果が常に返されます。 (PHP 7.1.4 以降で使用可能です)