PDOフェッチパターン大全

# 忙しい人向け

Q. `PDO::FETCH_ASSOC`でフェッチするとき，キーを整数連番じゃなくて`id`にする方法は？

A. `PDO::FETCH_UNIQUE`を組み合わせる．

```php
$sql = "SELECT id, * FROM people WHERE gender = 'female'";
$rows = $pdo->query($sql)->fetchAll(PDO::FETCH_ASSOC|PDO::FETCH_UNIQUE);
var_dump($rows);
/*
[
    3 => ['id' => '3', 'name' => 'Lucy', 'gender' => 'female'],
    5 => ['id' => '5', 'name' => 'Mary', 'gender' => 'female'],
]
*/
```

```php:MySQLではシンタックスエラー回避のためにテーブル名を明示してください
$sql = "SELECT id, people.* FROM people WHERE gender = 'female'";
```

# はじめに

[PDOStatement::fetchAll](http://php.net/manual/ja/pdostatement.fetchall.php)の活用法を紹介します．ここでは，以下のものに限定します．

- 結果セットが**スカラー値**と**配列**のみで構成される
- ある程度役に立ちそうなもの

`PDO::FETCH_OBJ`および`PDO::FETCH_CLASS`系に関しては@Hirakuさんや@k-holyさんの記事を参照してください．

- [PDOの真の力を開放する - PHPでデータベースを扱う(3)](http://blog.tojiru.net/article/277021312.html)
- [PDOでオブジェクトをフェッチ＆JSONとCSVファイル出力](http://qiita.com/k-holy/items/ce829a60cafe48bd1f81)

なお，テーブルは以下のようなものを考え，これを`people`テーブルとします．

|id|name|gender|
|:---:|:---:|:---:|
|1|Bob|male|
|2|Bill|male|
|3|Lucy|female|
|4|Mike|male|
|5|Mary|female|

```php:作成用コード
$pdo = new PDO('sqlite::memory:', '', '', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
$pdo->exec("
    CREATE TABLE people(id INTEGER PRIMARY KEY, name TEXT, gender TEXT);
    INSERT INTO people
        SELECT 1, 'Bob', 'male' UNION ALL
        SELECT 2, 'Bill', 'male' UNION ALL
        SELECT 3, 'Lucy', 'female' UNION ALL
        SELECT 4, 'Mike', 'male' UNION ALL
        SELECT 5, 'Mary', 'female'
    ;
");
```

# パターン一覧

## スカラー値として取得

### 集約関数の適用結果を整数で取得

スッキリ感: ★★☆

```php
$sql = "SELECT COUNT(*) FROM people WHERE gender = 'female'";
$count = (int)$pdo->query($sql)->fetchColumn();
var_dump($count); // 2
```

- 値として使うカラム番号のデフォルトは`0`ですが，第1引数で変更できます．

## 1次元配列として取得

### 1件しか存在し得ないカラム群を取得

スッキリ感: ★☆☆

```php
$sql = "SELECT * FROM people WHERE id = 2";
$row = $pdo->query($sql)->fetch(PDO::FETCH_ASSOC);
if ($row === false) {
    throw new \RuntimeException('Not Found'); // falseになることを考慮したコードを書くべき
}
var_dump($row);
/*
['id' => '2', 'name' => 'Bill', 'gender' => 'male']
*/
```

親　の　顔　よ　り　見　た　光　景

### 整数連番をキー，1カラムを値とする配列を取得

スッキリ感: ★★☆

```php
$sql = "SELECT name FROM people WHERE gender = 'female'";
$names = $pdo->query($sql)->fetchAll(PDO::FETCH_COLUMN);
var_dump($names); // ['Lucy', 'Mary']
```

- 値として使うカラム番号のデフォルトは`0`ですが，第2引数で変更できます．

### 先頭カラムをキー，別の1カラムを値とする配列を取得

スッキリ感: ★★★

```php:正確に2カラムのみ選択しておく必要あり
$sql = "SELECT id, name FROM people WHERE gender = 'female'";
$names = $pdo->query($sql)->fetchAll(PDO::FETCH_KEY_PAIR);
var_dump($names); // [3 => 'Lucy', 5 => 'Mary']
```

```php:3カラム目以降を捨てたい，あるいは値として使うカラム番号を指定したい
$sql = "SELECT * FROM people WHERE gender = 'female'";
$names = $pdo->query($sql)->fetchAll(PDO::FETCH_COLUMN|PDO::FETCH_UNIQUE);
var_dump($names); // [3 => 'Lucy', 5 => 'Mary']
```

ほとんどの場合`PDO::FETCH_KEY_PAIR`で事足りますが，`PDO::FETCH_UNIQUE`のこんな使い方知っている人，少ないんじゃないでしょうか．

- 値として使うカラム番号のデフォルトは**`1`**ですが，第2引数で変更できます．
- <ins>キーとして使うカラム番号は指定できず，常に**`0`**</ins>となります．
- もしキーが重複している場合，<ins>**最後に**見つかった値が優先</ins>されます．

## 2次元配列として取得

### 整数連番をキー，カラム群を値とする配列を取得

スッキリ感: ★☆☆

```php
$sql = "SELECT * FROM people WHERE gender = 'female'";
$rows = $pdo->query($sql)->fetchAll(PDO::FETCH_ASSOC);
var_dump($rows);
/*
[
    ['id' => '3', 'name' => 'Lucy', 'gender' => 'female'],
    ['id' => '5', 'name' => 'Mary', 'gender' => 'female'],
]
*/
```

[実　家　の　よ　う　な　安　心　感](http://dic.nicovideo.jp/a/%E5%AE%9F%E5%AE%B6%E3%81%AE%E3%82%88%E3%81%86%E3%81%AA%E5%AE%89%E5%BF%83%E6%84%9F)


### 先頭カラムをキー，カラム群を値とする配列を取得

スッキリ感: ★★★<font color="red">★</font>

```php:キー自身はカラム群から除外
$sql = "SELECT * FROM people WHERE gender = 'female'";
$rows = $pdo->query($sql)->fetchAll(PDO::FETCH_ASSOC|PDO::FETCH_UNIQUE);
var_dump($rows);
/*
[
    3 => ['name' => 'Lucy', 'gender' => 'female'],
    5 => ['name' => 'Mary', 'gender' => 'female'],
]
*/
```

```php:キー自身もカラム群に含む
$sql = "SELECT id, * FROM people WHERE gender = 'female'";
$rows = $pdo->query($sql)->fetchAll(PDO::FETCH_ASSOC|PDO::FETCH_UNIQUE);
var_dump($rows);
/*
[
    3 => ['id' => '3', 'name' => 'Lucy', 'gender' => 'female'],
    5 => ['id' => '5', 'name' => 'Mary', 'gender' => 'female'],
]
*/
```

```php:MySQLではシンタックスエラー回避のためにテーブル名を明示してください
$sql = "SELECT id, people.* FROM people WHERE gender = 'female'";
```

これをやりたかった人114514364364人ぐらいいそう（名推理）

- <ins>キーとして使うカラム番号は指定できず，常に**`0`**</ins>となります．
- もしキーが重複している場合，<ins>**最後に**見つかった値が優先</ins>されます．

### 先頭カラムをキー，別の1カラムのキー毎のグループを値とする配列を取得

スッキリ感: ★★★

```php
$sql = "SELECT gender, name FROM people";
$grouped_names = $pdo->query($sql)->fetchAll(PDO::FETCH_COLUMN|PDO::FETCH_GROUP);
var_dump($grouped_names); 
/*
[
    'male' => ['Bob', 'Bill', 'Mike'],
    'female' => ['Lucy', 'Mary'],
]
*/
```

- グループ内の値として使うカラム番号のデフォルトは**`1`**ですが，第1引数で変更できます．
- <ins>キーとして使うカラム番号は指定できず，常に**`0`**</ins>となります．

## 3次元配列として取得

### 先頭カラムをキー，カラム群のキー毎のグループを値とする配列を取得

スッキリ感: ★★★

```php:キー自身はカラム群から除外
$sql = "SELECT gender, id, name FROM people";
$grouped_rows = $pdo->query($sql)->fetchAll(PDO::FETCH_ASSOC|PDO::FETCH_GROUP);
var_dump($grouped_rows); 
/*
[
    'male' => [
        ['id' => '1', 'name' => 'Bob'],
        ['id' => '2', 'name' => 'Bill'],
        ['id' => '4', 'name' => 'Mike'],
    ],
    'female' => [
        ['id' => '3', 'name' => 'Lucy'],
        ['id' => '5', 'name' => 'Mary'],
    ],
]
*/
```

```php:キー自身もカラム群に含む
$sql = "SELECT gender, * FROM people";
$grouped_rows = $pdo->query($sql)->fetchAll(PDO::FETCH_ASSOC|PDO::FETCH_GROUP);
var_dump($grouped_rows); 
/*
[
    'male' => [
        ['id' => '1', 'name' => 'Bob', 'gender' => 'male'],
        ['id' => '2', 'name' => 'Bill', 'gender' => 'male'],
        ['id' => '4', 'name' => 'Mike', 'gender' => 'male'],
    ],
    'female' => [
        ['id' => '3', 'name' => 'Lucy', 'gender' => 'female'],
        ['id' => '5', 'name' => 'Mary', 'gender' => 'female'],
    ],
]
*/
```

```php:MySQLではシンタックスエラー回避のためにテーブル名を明示してください
$sql = "SELECT gender, people.* FROM people";
```

- <ins>キーとして使うカラム番号は指定できず，常に**`0`**</ins>となります．