PDO::lastInsertId

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

PDO::lastInsertId — Liefert die ID der zuletzt eingefügten Zeile oder den Wert der zuletzt eingefügten Sequenz

Beschreibung

public PDO::lastInsertId(?string $name = null): string|false

Gibt je nach zugrundeliegendem Treiber die ID der zuletzt eingefügten Zeile oder den letzten Wert eines Sequenzobjekts zurück. Beispielsweise erlaubt PDO_PGSQL, für den Parameter name den Namen eines beliebigen Sequenzobjekts anzugeben.

Hinweis:
Es ist möglich, dass diese Methode bei verschiedenen PDO-Treibern nicht zu einem sinnvollen oder konsistenten Ergebnis führt, da die zugrundeliegende Datenbank unter Umständen nicht einmal das Konzept der automatischen Inkrementierung von Feldern oder Sequenzen unterstützt.

Parameter-Liste

name: Der Name des Sequenzobjekts, dessen ID zurückgegeben werden soll.

Rückgabewerte

Wenn für den Parameter name kein Sequenzname angegeben wurde, gibt PDO::lastInsertId() eine Zeichenkette zurück, die die Zeilen-ID der zuletzt in die Datenbank eingefügten Zeile darstellt.

Wenn für den Parameter name ein Sequenzname angegeben wurde, gibt PDO::lastInsertId() eine Zeichenkette zurück, die den zuletzt aus dem angegebenen Sequenzobjekt abgerufenen Wert darstellt.

Wenn der PDO-Treiber diese Funktionalität nicht unterstützt, löst PDO::lastInsertId() den SQLSTATE IM001 aus.

Fehler/Exceptions

Gibt einen Fehler der Stufe E_WARNING aus, wenn das Attribut PDO::ATTR_ERRMODE auf PDO::ERRMODE_WARNING gesetzt ist.

Löst eine PDOException aus, wenn das Attribut PDO::ATTR_ERRMODE auf PDO::ERRMODE_EXCEPTION gesetzt ist.