Зазначення використовуючи 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) "hello"
  [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. До 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, і новим ключем буде це максимальне значення плюс 1 (але принаймні 0). Якщо цілочисельних індексів 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.

Why is $foo[bar] wrong?

Always use quotes around a string literal array index. For example, $foo['bar'] is correct, while $foo[bar] is not. But why? It is common to encounter this kind of syntax in old scripts:

This is wrong, but it works. The reason is that this code has an undefined constant (bar) rather than a string ('bar' - notice the quotes). It works because PHP automatically converts a bare string (an unquoted string which does not correspond to any known symbol) into a string which contains the bare string. For instance, if there is no defined constant named bar, then PHP will substitute in the string 'bar' and use that.

Зауваження: This does not mean to always quote the key. Do not quote keys which are constants or variables, as this will prevent PHP from interpreting them.

<?php
error_reporting(E_ALL);
ini_set('display_errors', true);
ini_set('html_errors', false);
// Simple array:
$array = array(1, 2);
$count = count($array);
for ($i = 0; $i < $count; $i++) {
echo "\nChecking $i: \n";
echo "Bad: " . $array['$i'] . "\n";
echo "Good: " . $array[$i] . "\n";
echo "Bad: {$array['$i']}\n";
echo "Good: {$array[$i]}\n";
}
?>

Поданий вище приклад виведе:

Checking 0: 
Notice: Undefined index:  $i in /path/to/script.html on line 9
Bad: 
Good: 1
Notice: Undefined index:  $i in /path/to/script.html on line 11
Bad: 
Good: 1

Checking 1: 
Notice: Undefined index:  $i in /path/to/script.html on line 9
Bad: 
Good: 2
Notice: Undefined index:  $i in /path/to/script.html on line 11
Bad: 
Good: 2

More examples to demonstrate this behaviour:

When error_reporting is set to show E_NOTICE level errors (by setting it to E_ALL, for example), such uses will become immediately visible. By default, error_reporting is set not to show notices.

As stated in the syntax section, what's inside the square brackets ('[' and ']') must be an expression. This means that code like this works:

This is an example of using a function return value as the array index. PHP also knows about constants:

Note that E_ERROR is also a valid identifier, just like bar in the first example. But the last example is in fact the same as writing:

because E_ERROR equals 1, etc.