Массивы в 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() повторяет одно значение.

<?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, а если такого нет, PHP печатает Warning: Undefined array key -1. Используйте array_key_first() и array_key_last(), они работают и тогда, когда ключи начинаются не с 0.

<?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), чтобы превратить значения в одну строку для показа.
• 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", становится целым 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";