配列

PHP array_column関数の使い方を解説

2025-02-19更新日: 2025-02-19

PHPのarray_column関数は、多次元配列から指定したキーに対応した値を簡単に抽出できる便利な機能です。

配列内の必要なデータだけを抽出することで、データ整形やフィルタリングが効率的に行えます。

この記事では、基本的な使い方や具体例を紹介します。

目次から探す

基本操作
- array_column関数のシンタックス
- 多次元配列の取り扱い
使用例
- シンプルなケース
- 複雑なケース
注意事項
- 型とキーの扱い
- 処理性能の確認
まとめ

基本操作

array_column関数のシンタックス

引数の役割($array)

PHPのarray_column関数は、まず対象となる元の配列を引数$arrayとして受け取ります。

この配列は、キーが連想配列になっている多次元配列である必要があります。

各要素から必要な値を抽出するために、各要素が同じ形式であることが求められます。

引数の役割($column_key)

引数$column_keyは、各サブ配列から取り出す値を指定するために使用します。

たとえば、各要素に'name'というキーがある場合、$column_keyに'name'を設定することで、すべてのnameの値を一つの配列として取得することが可能となります。

また、数学的に考えれば、取り出す値の集合を

$Math not terminated in text box$

のように捉えることができます。

引数の役割($index_key)

引数$index_keyを指定すると、結果として得られる配列のキーに、各サブ配列の指定した値を使用します。

これにより、連想配列としての利便性が高まり、既存のキーに基づいた検索が簡単になります。

設定しなかった場合は、PHPが自動的に0から始まる連番インデックスを割り当てます。

多次元配列の取り扱い

入力配列の構造例

array_column関数は多次元配列に適用されるため、入力配列は以下のような構造になっていることが一般的です。

各サブ配列は同じキーを持つ連想配列となっており、取り出す対象となるキー(例：'name'や'age')が存在します。
値を一括で取得したいキーが明確になっている必要があります。

例えば、以下のようなPHP配列を使用する場合を考えてみましょう。

$data = [
    // 各要素は連想配列となっている
    ['id' => 101, 'name' => '太郎', 'email' => 'taro@example.com'],
    ['id' => 102, 'name' => '花子', 'email' => 'hana@example.com'],
    ['id' => 103, 'name' => '次郎', 'email' => 'jiro@example.com'],
];

この場合、'name'を抽出したい場合は、$column_keyに'name'を指定することになります。

結果確認のポイント

関数実行後に返される配列は、キーの選択方法により以下のように変わります。

$index_keyを使用しない場合、返り値は0から始まる連番インデックスの配列になります。
$index_keyを指定すると、そのキーの値が返り値の添字になるため、混在するデータ型の変換に注意が必要です。

返却結果の各要素が正しい値であることを、ループやデバッガで確認することで、意図した出力となっているかチェックすることができます。

使用例

シンプルなケース

サンプルコード記述

以下は、最も基本的な使用例です。

指定された配列から、'name'の値だけを取得する例を示しています。

<?php
// サンプル配列の定義
$data = [
    // 各連想配列から 'name' を抽出する
    ['id' => 1, 'name' => 'Alice', 'age' => 25],
    ['id' => 2, 'name' => 'Bob', 'age' => 30],
    ['id' => 3, 'name' => 'Charlie', 'age' => 22],
];
// array_column関数で 'name' の列を取り出す
$result = array_column($data, 'name');
// 結果の出力
print_r($result);
?>

Array
(
    [0] => Alice
    [1] => Bob
    [2] => Charlie
)

実行結果の確認

上記のコードを実行すると、出力結果はArrayとして表示され、それぞれのインデックスに対応した名前が含まれることが確認できます。

この結果は、array_column関数が正しく動作していることを示しています。

複雑なケース

インデックス指定を活用した例

次の例では、抽出する列だけでなく、各要素のキーとして利用する'id'の値も指定しています。

これにより、結果の配列は各要素のidをキーとして持つ連想配列になります。

<?php
// サンプル配列の定義
$data = [
    // 'id' をキーにすることで連想配列として出力する
    ['id' => 101, 'name' => 'David', 'email' => 'david@example.com'],
    ['id' => 102, 'name' => 'Emma', 'email' => 'emma@example.com'],
    ['id' => 103, 'name' => 'Frank', 'email' => 'frank@example.com'],
];
// array_column関数で 'name' を取り出し、'id'をインデックスに指定する
$result = array_column($data, 'name', 'id');
// 結果の出力
print_r($result);
?>

Array
(
    [101] => David
    [102] => Emma
    [103] => Frank
)

各パターンでの動作

上記の例では、$index_keyとして'id'を指定しているため、出力される配列は指定したidをキーとして持ちます。

これにより、必要な値に対して高速なアクセスが可能になります。

また、混在するデータ型に関しては、PHPが自動的に型変換をおこなうため、入力データの整合性が保たれているかを確認することが大切です。

注意事項

型とキーの扱い

存在しないキーの場合の動作

array_column関数では、指定した$column_keyや$index_keyが存在しない場合、返り値の該当箇所はnullとなります。

たとえば、下記の例では'salary'キーを指定していますが、入力配列内にこのキーが存在しないため、結果として得られる配列はすべてnullを格納します。

<?php
// サンプル配列の定義
$data = [
    ['id' => 1, 'name' => 'Grace', 'position' => 'Engineer'],
    ['id' => 2, 'name' => 'Heidi', 'position' => 'Manager'],
];
// 存在しない 'salary' キーを指定している
$result = array_column($data, 'salary');
// 結果の出力
print_r($result);
?>