PDO::lastInsertId

(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

Descripción

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

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.

Parámetros

name: Nombre de la secuencia de objetos desde la cual debe devolverse el identificador.

Valores devueltos

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.

Errores/Excepciones

Emite un error de nivel E_WARNING si el atributo PDO::ATTR_ERRMODE está definido a PDO::ERRMODE_WARNING.

Lanza una excepción PDOException si el atributo PDO::ATTR_ERRMODE está definido a PDO::ERRMODE_EXCEPTION.