Определение при помощи array()

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

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

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

Замечание:

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

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

Дополнительно произойдут следующие преобразования ключа key:

• Строки (string), содержащие целое число (int) (исключая случаи, когда перед числом указывают знак +), будут преобразованы в целое число (int). Например, ключ со значением «8» сохранится со значением 8. При этом, значение «08» не преобразуется, так как оно — не корректное десятичное целое.
• Числа с плавающей точкой (float) также преобразуются в целочисленные значения (int) — дробная часть будет отброшена. Например, ключ со значением 8.7 будет сохранится со значением 8.
• Логический тип (bool) также преобразовывается в целочисленный тип (int). Например, ключ со значением true сохранится со значением 1, а ключ со значением false сохранится со значением 0.
• Тип null преобразуется в пустую строку. Например, ключ со значением null сохранится со значением "".
• Массивы (array) и объекты (object) нельзя указывать как ключи. Это сгенерирует предупреждение: Недопустимый тип смещения (Illegal offset type).

Если нескольким элементам в объявлении массива указан одинаковый ключ, то только последний будет сохранён, а другие будут перезаписаны.

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)
}

Ключ (key) — необязателен. Если он не указан, PHP инкрементирует предыдущее наибольшее целочисленное (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[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 (ошибка уровня E_NOTICE до PHP 8.0.0), и результат будет равен 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 может быть любым значением любого типа

Если массив $arr ещё не существует или для него задано значение null или false, он будет создан. Таким образом, это ещё один способ определить массив array. Однако такой способ применять не рекомендовано, так как если переменная $arr уже содержит значение (например, строку (string) из переменной запроса), то это значение останется на месте и выражение [] может означать доступ к символу в строке. Лучше инициализировать переменную явным присваиванием значения.

Замечание: Начиная с PHP 7.1.0 оператор пустого индекса на строке выбросит фатальную ошибку. Раньше строка молча преобразовывалась в массив.

Замечание: С PHP 8.1.0 способ, которым создавали новый массив приведением к нему значения false, устарел. Способ, которым создают новый массив приведением к нему значения null и неопределённого значения, по-прежнему доступен.

Для изменения конкретного значения элементу просто присваивают новое значение, указывая его ключ. Если нужно удалить пару ключ/значение, необходимо вызывать конструкцию unset().

Замечание:

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

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

<?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.

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

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

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

Замечание: Это не значит, что нужно всегда заключать ключ в кавычки. Не обязательно заключать в кавычки константы или переменные, поскольку это помешает PHP обрабатывать их.

<?php

error_reporting(E_ALL);
ini_set('display_errors', true);
ini_set('html_errors', false);

// Простой массив:
$array = array(1, 2);
$count = count($array);

for ($i = 0; $i < $count; $i++) {
echo "\nПроверяем $i: \n";
echo "Плохо: " . $array['$i'] . "\n";
echo "Хорошо: " . $array[$i] . "\n";
echo "Плохо: {$array['$i']}\n";
echo "Хорошо: {$array[$i]}\n";
}

?>

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

Проверяем 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

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

Если директива error_reporting настроена на режим отображения ошибок уровня E_NOTICE (например, E_ALL), ошибки сразу будут видны. По умолчанию директива error_reporting настроена на то, чтобы не показывать предупреждения.

Как указано в разделе о синтаксисе, внутри квадратных скобок («[» и «]») должно быть выражение. То есть вот такой код работает:

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

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

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