PDO::lastInsertId

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

PDO::lastInsertId — Возвращает ID последней вставленной строки или значение последовательности

Описание

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

Возвращает ID последней вставленной строки или последнее значение от объекта последовательности, в зависимости от базового драйвера. Например, драйвер PDO_PGSQL разрешает задать имя объекта последовательности для параметра name.

Замечание:
В зависимости от драйвера PDO этот метод может вообще не выдать осмысленного результата, так как база данных может не поддерживать автоматического инкремента полей или последовательностей.

Список параметров

name: Имя объекта последовательности, который должен выдать ID.

Возвращаемые значения

Если объект последовательности для параметра name не задан, метод PDO::lastInsertId() вернёт строку, представляющую ID последней добавленной в базу записи.

Если же объект последовательности для параметра name задан, метод PDO::lastInsertId() вернёт строку, представляющую последнее значение, полученное от этого объекта.

Если PDO-драйвер не поддерживает эту возможность, метод PDO::lastInsertId() запишет значение IM001 в SQLSTATE.

Ошибки

Метод выдаёт ошибку уровня E_WARNING, если для атрибута PDO::ATTR_ERRMODE установили режим PDO::ERRMODE_WARNING.

Метод выбрасывает исключение PDOException, если для атрибута PDO::ATTR_ERRMODE установили режим PDO::ERRMODE_EXCEPTION.