Vordefinierte Konstanten

Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.

PDO::PARAM_BOOL (int)

Stellt den Datentyp Boolean dar.

PDO::PARAM_NULL (int)

Stellt den Datentyp SQL-NULL dar.

PDO::PARAM_INT (int)

Stellt den Datentyp SQL-INTEGER dar.

PDO::PARAM_STR (int)

Stellt SQL-CHAR, VARCHAR und andere String-Datentypen dar.

PDO::PARAM_STR_NATL (int)

Ein Flag, das angibt, dass eine Zeichenkette den nationalen Zeichensatz verwendet. Verfügbar seit PHP 7.2.0

PDO::PARAM_STR_CHAR (int)

Ein Flag, das angibt, dass eine Zeichenkette den regulären Zeichensatz verwendet. Verfügbar seit PHP 7.2.0

PDO::PARAM_LOB (int)

Stellt den SQL-Datentyp LOB (large object) dar.

PDO::PARAM_STMT (int)

Stellt einen Datensatztyp dar. Wird derzeit von keinem Treiber unterstützt.

PDO::PARAM_INPUT_OUTPUT (int)

Legt fest, dass der Parameter ein INOUT-Parameter für eine Stored Procedure sein muss. Auf den Wert muss ein bitweises OR mit einem eindeutigen PDO::PARAM_*-Parameter ausgeführt werden.

PDO::FETCH_DEFAULT (int)

Legt fest, dass der standardmäßige Abrufmodus verwendet werden soll. Verfügbar seit PHP 8.0.7.

PDO::FETCH_LAZY (int)

Legt fest, dass die Methode zum Abrufen von Daten jede Zeile als Objekt zurückgeben soll, dessen Eigenschaftsnamen den Spaltennamen aus der zurückgegebenen Ergebnismenge entsprechen. PDO::FETCH_LAZY gibt ein PDORow-Objekt zurück, das die Eigenschaftsnamen des Objekts erstellt, sobald auf diese zugegriffen wird. Ungültig innerhalb von PDOStatement::fetchAll().

PDO::FETCH_ASSOC (int)

Legt fest, dass die Methode zum Abrufen von Daten jede Zeile in einem assoziativen Array zurückgibt, das mit den Spaltennamen aus der Ergebnismenge indiziert wird. Wenn die Ergebnismenge mehrere gleichlautende Spaltennamen enthält, gibt PDO::FETCH_ASSOC nur einen Wert pro Spaltenname zurück.

PDO::FETCH_NAMED (int)

Legt fest, dass die Methode zum Abrufen von Daten jede Zeile als ein Array mit dem Index des Spaltennamens der entsprechenden Ergebnismenge zurückgeben soll. Wenn die Ergebnismenge mehrere Spalten mit dem gleichen Namen besitzt, gibt PDO::FETCH_NAMED ein Array von Werten pro Spaltenname zurück.

PDO::FETCH_NUM (int)

Legt fest, dass die Methode zum Abrufen von Daten jede Zeile als Array zurückgeben soll, indiziert durch die Spaltennummer, wie sie in der entsprechenden Ergebnismenge zurückgegeben wird, beginnend bei Spalte 0.

PDO::FETCH_BOTH (int)

Legt fest, dass die Methode zum Abrufen von Daten jede Zeile als Array zurückgeben soll, das durch den Spaltennamen und die Spaltennummer indiziert ist, wie sie in der entsprechenden Ergebnismenge zurückgegeben werden, beginnend bei Spalte 0.

PDO::FETCH_OBJ (int)

Legt fest, dass die Methode zum Abrufen von Daten jede Zeile als ein Objekt mit Eigenschaftsnamen zurückgeben soll, die den in der Ergebnismenge zurückgegebenen Spaltennamen entsprechen.

PDO::FETCH_BOUND (int)

Legt fest, dass die Methode zum Abrufen von Daten TRUE zurückgeben soll und die Werte der Spalten in der Ergebnismenge den PHP-Variablen zuweist, an die sie mit der Methode PDOStatement::bindParam() oder der Methode PDOStatement::bindColumn() gebunden wurden.

PDO::FETCH_COLUMN (int)

