Определение массива через языковую конструкцию array()

Массив (array) создают языковой конструкцией array(). Конструкция принимает как аргументы произвольное количество разделённых запятыми пар ключ => значение.

array(
    key  => value,
    key2 => value2,
    key3 => value3,
    ...
)

Запятая после последнего элемента массива необязательна; пропуск конечной запятой не вызывает ошибок. Конечную запятую часто опускают в определениях однострочных массивов, — лучше предпочесть array(1, 2) вместо array(1, 2, ). Для многострочных массивов, наоборот, часто указывают конечную запятую, поскольку это упрощает добавление новых элементов в конец массива.

Замечание:

PHP поддерживает короткий синтаксис массива, который заменяет языковую конструкцию array() выражением [].

В 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 перезаписывает значение элемента, если встречает в объявлении массива повтор одного и того же ключа, поэтому в массиве остается только последний такой элемент.

array(1) {
  [1]=>
  string(1) "d"
}

PHP разрешает массивам содержать одновременно целочисленные (int) и строковые (string) ключи, поскольку PHP одинаково воспринимает индексные и ассоциативные массивы.

array(4) {
  ["foo"]=>
  string(3) "bar"
  ["bar"]=>
  string(3) "foo"
  [100]=>
  int(-100)
  [-100]=>
  int(100)
}

Ключ необязателен: ключом нового элемента, для которого не указали ключ, станет увеличенный на единицу предыдущий наибольший целочисленный (int) ключ.

array(4) {
  [0]=>
  string(3) "foo"
  [1]=>
  string(3) "bar"
  [2]=>
  string(5) "hallo"
  [3]=>
  string(5) "world"
}

Разрешено указывать ключ одним элементам и пропускать для других:

array(4) {
  [0]=>
  string(1) "a"
  [1]=>
  string(1) "b"
  [6]=>
  string(1) "c"
  [7]=>
  string(1) "d"
}

array(7) {
  [1]=>
  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"
}

array(2) {
  [-5]=>
  int(1)
  [-4]=>
  int(2)
}

array(2) {
  [-5]=>
  int(1)
  [0]=>
  int(2)
}

Доступ к элементам массива через синтаксис квадратных скобок

Доступ к элементам массива получают синтаксисом array[key].

string(3) "bar"
int(24)
string(3) "foo"

Замечание:

До 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. Если в массиве нет положительных целочисленных индексов, ключом станет 0. Начиная с PHP 8.3.0 это также может быть отрицательное целое число.

При работе с массивами учитывают, что наибольший целочисленный ключ, на основе которого вычисляется новый ключ, не обязательно содержится в массиве в текущий момент. PHP вычислит новый ключ на основе наибольшего целочисленного ключа, который появлялся в массиве с момента последней переиндексации. Следующий пример это иллюстрирует:

<?php

// Создаём простой массив.
$array = array(1, 2, 3, 4, 5);
print_r($array);

// Теперь удаляем каждый элемент, но массив оставляем нетронутым:
foreach ($array as $i => $value) {
unset($array[$i]);
}
print_r($array);

// Добавляем элемент (обратите внимание, что новым ключом станет 5, а не 0).
$array[] = 6;
print_r($array);

// Переиндексация:
$array = array_values($array);
$array[] = 7;
print_r($array);

Результат выполнения приведённого примера:

Array
(
    [0] => 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 поддерживается деструктуризация ассоциативных массивов. Это упрощает выбор элемента в массивах с числовым индексом, поскольку разрешает явно указать индекс.

Массив деструктурируют, чтобы поменять две переменные местами.

Замечание:

Оператор ... не поддерживается в присваиваниях.

Замечание:

Попытка получить доступ к неопределённому ключу массива аналогична обращению к любой другой неопределённой переменной: выдаётся сообщение об ошибке уровня E_WARNING, или ошибки уровня E_NOTICE до PHP 8.0.0, а результатом становится значение null.

Замечание:

Деструктуризация скалярного значения присваивает значение null каждой переменной в левой части выражения присваивания.

Почему выражение $foo[bar] неверно?

Строковый литерал в индексе ассоциативного массива лучше брать в кавычки. Например, правильно писать $foo['bar'], а не $foo[bar]. Но почему? С старых скриптах часто встречается следующий синтаксис:

Неправильно записывать ключ без кавычек, хотя такой код и работает. Причина заключается в интерпретации незакавыченного ключа как неопределённой константы bar, а не строки 'bar' — литерала в кавычках. Код работает из-за автоматического преобразования «голой строки» — строки без кавычек, которая не соответствует ни одному известному символу, — в строку со значением такой «голой строки». PHP подставит вместо bar строку 'bar', если в текущей области видимости недоступна константа с названием bar.

Это не значит, что в кавычки заключают каждый ключ. В кавычки не берут константы и переменные, поскольку закавычивание помешает интерпретации.

Результат выполнения приведённого примера:

Проверяем 0:
Notice: Undefined index:  $i in /path/to/script.html on line 9
Плохо:
Хорошо: 1
Notice: Undefined index:  $i in /path/to/script.html on line 11
Плохо:
Хорошо: 1

Проверяем 1:
Notice: Undefined index:  $i in /path/to/script.html on line 9
Плохо:
Хорошо: 2
Notice: Undefined index:  $i in /path/to/script.html on line 11
Плохо:
Хорошо: 2

Дополнительные примеры, которые подтверждают этот факт:

Как указывает раздел о синтаксисе, внутри квадратных скобок '[' и ']' требуется указывать выражение. Поэтому следующий код работает:

Это пример работы с возвращаемым функцией значением в качестве индекса массива. PHP также знает о константах:

Обратите внимание, что E_ERROR — это такой же допустимый идентификатор, как и bar в первом примере. Но последний пример по существу эквивалентен такой записи:

поскольку значение константы E_ERROR соответствует значению 1 и т. д.