(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDO::lastInsertId — Devuelve el identificador de la última fila insertada o el valor de una secuencia
Devuelve el identificador de la última fila insertada, o el último valor
de una secuencia de objetos, dependiendo del driver utilizado. Por ejemplo,
PDO_PGSQL permite especificar el nombre de cualquier
objeto secuencia para el argumento name
.
Nota:
Este método puede no devolver un resultado significativo según los drivers PDO utilizados, ya que la base de datos empleada puede no soportar la noción de campos auto-incrementados o de secuencias.
name
Nombre de la secuencia de objetos desde la cual debe devolverse el identificador.
Si no se especifica un nombre de secuencia para el argumento
name
, PDO::lastInsertId()
devuelve una cadena que representa el identificador de la última fila insertada
en la base de datos.
Si se especifica un nombre de secuencia para el argumento
name
, PDO::lastInsertId()
devuelve una cadena que representa el último valor de la secuencia de objetos especificada.
Si el driver PDO no soporta esta funcionalidad,
PDO::lastInsertId() lanzará un SQLSTATE
IM001
.
Emits an error with level E_WARNING
if the attribute PDO::ATTR_ERRMODE
is set
to PDO::ERRMODE_WARNING
.
Throws a PDOException if the attribute PDO::ATTR_ERRMODE
is set to PDO::ERRMODE_EXCEPTION
.