Legt fest, dass die Methode zum Abrufen von Daten nur eine einzige angeforderte Spalte aus der nächsten Zeile in der Ergebnismenge zurückgeben soll.

PDO::FETCH_CLASS (int)

Legt fest, dass die Methode zum Abrufen von Daten eine neue Instanz der angeforderten Klasse zurückgeben soll.

Hinweis: Das Objekt wird initialisiert, indem die Spalten der Ergebnismenge den Eigenschaften der Klasse zugewiesen werden. Dies geschieht vor dem Aufruf des Konstruktors und erlaubt die Belegung von Eigenschaften unabhängig von ihrer Sichtbarkeit oder davon, ob sie als readonly markiert sind. Wenn eine Eigenschaft in der Klasse nicht existiert, wird die magische Methode __set() aufgerufen, falls sie existiert; andernfalls wird eine dynamische öffentliche Eigenschaft erstellt. Wenn jedoch auch PDO::FETCH_PROPS_LATE angegeben ist, wird der Konstruktor vor dem Belegen der Eigenschaften aufgerufen.

PDO::FETCH_INTO (int)

Legt fest, dass die Methode zum Abrufen von Daten eine vorhandene Instanz der angeforderten Klasse aktualisieren soll, indem die Spalten den benannten Eigenschaften der Klasse zugeordnet werden.

PDO::FETCH_FUNC (int)

Ermöglicht die ad-hoc Anpassung der Daten (nur gültig innerhalb von PDOStatement::fetchAll()).

PDO::FETCH_GROUP (int)

Gruppiert die Rückgabe nach den Werten. Üblicherweise in Verbindung mit PDO::FETCH_COLUMN oder PDO::FETCH_KEY_PAIR.

PDO::FETCH_UNIQUE (int)

Ruft nur eindeutige Werte abrufen.

PDO::FETCH_KEY_PAIR (int)

Liefert das Ergebnis von zwei Spalten als Array. Der Inhalt der ersten Spalte ist der Schlüssel und der Inhalt der zweiten Spalte ist der Wert.

PDO::FETCH_CLASSTYPE (int)

Ermittelt den Klassennamen aus dem Wert der ersten Spalte.

PDO::FETCH_SERIALIZE (int)

Ähnlich wie PDO::FETCH_INTO, liefert aber das Objekt als serialisierte Zeichenkette. Der Konstruktor wird nicht aufgerufen, wenn dieses Flag gesetzt ist. Ab PHP 8.1.0 veraltet.

PDO::FETCH_PROPS_LATE (int)

Ruft den Konstrutor auf, bevor die Eigenschaften gesetzt werden.

PDO::ATTR_AUTOCOMMIT (int)

Wenn dieser Wert false ist, versucht PDO, Autocommit zu deaktivieren, damit die Verbindung eine Transaktion starten kann.

PDO::ATTR_PREFETCH (int)

Durch Ändern der Prefetch-Puffergröße können Sie die Balance zwischen Speicherverbrauch und Datenbankgeschwindigkeit einstellen. Nicht alle Datenbank/Treiber-Kombinationen unterstützen die Größenänderung dieses Puffers. Je größer der Puffer ist, desto höher ist die Leistung, aber auch der Speicherverbrauch.

PDO::ATTR_TIMEOUT (int)

Legt den Timeout-Wert für die Kommunikation mit der Datenbank in Sekunden fest.

PDO::ATTR_ERRMODE (int)

Informationen zu diesem Attribut finden Sie im Abschnitt Fehler und Fehlerbehandlung.

PDO::ATTR_SERVER_VERSION (int)

Dieses Attribut ist schreibgeschützt; es gibt Informationen über die Version des Datenbankservers zurück, mit dem PDO verbunden ist.

PDO::ATTR_CLIENT_VERSION (int)

Dieses Attribut ist schreibgeschützt; es gibt Informationen über die Versionen der Client-Bibliotheken zurück, die der PDO-Treiber verwendet.

PDO::ATTR_SERVER_INFO (int)

Dieses Attribut ist schreibgeschützt; es gibt einige Metainformationen über den Datenbankserver zurück, mit dem PDO verbunden ist.

PDO::ATTR_CONNECTION_STATUS (int)

