【PHP8.x】Pdo\Sqlite::lastInsertId()メソッドの使い方

lastInsertIdメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年01月17日

基本的な使い方

lastInsertIdメソッドは、データベースに新しいレコード（行）を挿入した直後に、そのレコードに自動的に割り当てられた一意なID（識別子）を取得するために実行するメソッドです。これは、PDOオブジェクトがSQLiteデータベースに接続している際に特に利用され、例えばテーブルの主キーが自動増分（INTEGER PRIMARY KEY AUTOINCREMENTなど）に設定されている場合に非常に有用です。

このメソッドを呼び出すことで、直前のINSERT文の実行によってデータベースが自動生成したIDを文字列として受け取ることができます。例えば、アプリケーションで新しいユーザーをデータベースに登録した後、そのユーザーのIDをすぐに知りたい場合や、新しく作成した注文のIDを後続の処理で利用したい場合などに活用されます。これにより、データベースにデータが追加された後の処理を、そのデータのIDに基づいて円滑に進めることが可能になります。

引数を指定せずに呼び出すことが一般的ですが、データベースによっては特定のシーケンス名を引数として渡すことも可能です。戻り値は常に文字列型であるため、必要に応じて数値型に変換して使用します。もし直前の操作でIDが生成されなかった場合や、何らかのエラーが発生した場合には、0や空文字列、または特定のドライバ固有の値が返されることがあります。データベースと連携するアプリケーションを開発する上で、挿入されたデータのIDを確実に把握するための重要な機能です。

構文(syntax)


1<?php
2
3// SQLiteデータベースへの接続 (例: メモリ内データベースを使用)
4// 実際にはファイルパスを指定する場合が多い: 'sqlite:/path/to/database.db'
5$pdo = new PDO('sqlite::memory:');
6
7// エラーモードを設定 (推奨されるプラクティス)
8$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
9
10// IDが自動生成されるテーブルを作成
11$pdo->exec("CREATE TABLE IF NOT EXISTS products (
12    id INTEGER PRIMARY KEY AUTOINCREMENT,
13    name TEXT NOT NULL
14)");
15
16// 新しいデータを挿入し、自動生成されるIDを伴う操作を実行
17$stmt = $pdo->prepare("INSERT INTO products (name) VALUES (?)");
18$stmt->execute(['Sample Product A']);
19
20// 最後に挿入された行のIDを取得する
21// Pdo\Sqlite の場合、通常 $name パラメータは指定しません。
22$lastInsertedId = $pdo->lastInsertId();
23
24echo "新しく挿入された商品のID: " . $lastInsertedId;
25
26// 別のデータを挿入
27$stmt->execute(['Sample Product B']);
28$lastInsertedId = $pdo->lastInsertId();
29echo "\n新しく挿入された別の商品のID: " . $lastInsertedId;
30
31?>

引数(parameters)

?string $name = null

?string $name = null: INSERT文で自動採番されたIDを取得する際に、リレーションシップを識別するためのシーケンス名を指定します。指定しない場合は、最後に挿入された行のIDが返されます。

戻り値(return)

string|false

このメソッドは、直前に実行されたINSERT文によって生成された最後のAUTO_INCREMENT IDを文字列で返します。データベース操作が失敗した場合はfalseを返します。

サンプルコード

PHP PDO SQLite lastInsertId でIDを取得する


