【サクッと解説】PHP fetchAllとfetchの違いと使い分け

2025年8月5日

1. 本記事のポイント

PHPのPDOにおけるfetch()とfetchAll()の違いを実例付きで解説
データ件数やメモリ効率など、使い分けの判断基準を提示
実務での選定ミスによる影響やパフォーマンス面の注意点も紹介

2. PHPのfetchAllとfetchとは？

PHPのPDOクラスには、データベースから結果を取得するためのfetch()とfetchAll()という2つの代表的なメソッドがあります。

いずれもSQL実行後に結果セット（ResultSet）を取得するために使われますが、取得方法とデータ量に大きな違いがあります。

fetch()は1行ずつ順に取得するのに対し、fetchAll()は全行を一括で取得します。この違いにより、実行時のメモリ使用量や処理パフォーマンス、そして適用できる場面に差が生まれます。

実務では、結果件数が数万件以上になる場合やストリーミング処理が必要な場合はfetch()が適しており、数件〜数十件程度の固定サイズのデータ取得ではfetchAll()の方が扱いやすいことが多いです。

3. 詳細解説

単一行ずつ処理したいときの`fetch()`

データを1件ずつ処理する必要がある場合はfetch()を使用します。

PHP

<?php
$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
$stmt = $pdo->query('SELECT id, name FROM users');

while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    // 1行ずつ表示する
    echo $row['id'] . ": " . $row['name'] . "\n";
}

<?php
$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
$stmt = $pdo->query('SELECT id, name FROM users');

while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    // 1行ずつ表示する
    echo $row['id'] . ": " . $row['name'] . "\n";
}

出力例：

1: 山田
2: 佐藤
3: 鈴木

この方法は、行数が多い場合でもメモリ効率が良く、逐次処理にも適しています。

一括取得で全体を扱いたいときの`fetchAll()`

全件を配列で一括取得したいときにはfetchAll()を使います。

PHP

<?php
$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
$stmt = $pdo->query('SELECT id, name FROM users');
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);

foreach ($rows as $row) {
    echo $row['id'] . ": " . $row['name'] . "\n";
}

<?php
$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'user', 'pass');
$stmt = $pdo->query('SELECT id, name FROM users');
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);

foreach ($rows as $row) {
    echo $row['id'] . ": " . $row['name'] . "\n";
}

出力はfetch()と同様ですが、取得時点で全データを配列に保持するため、大量データではメモリを圧迫します。

結果の件数で適切に使い分ける

以下は100万件のデータを取得するケースです：

PHP

<?php
$stmt = $pdo->query('SELECT * FROM large_table');

// 推奨されない方法（fetchAll）
$allRows = $stmt->fetchAll(); // 数GBのメモリ消費の可能性

// 推奨される方法（fetch）
while ($row = $stmt->fetch()) {
    // 各行を順に処理
}

<?php
$stmt = $pdo->query('SELECT * FROM large_table');

// 推奨されない方法（fetchAll）
$allRows = $stmt->fetchAll(); // 数GBのメモリ消費の可能性

// 推奨される方法（fetch）
while ($row = $stmt->fetch()) {
    // 各行を順に処理
}

このように、行数が非常に多い場合はfetch()を使ってストリーミング処理を行うのが基本です。

fetch vs fetchAllの比較と選定基準

項目	fetch()	fetchAll()
処理方式	1行ずつ	全行まとめて
メモリ使用	少ない	多い（件数依存）
コードの簡潔さ	やや冗長	簡潔
件数が多い場合	○	×
小規模な結果セット	○	○