PHPの配列：作成・取得・ループ・出力の基本

PHPの配列は、値のリストをキーの下に格納します。角括弧で作り（$fruits = ['apple', 'banana', 'cherry'];）、要素は添字で読みます（$fruits[0]）。添字は0から始まり、count($fruits)で要素数がわかります。

<?php
$fruits = ['apple', 'banana', 'cherry'];

echo $fruits[0], "\n";        // first element
echo $fruits[2], "\n";        // third element
echo count($fruits), "\n";    // number of elements

$fruits[] = 'date';           // add to the end
$fruits[1] = 'blueberry';     // change an element

print_r($fruits);

PHPの配列はすべて順序付きのマップで、各値はキーの下にあります。キーを選ばなければPHPが0, 1, 2...と番号を振り、インデックス配列になります。自分でキーを選べば（['name' => 'Ada']）、連想配列になります。どちらも同じarray型です。

配列を作る

ふつうは角括弧の構文を使います。array()は古い書き方で、まったく同じものを作ります。range()は数字や文字のリストを作り、array_fill()は1つの値を繰り返します。

<?php
$empty   = [];
$numbers = [10, 20, 30];
$old     = array('a', 'b', 'c');      // same as ['a', 'b', 'c']
$mixed   = [1, 'two', 3.5, true, null];

$oneToFive = range(1, 5);
$letters   = range('a', 'e');
$zeros     = array_fill(0, 3, 0);

echo implode(', ', $oneToFive), "\n";
echo implode(', ', $letters), "\n";
echo implode(', ', $zeros), "\n";
var_dump($empty === []);
echo count($mixed), "\n";

PHPの配列は、ほかの配列も含め、異なる型の値を同時に持てます。配列の配列は多次元配列で、データの行を持つときの定番の方法です。

最初と最後の要素を取得する

PHPには負の添字がありません。$arr[-1]は「最後の要素」という意味ではなく、-1という名前のキーを探し、それがなければWarning: Undefined array key -1を表示します。キーが0から始まらない場合にも使えるarray_key_first()とarray_key_last()を使いましょう。

<?php
$queue = ['Ada', 'Grace', 'Linus', 'Margaret'];

$first = $queue[array_key_first($queue)];
$last  = $queue[array_key_last($queue)];
echo "First: $first, last: $last\n";

// Same result by position
echo $queue[count($queue) - 1], "\n";

// The last two elements
print_r(array_slice($queue, -2));

end($queue)も最後の値を返しますが、副作用として配列の内部ポインターを動かすので、キーを使う方法のほうがわかりやすい選択です。

配列を出力する

echo $arrは動きません。Arrayという単語と警告を表示します。目的に合った出力方法を選びましょう。

• print_r($arr)：デバッグ中に読みやすく表示する。
• var_dump($arr)：各値の型と長さも見る。
• implode(', ', $arr)：表示用に値を1つの文字列にする。
• json_encode($arr)：配列をJavaScriptやAPIに送る。

<?php
$scores = [90, 72, 85];

print_r($scores);
var_dump($scores);
echo implode(', ', $scores), "\n";
echo json_encode($scores), "\n";

HTMLの中で配列を出力する方法を含む書式のオプションは、print_rとvar_dumpのページで扱っています。

配列をループする

foreachは配列のために作られたループで、各値を、求めればキーも渡してくれます。添字を使うforループも、キーが0から欠番なく続くインデックス配列なら使えます。

<?php
$languages = ['PHP', 'Python', 'Go'];

foreach ($languages as $language) {
    echo "I know $language\n";
}

foreach ($languages as $i => $language) {
    echo ($i + 1) . ". $language\n";
}

for ($i = 0; $i < count($languages); $i++) {
    echo strtolower($languages[$i]), "\n";
}

配列は共有されずにコピーされる

配列を別の変数に代入したり、関数に渡したりするとコピーが渡されます。コピーを変えても元の配列はそのままです。関数で呼び出し元の配列を変えたいときは、引数に&を付けます。

<?php
$a = [1, 2, 3];
$b = $a;          // a copy
$b[] = 4;

echo count($a), " ", count($b), "\n";

function addItem(array &$list, string $item): void
{
    $list[] = $item;
}

$cart = ['milk'];
addItem($cart, 'bread');
print_r($cart);

目的別の配列関数

PHPには70以上の配列関数があります。よく使うのは次のもので、それぞれに専用のページがあります。

黙ってまとめられてしまうキー

配列のキーは整数か文字列で、PHPは一部のキーを自動で変換します。"1"のように整数の10進表記に見える文字列は整数の1になるので、$a["1"]と$a[1]は同じ場所です。"01"と"1.5"は文字列のままです。フォームの入力やCSVから作った配列の要素数が予想より少なくなることがあるのは、このためです。

<?php
$a = [];
$a[1]    = 'int one';
$a["1"]  = 'string one';   // same key as 1, overwrites it
$a["01"] = 'zero one';     // stays the string "01"

var_dump($a);
echo count($a), "\n";