💡 忙しい人のための結論(3行まとめ)
  • VALUES (?, ?), (?, ?) の複数行INSERT(Multi-row INSERT)を使うと、1件ずつの実行に比べて通信回数とインデックス更新負荷を劇的に削減できます。
  • MySQL / MariaDBには「1クエリあたりプレースホルダ最大65,535個」のハード上限があるため、必ず array_chunk() で500〜1,000件単位に分割して実行します。
  • チャンク分割した複数回のINSERT全体を beginTransaction() 〜 commit() で囲むことで、途中失敗時の不整合(一部だけ登録される状態)を防げます。

1. 発生する症状・やりたいこと(前提条件)

CSVインポートや日次バッチ処理で数千〜数万件のレコードをDBへ登録する際、1行ずつ INSERT を発行すると処理時間が数十秒〜数分に膨れ上がります。かといって全件を1つのバルクインサート文にまとめると、本番環境でデータ量が増えた瞬間に以下の致命的なエラーでクラッシュします。

  • CSV取込や外部API連携で、数千〜数十万件の配列データを数秒以内で高速に一括登録したいとき
  • foreach ループ内で毎回 prepare() と execute() を呼んでおり、タイムアウトが発生しているとき
  • 大量データを1回の複数行INSERTにまとめた結果、プレースホルダ上限(65,535個)を超えて本番バッチが異常終了したとき
SQLSTATE[HY000]: General error: 1390 Prepared statement contains too many placeholders
// 例:1行10カラムのデータなら、6,554行(65,540プレースホルダ)で上限65,535を突破しクラッシュ

2. ❌ やりがちなNGコード vs ⭕ 実務で使える正解コード

まずは現場で頻発する2大アンチパターン(ループ内都度実行・分割なし全件一括実行)と、PHP 8.3 / 8.4準拠の安全なバルクインサート実装を比較します。

❌ やりがちなNGコード(バグ・警告の原因)Before
<?php
// 1. トランザクションなしで毎回 prepare & execute(1万件で1万回の通信とディスク同期が発生し激重)
foreach ($users as $user) {
    $stmt = $pdo->prepare('INSERT INTO users (name, email, role) VALUES (?, ?, ?)');
    $stmt->execute([$user['name'], $user['email'], $user['role']]);
}

// 2. チャンク分割なしで全件を1クエリに結合(行数×カラム数が65,535を超えるとエラー1390で停止)
$tuples = implode(', ', array_fill(0, count($users), '(?, ?, ?)'));
$stmt = $pdo->prepare("INSERT INTO users (name, email, role) VALUES {$tuples}");
$stmt->execute(array_merge(...array_map(fn($u) => [$u['name'], $u['email'], $u['role']], $users)));

パターン1はオートコミットが毎回走るためディスクI/Oがボトルネックになり、パターン2はデータ件数が増えた瞬間にMySQLのプレースホルダ上限(65,535)やパケットサイズ上限(max_allowed_packet)に抵触して破綻します。

⭕ コピペで動く実務の正解コード(PHP 8.3/8.4対応)After
<?php
declare(strict_types=1);

/**
 * @param list<array{name: string, email: string, role: string}> $users
 */
function bulkInsertUsers(PDO $pdo, array $users): int
{
    if ($users === []) {
        return 0;
    }

    // 1チャンク1,000件に分割(1,000行 × 3列 = 3,000個 ≪ MySQL上限65,535個)
    $chunks = array_chunk($users, 1000);
    $totalInserted = 0;

    $pdo->beginTransaction();
    try {
        foreach ($chunks as $chunk) {
            $tuples = implode(', ', array_fill(0, count($chunk), '(?, ?, ?)'));
            $sql = "INSERT INTO users (name, email, role) VALUES {$tuples}";

            $params = [];
            foreach ($chunk as $user) {
                array_push($params, $user['name'], $user['email'], $user['role']);
            }

            $stmt = $pdo->prepare($sql);
            $stmt->execute($params);
            $totalInserted += $stmt->rowCount();
        }
        $pdo->commit();
        return $totalInserted;
    } catch (\Throwable $e) {
        if ($pdo->inTransaction()) {
            $pdo->rollBack();
        }
        throw $e;
    }
}

