Because no examples are provided, and to alleviate any confusion as a result, the setAttribute() method is invoked like so:
setAttribute(ATTRIBUTE, OPTION);
So, if I wanted to ensure that the column names returned from a query were returned in the case the database driver returned them (rather than having them returned in all upper case [as is the default on some of the PDO extensions]), I would do the following:
<?php
// Create a new database connection.
$dbConnection = new PDO($dsn, $user, $pass);
// Set the case in which to return column_names.
$dbConnection->setAttribute(PDO::ATTR_CASE, PDO::CASE_NATURAL);
?>
Hope this helps some of you who learn by example (as is the case with me).
.Colin
PDO::setAttribute
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDO::setAttribute — 属性を設定する
説明
public PDO::setAttribute(int
$attribute, array|int $value): boolデータベースハンドルの属性を設定します。 利用可能な通常の属性は以下の一覧の通りです。いくつかのドライバでは、 ドライバ固有の属性を使用することが可能です。
PDO::ATTR_CASE: 強制的にカラム名を指定したケースにするPDO::CASE_LOWER: 強制的にカラム名を小文字にするPDO::CASE_NATURAL: データベースドライバによって返されるカラム名をそのままにするPDO::CASE_UPPER: 強制的にカラム名を大文字にする
PDO::ATTR_ERRMODE: エラーレポートPDO::ERRMODE_SILENT: エラーコードのみ設定するPDO::ERRMODE_WARNING:E_WARNINGを発生させるPDO::ERRMODE_EXCEPTION: 例外 を投げる
PDO::ATTR_ORACLE_NULLS(Oracle だけでなく、全てのドライバで利用可能): NULL と空文字列の変換PDO::NULL_NATURAL: 変換しないPDO::NULL_EMPTY_STRING: 空文字はnullに変換されるPDO::NULL_TO_STRING: NULL は空文字に変換される
PDO::ATTR_STRINGIFY_FETCHES: フェッチする際、数値を文字列に変換する。bool を必要とするPDO::ATTR_STATEMENT_CLASS: PDOStatement に由来するユーザーが提供するステートメントクラスを設定する。 永続的な PDO インスタンスは使用できない。array(string classname, array(mixed constructor_args))を必要とする。PDO::ATTR_TIMEOUT: タイムアウト秒数を指定する。すべてのドライバがこのオプションに対応しているわけではなく、 またドライバによってこのオプションの扱いは異なる。たとえば sqlite は書き込み可能なロックを確保するのをこの秒数まで待ち続けるが、 他のドライバではこの秒数を接続時のタイムアウトや読み込みのタイムアウトとして扱うこともある。 int を渡す。PDO::ATTR_AUTOCOMMIT(OCI, Firebird そして MySQL で利用可能): それぞれの単一文で自動コミットするかどうか。PDO::ATTR_EMULATE_PREPARESプリペアドステートメントのエミュレーションを有効または無効にする。 ドライバによってはネイティブのプリペアドステートメントをサポートしていなかったり 完全には対応していなかったりするものがある。この設定を使うと、常に プリペアドステートメントをエミュレートする (trueおよび プリペアのエミュレートがドライバでサポートされている場合) か、 ネイティブのプリペアドステートメントを使おうとする (falseの場合) かを設定できる。現在のクエリを正しく準備できなかった場合は、常にエミュレート方式を使う。 bool で指定する。PDO::MYSQL_ATTR_USE_BUFFERED_QUERY(MySQL で利用可能): バッファされたクエリを使用する。PDO::ATTR_DEFAULT_FETCH_MODE: デフォルトのフェッチモードを設定する。このモードについての説明は PDOStatement::fetch() のドキュメントを参照。
返り値
成功した場合に true を、失敗した場合に false を返します。
add a note
User Contributed Notes 11 notes
colinganderson [at] gmail [dot] com ¶
16 years ago
yeboahnanaosei at gmail dot com ¶
6 years ago
This is an update to a note I wrote earlier concerning how to set multiple attributes when you create you PDO connection string.
You can put all the attributes you want in an associative array and pass that array as the fourth parameter in your connection string. So it goes like this:
<?php
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_CASE => PDO::CASE_NATURAL,
PDO::ATTR_ORACLE_NULLS => PDO::NULL_EMPTY_STRING
];
// Now you create your connection string
try {
// Then pass the options as the last parameter in the connection string
$connection = new PDO("mysql:host=$host; dbname=$dbname", $user, $password, $options);
// That's how you can set multiple attributes
} catch(PDOException $e) {
die("Database connection failed: " . $e->getMessage());
}
?>
yeboahnanaosei at gmail dot com ¶
6 years ago
Well, I have not seen it mentioned anywhere and thought its worth mentioning. It might help someone. If you are wondering whether you can set multiple attributes then the answer is yes.
You can do it like this:
try {
$connection = new PDO("mysql:host=$host; dbname=$dbname", $user, $password);
// You can begin setting all the attributes you want.
$connection->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$connection->setAttribute(PDO::ATTR_CASE, PDO::CASE_NATURAL);
$connection->setAttribute(PDO::ATTR_ORACLE_NULLS, PDO::NULL_EMPTY_STRING);
// That's how you can set multiple attributes
}
catch(PDOException $e)
{
die("Database connection failed: " . $e->getMessage());
}
I hope this helps somebody. :)
gregory dot szorc at gmail dot com ¶
17 years ago
It is worth noting that not all attributes may be settable via setAttribute(). For example, PDO::MYSQL_ATTR_MAX_BUFFER_SIZE is only settable in PDO::__construct(). You must pass PDO::MYSQL_ATTR_MAX_BUFFER_SIZE as part of the optional 4th parameter to the constructor. This is detailed in http://bugs.php.net/bug.php?id=38015
antoyo ¶
13 years ago
There is also a way to specifie the default fetch mode :
<?php
$connection = new PDO($connection_string);
$connection->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_OBJ);
?>
steve at websmithery dot co dot uk ¶
6 years ago
For PDO::ATTR_EMULATE_PREPARES, the manual states a boolean value is required. However, when getAttribute() is used to check this value, an integer (1 or 0) is returned rather than true or false.
This means that if you are checking a PDO object is configured as required then
<?php
// Check emulate prepares is off
if ($pdo->getAttribute(\PDO::ATTR_EMULATE_PREPARES) !== false) {
/* do something */
}
?>
will always 'do something', regardless.
Either
<?php
// Check emulate prepares is off
if ($pdo->getAttribute(\PDO::ATTR_EMULATE_PREPARES) != false) {
/* do something */
}
?>
or
<?php
// Check emulate prepares is off
if ($pdo->getAttribute(\PDO::ATTR_EMULATE_PREPARES) !== 0) {
/* do something */
}
?>
is needed instead.
Also worth noting that setAttribute() does, in fact, accept an integer value if you want to be consistent.
guillaume at thug dot com ¶
6 years ago
function pdo_connect(){
try {
$pdo = new PDO('mysql:host=localhost;dbname='.DB_NAME, DB_USER, DB_PASS);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$pdo->setAttribute( PDO::ATTR_EMULATE_PREPARES, false );
$pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
} catch (PDOException $e) {
die("Error!: " . $e->getMessage() . "<br/>");
}
return $pdo;
}
justinasu at gmail dot com ¶
8 years ago
in v5.5 PDO::MYSQL_ATTR_USE_BUFFERED_QUERY can only be set in PDO constructor, not by passing it into setAttribute.
If you set it with setAttribute it will not work. getAttribute(PDO::MYSQL_ATTR_USE_BUFFERED_QUERY) will return 0.
vstoykov at proab dot info ¶
6 years ago
I am using PHP 5.6 and MySQL 5.0 on GoDaddy.
When executing a query like this:
<?php
$stmt = $this->PDO->query("SHOW CREATE TABLE table");
?>
I get:
Uncaught exception 'PDOException' with message
'SQLSTATE[HY000]: General error: 2030 This command is not supported in the prepared statement protocol yet'
After I added:
<?php
$this->PDO->setAttribute(PDO::ATTR_EMULATE_PREPARES, true);
?>
the query was executed successfully.
m dot leuffen at gmx dot de ¶
17 years ago
Hi,
if you are wondering about a size-bound (1 MB) on blob and text fields after upgrading to PHP5.1.4. You might try to increase this limit by using the setAttribute() method.
This will fail. Instead use the options array when instantiating the pdo:
$pdo = new PDO ("connection_settings", "user", "pass", array
(PDO::MYSQL_ATTR_MAX_BUFFER_SIZE=>1024*1024*50));
This should fix the problem and increase the limit to 50 MB.
Bye,
Matthias
