PDO::setAttribute

Beschreibung

Legt ein Attribut für eine Datenbankverbindung fest. Einige der allgemein verfügbaren Attribute sind unten aufgeführt; manche Treiber verwenden möglicherweise zusätzliche treiberspezifische Attribute. Es ist zu beachten, dass die treiberspezifischen Attribute nicht mit anderen Treibern verwendet werden dürfen.

PDO::ATTR_CASE

Erzwingt, dass Spaltennamen eine bestimmte Groß-/Kleinschreibung aufweisen; kann einen der folgenden Werte annehmen:

PDO::CASE_LOWER

Erzwingt, dass Spaltennamen klein geschrieben werden.

PDO::CASE_NATURAL

Belässt die Spaltennamen so, wie sie vom Datenbanktreiber zurückgegeben werden.

PDO::CASE_UPPER

Erzwingt, dass Spaltennamen groß geschrieben werden.

PDO::ATTR_ERRMODE

Modus der PDO-Fehlermeldung; kann einen der folgenden Werte annehmen:

PDO::ERRMODE_SILENT

Es werden nur Fehlercodes gesetzt.

PDO::ERRMODE_WARNING

Gibt einen Fehler der Stufe E_WARNING aus.

PDO::ERRMODE_EXCEPTION

Löst PDOExceptions aus.

PDO::ATTR_ORACLE_NULLS

Hinweis: Dieses Attribut ist für alle Treiber verfügbar, nicht nur für Oracle.

Legt fest, ob und wie null und leere Strings umgewandelt werden sollen; kann einen der folgenden Werte annehmen:

PDO::NULL_NATURAL

Es findet keine Umwandlung statt.

PDO::NULL_EMPTY_STRING

Leere Zeichenketten werden in null umgewandelt.

PDO::NULL_TO_STRING

null wird in eine leere Zeichenkette umgewandelt.

PDO::ATTR_STRINGIFY_FETCHES

Legt fest, ob numerische Werte beim Abrufen in Zeichenketten umgewandelt werden sollen; akzeptiert einen Wert vom Typ bool: true zum Aktivieren und false zum Deaktivieren.

PDO::ATTR_STATEMENT_CLASS

Legt die vom Benutzer bereitgestellte Anweisungsklasse fest, die von PDOStatement abgeleitet ist; muss das Format array(string classname, array(mixed constructor_args)) haben.

Achtung

Kann nicht mit persistenten PDO-Instanzen verwendet werden.

PDO::ATTR_TIMEOUT

Legt das Zeitlimit fest (in Sekunden); akzeptiert einen Wert vom Typ int.

Hinweis:

Diese Option wird nicht von allen Treibern unterstützt und ihre Bedeutung kann sich je nach Treiber unterscheiden. So wartet SQLite beispielsweise bis zu diesem Zeitwert, bevor es aufgibt, eine beschreibbare Sperre zu erhalten, aber andere Treiber können dies als Zeitlimit für den Verbindungsaufbau oder den Lesevorgang interpretieren.

PDO::ATTR_AUTOCOMMIT

Hinweis: Nur für die OCI-, Firebird- und MySQL-Treiber verfügbar.

Legt fest, ob jede einzelne Anweisung automatisch bestätigt werden soll; akzeptiert einen Wert vom Typ bool: true zum Aktivieren und false zum Deaktivieren. Voreinstellung: true.

PDO::ATTR_EMULATE_PREPARES

Hinweis: Nur für die OCI-, Firebird- und MySQL-Treiber verfügbar.

Aktiviert oder deaktiviert die Emulation vorbereiteter Anweisungen. Einige Treiber unterstützen vorbereitete Anweisungen nicht nativ oder nur eingeschränkt. Wenn es auf true gesetzt ist, werden vorbereitete Anweisungen immer emuliert, andernfalls versucht PDO, nativ vorbereitete Anweisungen zu verwenden. Falls der Treiber die aktuelle Abfrage nicht erfolgreich vorbereiten kann, greift PDO immer darauf zurück, die vorbereitete Anweisung zu emulieren.

PDO::MYSQL_ATTR_USE_BUFFERED_QUERY

Hinweis: Nur für den MySQL-Treiber verfügbar.

Legt fest, ob gepufferte Abfragen verwendet werden sollen; akzeptiert einen Wert vom Typ bool: true zum Aktivieren und false zum Deaktivieren. Voreinstellung: true.

PDO::ATTR_DEFAULT_FETCH_MODE

Legt den standardmäßigen Abrufmodus fest. Eine Beschreibung der Modi und ihrer Verwendung ist in der Dokumentation zu PDOStatement::fetch() zu finden.