3. 仕様・使い分けの比較早見表

PHP(PDO)およびLaravelで複数レコードを登録する4つの手法について、1万件(1行3カラム)登録時のクエリ発行回数と実務での適性を比較します。

登録手法 1万件のSQL回数 プレースホルダ上限リスク おすすめな場面
複数行INSERT + array_chunk
(本記事の正解コード)
10回
(1,000件×10)
なし
(チャンク単位で制御)
【最優先】 数千〜数十万件のバッチ登録・CSVインポート・高速化が必要な場面
ループ外 prepare() 1回 +
トランザクション内 execute()
10,000回 なし
(毎回1行分のみ)
数百件程度の小規模登録、または1行ごとに lastInsertId() を個別取得したい場面
Laravel Model::insert() / upsert()
+ collect()->chunk(1000)
10回 chunk() なしだと上限エラー発生 Laravel環境でEloquentイベント不要のまま大量データを高速投入したい場面
トランザクションなし
ループ内都度 INSERT
10,000回
(+毎回fsync)
なし 【非推奨】 圧倒的に遅く、途中エラー時にロールバックもできないため実務では避ける

4. 実務でハマりやすい3つの注意点

1プレースホルダ上限「65,535」は「行数」ではなく「行数 × カラム数」

MySQLのプリペアドステートメント上限(65,535)は ? の総数でカウントされます。たとえば1行あたり20カラムあるテーブルでは 65535 ÷ 20 = 3,276行 で上限に達して General error: 1390 が発生するため、チャンクサイズは 500〜1,000件(最大でも floor(60000 / カラム数) 以下)に設定してください。

2エミュレートONでも max_allowed_packet 超過で接続切断される

PDO::ATTR_EMULATE_PREPARES => true(PDO側でのSQL文字列展開)にすると65,535個の制限は回避できますが、今度は1クエリのSQL文字列サイズが数MB〜数十MBに肥大化します。MySQLの max_allowed_packet 上限を超えると Packets larger than max_allowed_packet are not allowed や MySQL server has gone away で落ちるため、エミュレート有無に関わらずチャンク分割は必須です。

3Laravelの Model::insert() は created_at が自動設定されない

Laravelでバルクインサートを行う User::insert($chunk) は、内部でEloquentモデルを介さずクエリビルダを直接実行します。そのため created_at / updated_at の自動付与や saving / created イベントが一切発火しない仕様になっており、タイムスタンプを含めたい場合は配列側に now() を明示的にセットする必要があります。

5. よくある質問(FAQ)

Q. ユニークキー重複時にエラーにせず更新(UPSERT)したい場合はどう書けばいいですか?

MySQL 8.0.20以降では、INSERT文の末尾に AS new ON DUPLICATE KEY UPDATE name = new.name, role = new.role を付与することで、一括登録と既存行の更新を1クエリで実行できます(従来の VALUES(name) 関数はMySQL 8.0.20で非推奨化されました)。PostgreSQLやSQLiteの場合は ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name を使用します。

Q. 複数行のバルクインサートを実行したあと、pdo->lastInsertId() で全件分のIDは取得できますか?

いいえ、複数行INSERTを実行した直後の $pdo->lastInsertId() が返すのは、「そのバッチで挿入された最初の1行目のAUTO_INCREMENT ID」のみです(MySQL仕様)。採番された各レコードのIDを確実に後続処理で使いたい場合は、ユニークキー(メールアドレスや外部ID等)で再SELECTするか、1行ずつの execute() をトランザクション内で回す方式を選択してください。

Q. 1チャンクあたりの件数(array_chunkの第2引数)は何件にするのがベストですか?

一般的なテーブル(5〜20カラム程度)であれば 500件〜1,000件 が最もバランスの良いスイートスポットです。1,000件を超えると速度改善幅が頭打ちになる一方で、PHP側の配列メモリ消費量やDBのUndoログ・ロック保持時間が増大するため、1,000件前後に抑えるのが実務での定石です。