(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDO::lastInsertId — Возвращает ID последней вставленной строки или значение последовательности
$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
.