PDO::ATTR_CASE (int)

Erzwingt die Zuordnung von Spaltennamen zur Groß- oder Kleinschreibung, die durch die PDO::CASE_*-Konstanten festgelegt wird.

PDO::ATTR_CURSOR_NAME (int)

Liefert oder setzt den Namen, der für einen Cursor verwendet werden soll. Am nützlichsten bei der Verwendung von scrollbaren Cursorn und positionierten Aktualisierungen.

PDO::ATTR_CURSOR (int)

Wählt den Cursortyp aus. PDO unterstützt derzeit entweder PDO::CURSOR_FWDONLY oder PDO::CURSOR_SCROLL. Bleiben Sie bei PDO::CURSOR_FWDONLY, es sei denn, Sie wissen, dass Sie einen scrollbaren Cursor benötigen.

PDO::ATTR_DRIVER_NAME (int)

Gibt den Namen des Treibers zurück.

Beispiel #1 Die Verwendung von PDO::ATTR_DRIVER_NAME

<?php
if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
echo "Läuft auf MySQL; macht hier etwas MySQL-spezifisches\n";
}
?>

PDO::ATTR_ORACLE_NULLS (int)

Konvertiert leere Zeichenketten bei Datenabfragen in SQL-NULL-Werte.

PDO::ATTR_PERSISTENT (int)

Fordert eine persistente Verbindung an, anstatt eine neue Verbindung zu erstellen. Weitere Informationen zu diesem Attribut finden Sie im Abschnitt Verbindungen und Verbindungsmanagement.

PDO::ATTR_STATEMENT_CLASS (int)

Legt den Name der Klasse fest, die als Statement zurückgegeben wird.

PDO::ATTR_FETCH_CATALOG_NAMES (int)

Stellt jedem Spaltennamen, der in der Ergebnismenge zurückgegeben wird, den Namen des enthaltenden Katalogs voran. Der Katalogname und der Spaltenname werden durch einen Punkt (.) getrennt. Die Unterstützung dieses Attributs liegt auf der Treiberebene; es kann sein, dass es von Ihrem Treiber nicht unterstützt wird.

PDO::ATTR_FETCH_TABLE_NAMES (int)

Stellt jedem Spaltennamen, der in der Ergebnismenge zurückgegeben wird, den Namen der enthaltenden Tabelle voran. Der Tabellenname und der Spaltenname werden durch einen Punkt (.) getrennt. Die Unterstützung dieses Attributs liegt auf der Treiberebene; es kann sein, dass es von Ihrem Treiber nicht unterstützt wird.

PDO::ATTR_STRINGIFY_FETCHES (int)

Erzwingt, dass alle Werte (außer null) als Zeichenkette abgerufen werden. Die null-Werte bleiben unverändert, es sei denn, PDO::ATTR_ORACLE_NULLS wird auf PDO::NULL_TO_STRING gesetzt.

PDO::ATTR_MAX_COLUMN_LEN (int)

Legt die maximale Länge der Spaltennamen fest.

PDO::ATTR_DEFAULT_FETCH_MODE (int)

PDO::ATTR_EMULATE_PREPARES (int)

PDO::ATTR_DEFAULT_STR_PARAM (int)

Legt den Standard-Zeichenketten-Parametertypen fest; entweder PDO::PARAM_STR_NATL oder PDO::PARAM_STR_CHAR. Verfügbar seit PHP 7.2.0.

PDO::ERRMODE_SILENT (int)

Löst keinen Fehler und keine Ausnahme aus, wenn ein Fehler auftritt. Es wird erwartet, dass der Entwickler explizit auf Fehler prüft. Dies ist der Standardmodus. Weitere Informationen zu diesem Attribut finden Sie im Abschnitt Fehler und Fehlerbehandlung.

PDO::ERRMODE_WARNING (int)

Gibt eine PHP-E_WARNING-Meldung aus, wenn ein Fehler auftritt. Weitere Informationen zu diesem Attribut finden Sie im Abschnitt Fehler und Fehlerbehandlung.

PDO::ERRMODE_EXCEPTION (int)

