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 パラメータにシーケンス名が指定されなかった場合、 PDO::lastInsertId() はデータベースに挿入された最後の行の行IDに相当する文字列を返します。

もし name パラメータにシーケンス名が指定された場合、 PDO::lastInsertId() は指定されたシーケンスオブジェクトから取得した最後の値に相当する文字列を返します。

もし PDO ドライバがサポートしていない場合、 PDO::lastInsertId() は IM001 SQLSTATE を発生させます。

PDO::ATTR_ERRMODE が PDO::ERRMODE_WARNING に設定されていた場合、E_WARNING レベルのエラーが発生します。

PDO::ATTR_ERRMODE が PDO::ERRMODE_EXCEPTION に設定されていた場合、PDOException がスローされます。