PDO::getAttribute

(no version information, might be only in CVS)

PDO::getAttribute --  データベース接続の属性を取得する

説明

mixed PDO::getAttribute ( long attribute )

警告

この関数は、 実験的なステータスにあります。これは、この関数の 動作、関数名、ここで書かれていること全てがPHPの将来のバージョンで予告 なく変更される可能性があることを意味します。注意を喚起するとともに自分 のリスクでこの関数を使用してください。

この関数はデータベース接続の属性値を返します。PDOStatement 属性を取得する場合、PDOStatement::getAttribute() を参照ください。

いくつかのデータベースは、 データベース接続の属性の全てのをサポートしていないかも知れないことに 注意してください。

パラメータ

属性

PDO_ATTR_* 定数の 1 つを指定します。 データベース接続に適用される定数は以下の通りです。

PDO_ATTR_AUTOCOMMIT
PDO_ATTR_CASE
PDO_ATTR_CLIENT_VERSION
PDO_ATTR_CONNECTION_STATUS
PDO_ATTR_ERRMODE
PDO_ATTR_ORACLE_NULLS
PDO_ATTR_PERSISTENT
PDO_ATTR_PREFETCH
PDO_ATTR_SERVER_INFO
PDO_ATTR_SERVER_VERSION
PDO_ATTR_TIMEOUT

戻り値

コールに成功した場合は要求された PDO 属性の値を返します。 コールに失敗した場合は null を返します。

例 1. データベース接続の属性を取得する

<?php
$conn
= new PDO('odbc:sample', 'db2inst1', 'ibmdb2');

print
"\nPDO_ATTR_AUTOCOMMIT: ";
print
$conn->getAttribute(PDO_ATTR_AUTOCOMMIT);

print
"\nPDO_ATTR_ERRMODE: ";
print
$conn->getAttribute(PDO_ATTR_ERRMODE);

print
"\nPDO_ATTR_CASE: ";
print
$conn->getAttribute(PDO_ATTR_CASE);

print
"\nPDO_ATTR_CLIENT_VERSION: ";
print
$conn->getAttribute(PDO_ATTR_CLIENT_VERSION);

print
"\nPDO_ATTR_CONNECTION_STATUS: ";
print
$conn->getAttribute(PDO_ATTR_CONNECTION_STATUS);

print
"\nPDO_ATTR_ORACLE_NULLS: ";
print
$conn->getAttribute(PDO_ATTR_ORACLE_NULLS);

print
"\nPDO_ATTR_PERSISTENT: ";
print
$conn->getAttribute(PDO_ATTR_PERSISTENT);

print
"\nPDO_ATTR_PREFETCH: ";
print
$conn->getAttribute(PDO_ATTR_PREFETCH);

print
"\nPDO_ATTR_SERVER_INFO: ";
print
$conn->getAttribute(PDO_ATTR_SERVER_INFO);

print
"\nPDO_ATTR_SERVER_VERSION: ";
print
$conn->getAttribute(PDO_ATTR_SERVER_VERSION);

print
"\nPDO_ATTR_TIMEOUT: ";
print
$conn->getAttribute(PDO_ATTR_TIMEOUT);
?>

以下も参照ください

PDO::setAttribute()
PDOStatement::getAttribute()
PDOStatement::setAttribute()