(PHP 4, PHP 5, PHP 7, PHP 8)
array — Создаёт массив
Создаёт массив. Подробнее о массивах рассказано в разделе «Массивы».
valuesСинтаксис — разделённые запятыми «индекс => значения», определяет индексы и значения. Индекс разрешено указывать строкой или целым числом. Если индекс не указан, будет автоматически сгенерирован целочисленный индекс начиная с 0. Если индекс — целое число, следующим сгенерированным индексом будет — наибольший целочисленный индекс + 1. Обратите внимание, что если определены два одинаковых индекса, следующий перезапишет предыдущий.
Замыкающая (висящая) запятая после последнего элемента массива хотя и необычна, но не нарушает синтаксиса.
Возвращает массив параметров. Задать параметрам индекс можно оператором =>. Подробнее о массивах рассказано в разделе «Массивы».
Следующие примеры показывают, как создавать двумерный массив, как определять ключи ассоциативных массивов и как пропустить и продолжить числовые индексы в обычных массивах, если нумерация начинается с произвольного числа.
Пример #1 Пример использования языковой конструкции array()
<?php
$fruits = array (
"fruits" => array("a" => "апельсин", "b" => "банан", "c" => "яблоко"),
"numbers" => array(1, 2, 3, 4, 5, 6),
"holes" => array("первый", 5 => "второй", "третий")
);
?>Пример #2 Автоматическая индексация при вызове конструкции array()
<?php
$array = array(1, 1, 1, 1, 1, 8 => 1, 4 => 1, 19, 3 => 13);
print_r($array);
?>Результат выполнения приведённого примера:
Array ( [0] => 1 [1] => 1 [2] => 1 [3] => 13 [4] => 1 [8] => 1 [9] => 19 )
Обратите внимание, что индекс «3» определён дважды, и содержит последнее значение — 13. Индекс 4 определён после индекса 8, а следующий сгенерированный индекс (значение 19) — 9, поскольку самым большим индексом был 8.
Этот пример создаёт массив, нумерация которого начинается с 1.
Пример #3 Пример создания конструкцией array() массива, нумерация которого начинается с 1
<?php
$firstquarter = array(1 => 'January', 'February', 'March');
print_r($firstquarter);
?>Результат выполнения приведённого примера:
Array ( [1] => January [2] => February [3] => March )
Как и в Perl, разработчику доступны значения массива внутри двойных кавычек. Однако в PHP нужно заключить массив в фигурные скобки.
Пример #4 Доступ к массиву внутри двойных кавычек
<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>Замечание:
array() — конструкция языка для представления литеральных массивов, а не обычная функция.