Список функций для работы с массивами доступен в главе документации «Функции для работы с массивами». Массив в PHP — упорядоченная структура данных, которая связывает значения и ключи. Этот тип данных оптимизирован для разных целей, поэтому с ним работают как с массивом, списком (вектором), хеш-таблицей (реализацией карты), словарём, коллекцией, стеком, очередью и, возможно, чем-то ещё. Поскольку значениями массива бывают другие массивы, также доступны деревья и многомерные массивы. Объяснение структур данных выходит за рамки руководства, но как минимум один пример приводится для каждой из них. За дополнительной информацией обращаются к большому объему литературы по этой обширной теме. Массив (array) создают языковой конструкцией array. Конструкция принимает как аргументы произвольное количество разделённых запятыми пар ключ => значение. array( key => value, key2 => value2, key3 => value3, ... ) Запятая после последнего элемента массива необязательна; пропуск конечной запятой не вызывает ошибок. Конечную запятую часто опускают в определениях однострочных массивов, — лучше предпочесть array(1, 2) вместо array(1, 2, ). Для многострочных массивов, наоборот, часто указывают конечную запятую, поскольку это упрощает добавление новых элементов в конец массива. PHP поддерживает короткий синтаксис массива, который заменяет языковую конструкцию array() выражением []. "bar", "bar" => "foo", ); // Работа с коротким синтаксисом массива $array2 = [ "foo" => "bar", "bar" => "foo", ]; var_dump($array1, $array2); ]]> В PHP массивы поддерживают только целочисленные (int) и строковые (string) ключи. Тип значений не ограничивается. Дополнительно выполняются следующие преобразования ключа: Строки (string), которые содержат целое число (int), преобразуются в значение int, если только перед числом не указали знак +. Например, ключ со значением "8" сохранится со значением 8. При этом значение "08" не преобразуется, поскольку не относится к корректным десятичным целым. Числа с плавающей точкой (float) также преобразуются в целочисленные значения int — дробная часть отбрасывается. Например, ключ со значением 8.7 сохранится как 8. Значения с типом bool также преобразуются в целочисленный тип int. Например, ключ со значением &true; сохранится как 1, а ключ со значением &false; — как 0. Тип null преобразуется в пустую строку. Например, ключ со значением null сохранится как "". Массивы (array) и объекты (object) нельзя указывать как ключи. Это сгенерирует предупреждение: Illegal offset type. PHP перезаписывает значение элемента, если встречает в объявлении массива повтор одного и того же ключа, поэтому в массиве остается только последний такой элемент. "a", "1" => "b", 1.5 => "c", true => "d", ); var_dump($array); ]]> &example.outputs; string(1) "d" } ]]> Поскольку каждый ключ в этом примере приводится к 1, значение перезаписывается на каждом новом элементе, и останется единственное значение "d", которое присвоилось последним. PHP разрешает массивам содержать одновременно целочисленные (int) и строковые (string) ключи, поскольку PHP одинаково воспринимает индексные и ассоциативные массивы. "bar", "bar" => "foo", 100 => -100, -100 => 100, ); var_dump($array); ]]> &example.outputs; string(3) "bar" ["bar"]=> string(3) "foo" [100]=> int(-100) [-100]=> int(100) } ]]> Ключ необязателен: ключом нового элемента, для которого не указали ключ, станет увеличенный на единицу предыдущий наибольший целочисленный (int) ключ. &example.outputs; string(3) "foo" [1]=> string(3) "bar" [2]=> string(5) "hallo" [3]=> string(5) "world" } ]]> Разрешено указывать ключ одним элементам и пропускать для других: "c", "d", ); var_dump($array); ]]> &example.outputs; string(1) "a" [1]=> string(1) "b" [6]=> string(1) "c" [7]=> string(1) "d" } ]]> Видно, что последнее значение "d" присвоилось ключу 7. Это произошло потому, что перед этим самым большим значением целочисленного ключа было 6. Приведённый пример показывает все приведения типов ключей и перезаписи элементов. 'a', '1' => 'b', // Значение "b" перезапишет значение "a" 1.5 => 'c', // Значение "c" перезапишет значение "b" -1 => 'd', '01' => 'e', // Строка НЕ перезапишет ключ 1, поскольку она не целочисленная '1.5' => 'f', // Строка НЕ перезапишет ключ 1, поскольку она не целочисленная true => 'g', // Значение "g" перезапишет значение "c" false => 'h', '' => 'i', null => 'j', // Значение "j" перезапишет значение "i" 'k', // Значение "k" присваивается ключу 2, потому что самый большой целочисленный ключ до этого был 1 2 => 'l', // Значение "l" перезапишет значение "k" ); var_dump($array); ]]> &example.outputs; string(1) "g" [-1]=> string(1) "d" ["01"]=> string(1) "e" ["1.5"]=> string(1) "f" [0]=> string(1) "h" [""]=> string(1) "j" [2]=> string(1) "l" } ]]> При назначении отрицательного целочисленного ключа n, PHP позаботится о том, чтобы назначить следующий ключ n + 1. &example.outputs; int(1) [-4]=> int(2) } ]]> До PHP 8.3.0 назначение отрицательного целочисленного ключа n присвоило бы следующему ключу значение 0, поэтому приведённый пример вывел бы: int(1) [0]=> int(2) } ]]> Доступ к элементам массива получают синтаксисом array[key]. "bar", 42 => 24, "multi" => array( "dimensional" => array( "array" => "foo" ) ) ); var_dump($array["foo"]); var_dump($array[42]); var_dump($array["multi"]["dimensional"]["array"]); ]]> &example.outputs; До PHP 8.0.0 квадратные и фигурные скобки могли взаимозаменяться при доступе к элементам массива (например, в приведённом примере $array[42] и $array{42} делали одно и то же). Синтаксис фигурных скобок устарел с PHP 7.4.0 и больше не поддерживается с PHP 8.0.0. Попытка доступа к неопределённому ключу в массиве — то же, что и попытка доступа к неопределённой переменной: выдаётся ошибка уровня E_WARNING или до PHP 8.0.0 ошибка уровня E_NOTICE, и результат равняется &null;. Попытка разыменовать не массив, а скалярное значение, которое отличается от строки (string), отдаст &null;, тогда как разыменование значения string трактует строку как индексный массив. При такой попытке до PHP 7.4.0 не выдавалось сообщение об ошибке. С PHP 7.4.0 выдаётся ошибка уровня E_NOTICE; с PHP 8.0.0 выдаётся ошибка уровня E_WARNING. Массив возможно изменить путём явной установки значений. Присваивание через ключ в квадратных скобках установит значение массива (array), а пара пустых скобок [] добавит новое значение. $arr[key] = value; $arr[] = value; // В ключе key указывают только значения типов int или string, // а в элементе value — значения произвольного типа PHP создаст новый массив, если переменную $arr ещё не определили или присвоили переменной значение &null; или &false;, так что это альтернативный способ создать массив array. Однако создавать массив такими способом не рекомендуют, поскольку если переменная $arr уже содержит значение наподобие string-переменной сетевого запроса, это значение или не изменится и вызовет ошибку, или инструкция [] интерпретируется как оператор доступа к символу в строке. Лучше инициализировать переменную прямым присваиванием. Начиная с PHP 7.1.0 оператор пустого индекса на строке выбросит фатальную ошибку. Раньше строка молча преобразовывалась в массив. С PHP 8.1.0 способ, которым создавали новый массив приведением к нему значения &false;, устарел. Способ, которым создают новый массив приведением к нему значения &null; и неопределённого значения, по-прежнему доступен. Для изменения конкретного значения указывают ключ элемента и присваивают новое значение. Пару «ключ — значение» удаляют языковой конструкцией unset. 1, 12 => 2); $arr[] = 56; // В этом месте скрипта такое аналогично // присваиванию $arr[13] = 56; $arr["x"] = 42; // Добавление в массив нового // элемента с ключом "x" unset($arr[5]); // Удаление элемента из массива var_dump($arr); unset($arr); // Конструкция удаляет весь массив var_dump($arr); ]]> Как уже отмечалось, при добавлении в массив нового значения без указания ключа PHP присвоит новому элементу целочисленный ключ на 1 больше текущего наибольшего целочисленного (int) индекса, но не меньше 0. В массиве без целочисленных (int) индексов новому элементу присваивается ключ 0 — ноль. При работе с массивами учитывают, что наибольший целочисленный ключ, на основе которого вычисляется новый ключ, не обязательно содержится в массиве в текущий момент. PHP вычислит новый ключ на основе наибольшего целочисленного ключа, который появлялся в массиве с момента последней переиндексации. Следующий пример это иллюстрирует: $value) { unset($array[$i]); } print_r($array); // Добавляем элемент (обратите внимание, что новым ключом станет 5, а не 0). $array[] = 6; print_r($array); // Переиндексация: $array = array_values($array); $array[] = 7; print_r($array); ]]> &example.outputs; 1 [1] => 2 [2] => 3 [3] => 4 [4] => 5 ) Array ( ) Array ( [5] => 6 ) Array ( [0] => 6 [1] => 7 ) ]]> Массивы деструктурируют языковыми конструкциями [] (начиная с PHP 7.1.0) или list. Эти языковые конструкции разрешено использовать для деструктуризации массива на отдельные переменные. Деструктуризацию массива также выполняют в конструкции &foreach; для деструктуризации многомерного массива во время итерации по массиву. Деструктуризация проигнорирует элементы массива, для которых не указали переменную. Деструктуризация массива начинается с индекса 0. Начиная с PHP 7.1.0 поддерживается деструктуризация ассоциативных массивов. Это упрощает выбор элемента в массивах с числовым индексом, поскольку разрешает явно указать индекс. 1, 'bar' => 2, 'baz' => 3]; // Присваивание элемента с индексом 'baz' переменной $three ['baz' => $three] = $source_array; echo $three, PHP_EOL; // Выведет 3 $source_array = ['foo', 'bar', 'baz']; // Присваивание элемента с индексом 2 переменной $baz [2 => $baz] = $source_array; echo $baz, PHP_EOL; // Выведет "baz" ]]> Массив деструктурируют, чтобы поменять две переменные местами. Оператор ... не поддерживается в присваиваниях. Попытка получить доступ к неопределённому ключу массива аналогична обращению к любой другой неопределённой переменной: выдаётся сообщение об ошибке уровня E_WARNING, или ошибки уровня E_NOTICE до PHP 8.0.0, а результатом становится значение &null;. Деструктуризация скалярного значения присваивает значение &null; каждой переменной в левой части выражения присваивания. Для работы с массивами есть довольного много полезных функций. Подробнее об этом рассказано в разделе «Функции для работы с массивами». Языковая конструкция unset умеет удалять ключи массива. Обратите внимание, что массив НЕ переиндексируется. Массив переиндексируют функцией array_values, если требуется поведение в стиле «удалить и сдвинуть». 'один', 2 => 'два', 3 => 'три'); /* Удаление элемента изменит массив так, как если бы его определили так: $a = array(1 => 'один', 3 => 'три'); но НЕ так: $a = array(1 => 'один', 2 => 'три'); */ unset($a[2]); var_dump($a); $b = array_values($a); // Теперь переменная $b содержит array(0 => 'один', 1 => 'три') var_dump($b); ]]> Управляющая конструкция &foreach; появилась в языке для перебора массивов. Конструкция предлагает простой способ обхода массива. Строковый литерал в индексе ассоциативного массива лучше брать в кавычки. Например, правильно писать $foo['bar'], а не $foo[bar]. Но почему? С старых скриптах часто встречается следующий синтаксис: Неправильно записывать ключ без кавычек, хотя такой код и работает. Причина заключается в интерпретации незакавыченного ключа как неопределённой константы bar, а не строки 'bar' — литерала в кавычках. Код работает из-за автоматического преобразования «голой строки» — строки без кавычек, которая не соответствует ни одному известному символу, — в строку со значением такой «голой строки». PHP подставит вместо bar строку 'bar', если в текущей области видимости недоступна константа с названием bar. Резервный вариант для обработки неопределённой константы как пустой строки выдаёт ошибку уровня E_NOTICE. Начиная с PHP 7.2.0 поведение объявлено устаревшим и выдаёт ошибку уровня E_WARNING. Начиная с PHP 8.0.0 удалено и выбрасывает исключение Error. Это не значит, что в кавычки заключают каждый ключ. В кавычки не берут константы и переменные, поскольку закавычивание помешает интерпретации. &example.outputs; Дополнительные примеры, которые подтверждают этот факт: 'apple', 'veggie' => 'carrot'); // Верно echo $arr['fruit'], PHP_EOL; // apple echo $arr['veggie'], PHP_EOL; // carrot // Неверно. Это не работает и выбрасывает PHP-ошибку Error из-за неопределённой константы // с названием fruit // // Error: Undefined constant "fruit" try { echo $arr[fruit]; } catch (Error $e) { echo get_class($e), ': ', $e->getMessage(), PHP_EOL; } // Определим константу и посмотрим, // как изменится поведение кода. Присвоим константе с названием fruit значение "veggie". define('fruit', 'veggie'); // Теперь обратите внимание на разницу echo $arr['fruit'], PHP_EOL; // apple echo $arr[fruit], PHP_EOL; // carrot // Доступ по ключу без кавычек сработает внутри строки. PHP не ищет константы внутри строк, // поэтому ошибка здесь не возникнет echo "Hello $arr[fruit]", PHP_EOL; // Hello apple // За одним исключением: PHP интерпретирует константы, // если обращение к массиву внутри строки обернули фигурными скобками echo "Hello {$arr[fruit]}", PHP_EOL; // Hello carrot echo "Hello {$arr['fruit']}", PHP_EOL; // Hello apple // Ещё один способ вывести значение массива — конкатенация echo "Hello " . $arr['fruit'], PHP_EOL; // Hello apple ]]> Как указывает раздел о синтаксисе, внутри квадратных скобок '[' и ']' требуется указывать выражение. Поэтому следующий код работает: Это пример работы с возвращаемым функцией значением в качестве индекса массива. PHP также знает о константах: Обратите внимание, что E_ERROR — это такой же допустимый идентификатор, как и bar в первом примере. Но последний пример по существу эквивалентен такой записи: поскольку значение константы E_ERROR соответствует значению 1 и т. д. Когда-нибудь в будущем команда разработчиков PHP, возможно, захочет добавить ещё одну константу или ключевое слово, либо константа из другого кода может вмешаться. Например, неправильно использовать слова empty и default, поскольку они относятся к зарезервированным ключевым словам. Повторим, внутри строки (string) в двойных кавычках допустимо не окружать индексы массива кавычками, поэтому "$foo[bar]" — допустимая запись. В примерах выше объяснено, почему, дополнительная информация дана в разделе об обработке переменных в строках. Преобразование целого числа (int), числа с плавающей точкой (float), строки (string), логического значения (bool) или ресурса (resource) в массив — создаёт массив с одним элементом с индексом 0 и значением скаляра, который был преобразован. Говоря по-другому, выражение (array) $scalarValue аналогично выражению array($scalarValue). При преобразовании объекта (object) в массив элементами массива становятся свойства (переменные-члены) этого объекта. Ключами становятся имена переменных-членов, со следующими примечательными исключениями: целочисленные свойства становятся недоступными; к закрытым полям класса (private) в начало дописывается название класса; к защищённым полям класса (protected) в начало добавляется символ '*'. Эти добавленные с обоих сторон значения также получат NUL-байты. Неинициализированные типизированные свойства автоматически отбрасываются. {1} = null; } } var_export((array) new A()); ]]> &example.outputs; NULL, '' . "\0" . '*' . "\0" . 'C' => NULL, 'D' => NULL, 1 => NULL, ) ]]> Это может вызвать несколько неожиданное поведение: &example.outputs; NULL ["AA"]=> NULL ["AA"]=> NULL } ]]> Приведённый код покажет 2 ключа с названием 'AA', хотя один ключ на самом деле называется '\0A\0A'. Получится пустой массив, если преобразовать в массив значение &null;. Массивы сравнивают функцией array_diff и операторами массивов. Массив, перед которым указали оператор ..., распакуется на месте при определении нового массива. Распаковка доступна только массивам и объектам, которые реализуют интерфейс Traversable. Распаковка массива spread-оператором ... доступна с PHP 7.4.0. PHP поддерживает многократное чередование распаковки и стандартных элементов до или после оператора ...: 'd']; // ['a', 'b', 'c' => 'd']; var_dump($arr1, $arr2, $arr3, $arr4, $arr5, $arr6); ]]> Распаковка массива оператором ... соблюдает семантику функции array_merge, поэтому более поздние строковые ключи перезаписывают более ранние, а целочисленные ключи перенумеровываются: 1]; $arr2 = ["a" => 2]; $arr3 = ["a" => 0, ...$arr1, ...$arr2]; var_dump($arr3); // ["a" => 2] // Целочисленный ключ $arr4 = [1, 2, 3]; $arr5 = [4, 5, 6]; $arr6 = [...$arr4, ...$arr5]; var_dump($arr6); // [1, 2, 3, 4, 5, 6] // Распаковка массивов создаёт массив [0 => 1, 1 => 2, 2 => 3, 3 => 4, 4 => 5, 5 => 6], // в котором исходные целочисленные ключи не сохраняются ]]> Ключи, которые не принадлежат ни целочисленному, ни строковому типу, выбрасывают ошибку TypeError. Такие ключи генерируют только объекты, класс которых реализует интерфейс Traversable. До PHP 8.1 распаковка массива со строковым ключом не поддерживалась: 4]; $arr3 = [...$arr1, ...$arr2]; // Fatal error: Uncaught Error: Cannot unpack array with string keys in example.php:5 $arr4 = [1, 2, 3]; $arr5 = [4, 5]; $arr6 = [...$arr4, ...$arr5]; // Работает: [1, 2, 3, 4, 5] ]]> Массив в PHP — гибкий тип данных. Вот несколько примеров: 'красный', 'taste' => 'сладкий', 'shape' => 'круг', 'name' => 'яблоко', 4 // PHP назначит элементу ключ 0 ); $b = array('a', 'b', 'c'); var_dump($a, $b); // ...эквивалентен следующему коду: $a = array(); $a['color'] = 'красный'; $a['taste'] = 'сладкий'; $a['shape'] = 'круг'; $a['name'] = 'яблоко'; $a[] = 4; // ключом станет 0 $b = array(); $b[] = 'a'; $b[] = 'b'; $b[] = 'c'; // После выполнения приведённого кода переменная $a станет массивом // array('color' => 'красный', 'taste' => 'сладкий', 'shape' => 'круг', // 'name' => 'яблоко', 0 => 4), а переменная $b станет массивом // array(0 => 'a', 1 => 'b', 2 => 'c'), или просто array('a', 'b', 'c') var_dump($a, $b); ]]> 4, 'OS' => 'Linux', 'lang' => 'english', 'short_tags' => true ); var_dump($map); // Строго числовые ключи, // что эквивалентно массиву array(0 => 7, 1 => 8, ...) $array = array( 7, 8, 0, 156, -10 ); var_dump($array); $switching = array( 10, // ключ = 0 5 => 6, 3 => 7, 'a' => 4, 11, // ключ = 6 (максимальным числовым индексом было 5) '8' => 2, // ключ = 8 (число!) '02' => 77, // ключ = '02' 0 => 12 // значение 10 перезапишется значением 12 ); var_dump($switching); // пустой массив $empty = array(); var_dump($empty); ]]> &example.outputs; Непосредственное изменение значений массива допустимо через передачу значений по ссылке. &example.outputs; КРАСНЫЙ [1] => ГОЛУБОЙ [2] => ЗЕЛЁНЫЙ [3] => ЖЁЛТЫЙ ) ]]> Следующий пример создаёт массив, индексация которого начинается с единицы. 'январь', 'февраль', 'март'); print_r($firstquarter); ]]> &example.outputs; 'январь' [2] => 'февраль' [3] => 'март' ) ]]> Массивы упорядочены. Порядок изменяют разными функциями сортировки. Подробнее об этом рассказано в разделе «Функции для работы с массивами». Для подсчёта количества элементов в массиве вызывают функцию count. Массивы поддерживают значения в виде других массивов, поскольку массивы принимают произвольные значения. Поэтому PHP разрешает создавать рекурсивные и многомерные массивы. array ( "a" => "апельсин", "b" => "банан", "c" => "яблоко" ), "numbers" => array ( 1, 2, 3, 4, 5, 6 ), "holes" => array ( "первая", 5 => "вторая", "третья" ) ); var_dump($fruits); // Ряд примеров доступа к значениям предыдущего массива echo $fruits["holes"][5]; // Выведет "вторая" echo $fruits["fruits"]["a"]; // напечатает "апельсин" unset($fruits["holes"][0]); // удалит "первая" // Создаст новый многомерный массив $juices["apple"]["green"] = "хороший"; var_dump($juices); ]]> Присваивание массива включает копирование значения. Чтобы скопировать массив по ссылке, указывают оператор присваивания по ссылке.