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

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.