(PHP 4, PHP 5)
array — Създава масив
Създава масив. За повече информация относно това, какво представляват масивите вижте раздела Масиви.
Синтаксисът "индекс => стойности", разделени със запетаи, дефинират индекса и стойностите. Индексите могат да бъдат от низов или от целочислен тип. Когато индексът не се укаже, автоматично бива генериран целочислен индекс, като се започне от 0. Ако индексът е целочислен, следващият генериран индекс ще бъде предишната най-голяма стойност + 1. Забележете, че ако са дефинирани два еднакви индекса, вторият ще препокрие първия.
Връща масив от параметрите. На параметрите може да се зададе индекс посредством оператора =>. Вижте раздела за типа масив за повече информация относно масивите.
Наличието на запетая след последния дефиниран елемент на масива е нещо необичайно, но валидно като синтаксис.
Примерът по-долу показва как да се създава двумерен масив, как да се укажат ключовете за асоциативни масиви и как да се прекъснат-и-продължат цифровите индекси в обикновените масиви.
Example #1 Пример за array()
<?php
$fruits = array (
"fruits" => array("a" => "orange", "b" => "banana", "c" => "apple"),
"numbers" => array(1, 2, 3, 4, 5, 6),
"holes" => array("first", 5 => "second", "third")
);
?>
Example #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.
Example #3 Индекс базиран на 1 с array()
<?php
$firstquarter = array(1 => 'Януари', 'Февруари', 'Март');
print_r($firstquarter);
?>
Примерът по-горе ще изведе:
Array ( [1] => Януари [2] => Февруари [3] => Март )
Както в Perl, така и тук може да се осъществи достъп до стойност на масива в двойни кавички. Все пак в PHP ще трябва да оградите масива с фигурни скоби.
Example #4 Осъществяване на достъп до масив в двойни кавички
<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>
Забележка: array() не е обикновена функция, а езикова конструкция, която се използва за представяне на масиви.