1<?php
2
3/**
4 * PDO::lastInsertId() メソッドの使用例を示します。
5 *
6 * この関数は、SQLiteデータベースに接続し、テーブルを作成し、データを挿入した後、
7 * 最後に挿入された行の自動生成IDを取得する方法を実演します。
8 *
9 * lastInsertId() メソッドは、通常、データベースが自動的に採番するID（AUTO_INCREMENTなど）を
10 * 持つテーブルにデータを挿入した際に、そのIDを文字列として返します。
11 * もしIDが自動採番されないテーブルに挿入した場合や、特定のデータベースシステムでは、
12 * このメソッドが '0' を返すことがあります。また、エラー時には false を返します。
13 */
14function demonstratePdoLastInsertId(): void
15{
16    // 一時的なSQLiteデータベースファイルを作成し、終了後に削除します。
17    $dbFile = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'demo_db_' . uniqid() . '.sqlite';
18    $pdo = null;
19
20    try {
21        // SQLiteデータベースに接続します。ファイルが存在しない場合は新規作成されます。
22        $pdo = new PDO('sqlite:' . $dbFile);
23        // PDOのエラーモードを例外をスローするように設定します。
24        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
25        echo "SQLiteデータベースに接続しました。\n";
26
27        // テーブルを作成します。
28        // 'id' カラムを 'INTEGER PRIMARY KEY' とすることで、自動的にユニークなIDが採番されます。
29        // これにより、lastInsertId() が有効なIDを返すことが期待されます。
30        $pdo->exec("
31            CREATE TABLE IF NOT EXISTS users (
32                id INTEGER PRIMARY KEY,
33                name TEXT NOT NULL
34            )
35        ");
36        echo "テーブル 'users' を作成しました。\n";
37
38        // データを挿入します。
39        $stmt = $pdo->prepare("INSERT INTO users (name) VALUES (?)");
40        $stmt->execute(['Alice Smith']);
41        echo "データを挿入しました。\n";
42
43        // 最後に挿入された行のIDを取得します。
44        // この設定では、通常1以上の整数IDが文字列として返されます。
45        // もしテーブルに自動採番されるIDカラムがない場合や、データベースの種類によっては、
46        // lastInsertId() は '0' を返すことがあります。
47        $lastId = $pdo->lastInsertId();
48
49        if ($lastId === false) {
50            echo "エラー: lastInsertId() の取得に失敗しました。\n";
51        } else {
52            echo "最後に挿入されたユーザーのID: " . $lastId . "\n";
53            if ($lastId === '0') {
54                echo "注意: IDが '0' を返しました。これは自動採番IDがないか、または特定のデータベース設定によるものです。\n";
55            }
56        }
57
58    } catch (PDOException $e) {
59        echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
60    } finally {
61        // データベース接続を閉じます。
62        $pdo = null;
63        // 作成したデータベースファイルを削除します。
64        if (file_exists($dbFile)) {
65            unlink($dbFile);
66            echo "一時データベースファイルを削除しました。\n";
67        }
68    }
69}
70
71// 関数を実行してデモンストレーションを開始します。
72demonstratePdoLastInsertId();

PHPのPDO::lastInsertId()メソッドは、データベースに新しいデータを挿入した際に、自動的に生成されたID（識別子）を取得するために使用されます。例えば、AUTO_INCREMENTのような自動採番機能を持つテーブルにレコードを追加した後、そのレコードのIDを知りたい場合に役立ちます。

このメソッドは、オプションで$nameという引数を受け取ります。これはPostgreSQLなどの特定のデータベースで利用されるシーケンス名を指定するために使われますが、多くの場合は省略され、データベースが自動的に採番したIDを返します。

戻り値は通常、自動生成されたIDを文字列として返します。しかし、重要な注意点として、もし挿入されたテーブルに自動採番されるIDカラムがない場合や、特定のデータベースシステムの設定によっては、戻り値が**文字列の'0'**となることがあります。また、IDの取得に失敗した場合はfalseを返します。

提供されたサンプルコードでは、SQLiteデータベースに接続し、自動採番IDを持つテーブルを作成してデータを挿入した後、lastInsertId()を使ってそのIDを取得する一連の流れが示されています。これにより、挿入したデータのIDを確実に把握し、次の処理に活かすことができます。'0'が返される可能性についても考慮に入れることで、より堅牢なデータベース処理を構築できます。

PDO::lastInsertId()メソッドは、データベースが自動的に採番するID（AUTO_INCREMENTなど）を、データ挿入後に取得する際に利用します。このメソッドは通常、採番されたIDを文字列で返しますが、エラーが発生した場合にはfalseを返します。

特に注意すべき点として、自動採番IDを持たないテーブルにデータを挿入した場合や、特定のデータベースシステムや設定においては、'0'という文字列が返されることがあります。これはエラーではありませんが、実際に新しいIDが採番されたわけではないため、IDが正しく取得できたかを確認する際には、戻り値がfalseでないかだけでなく、'0'であるかどうかも適切にチェックすることが重要です。これにより、意図しない挙動を防ぎ、安全にコードを利用できます。