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