Löst eine PDOException aus, wenn ein Fehler auftritt. Weitere Informationen zu diesem Attribut finden Sie im Abschnitt Fehler und Fehlerbehandlung.

PDO::CASE_NATURAL (int)

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

PDO::CASE_LOWER (int)

Erzwingt die Kleinschreibung von Spaltennamen.

PDO::CASE_UPPER (int)

Erzwingt die Großschreibung von Spaltennamen.

PDO::NULL_NATURAL (int)

PDO::NULL_EMPTY_STRING (int)

PDO::NULL_TO_STRING (int)

PDO::FETCH_ORI_NEXT (int)

Liefert die nächste Zeile aus der Ergebnismenge. Gilt nur für scrollbare Cursor.

PDO::FETCH_ORI_PRIOR (int)

Liefert die vorherige Zeile aus der Ergebnismenge. Gilt nur für scrollbare Cursor.

PDO::FETCH_ORI_FIRST (int)

Liefert die erste Zeile aus der Ergebnismenge. Gilt nur für scrollbare Cursor.

PDO::FETCH_ORI_LAST (int)

Liefert die vorherige Zeile aus der Ergebnismenge. Gilt nur für scrollbare Cursor.

PDO::FETCH_ORI_ABS (int)

Liefert die angeforderte Zeile anhand der Zeilennummer aus der Ergebnismenge. Gilt nur für scrollbare Cursor.

PDO::FETCH_ORI_REL (int)

Liefert die angeforderte Zeile an einer Position relativ zur aktuellen Position des Cursors aus der Ergebnismenge. Gilt nur für scrollbare Cursor.

PDO::CURSOR_FWDONLY (int)

Erzeugt ein PDOStatement-Objekt mit einem Nur-Vorwärts-Cursor. Dies ist die Standard-Cursor-Wahl, da es das schnellste und häufigste Datenzugriffsmuster in PHP ist.

PDO::CURSOR_SCROLL (int)

Erzeugt ein PDOStatement-Objekt mit einem scrollbaren Cursor. Übergeben Sie die Konstante PDO::FETCH_ORI_*, um die aus der Ergebnismenge abgerufenen Zeilen zu steuern.

PDO::ERR_NONE (string)

Entspricht dem SQLSTATE '00000', d. h. die SQL-Anweisung wurde erfolgreich und ohne Fehler oder Warnungen ausgegeben. Diese Konstante ist für die Unterstützung bei der Überprüfung von PDO::errorCode() oder PDOStatement::errorCode(), um festzustellen, ob ein Fehler aufgetreten ist. Normalerweise wissen Sie sowieso, ob dies der Fall ist, indem Sie den Rückgabewert der Methode untersuchen, die die Fehlerbedingung ausgelöst hat.

PDO::PARAM_EVT_ALLOC (int)

Ein Zuweisungsereignis (Allocation).

PDO::PARAM_EVT_FREE (int)

Ein Freigabe-Ereignis (Deallocation).

PDO::PARAM_EVT_EXEC_PRE (int)

Löst ein Ereignis vor der Ausführung einer vorbereiteten Anweisung aus.

PDO::PARAM_EVT_EXEC_POST (int)

Löst ein Ereignis nach der Ausführung einer vorbereiteten Anweisung aus.

PDO::PARAM_EVT_FETCH_PRE (int)

Löst ein Ereignis vor dem Abrufen eines Ergebnisses aus einer Ergebnismenge aus.

PDO::PARAM_EVT_FETCH_POST (int)

Löst ein Ereignis nach dem Abrufen eines Ergebnisses aus einer Ergebnismenge aus.

PDO::PARAM_EVT_NORMALIZE (int)

Löst ein Ereignis während der Registrierung eines gebundenen Parameters aus, was es dem Treiber ermöglicht, den Parameternamen zu normalisieren.

PDO::SQLITE_DETERMINISTIC (int)

Signalisiert, dass eine Funktion die mit PDO::sqliteCreateFunction() erzeugt wurde, deterministisch ist, d. h. dass sie immer dasselbe Ergebnis liefert, wenn sie innerhalb derselben SQL-Anweisung mit den gleichen Parametern aufgerufen wird. (Verfügbar seit PHP 7.1.4.)