Низи

Специфицирање со array()

Еден array може да се креира со помош на array() конструкција на јазикот. Таа зема кој било број на одделени со запирка key => value парови како аргументи.

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

Запирката по последниот елемент на низата е опционална и може да се изостави. Ова обично се прави за низи во еден ред, т.е. array(1, 2) е претпочитано пред array(1, 2, ). За низи во повеќе редови, од друга страна, запирката на крајот обично се користи, бидејќи овозможува полесно додавање нови елементи на крајот.

Забелешка:

Постои кратка синтакса за низи што ја заменува array() with [].

На key може да биде int или stringќе треба да се прилагоди, и value може да биде од било кој тип.

Дополнително ќе се случат следните key кастирања:

• Низаите што содржат валиден децимален intи, освен ако бројот не му претходи + знак, ќе бидат кастирани во int тип. На пр. клучот "8" всушност ќе биде зачуван под 8. Од друга страна "08" нема да биде кастиран, бидејќи не е валиден децимален цел број.
• Пловечкии исто така се кастираат во intи, што значи дека децималниот дел ќе биде скратен. На пр. клучот 8.7 всушност ќе биде зачуван под 8.
• Буловскии се кастираат во intи исто така, т.е. клучот true всушност ќе биде зачуван под 1 и клучот false under 0.
• Види ќе бидат кастирани во празен стринг, т.е. клучот null всушност ќе биде зачуван под "".
• Низаи objects не може да се користи како клучеви. Правењето на ова ќе резултира со предупредување: Illegal offset type.

Ако повеќе елементи во декларацијата на низата користат ист клуч, само последниот ќе се користи бидејќи сите други се презапишани.

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

е единствената што останува. int and string PHP низите можат да содржат

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

На key Пример #3 Мешано int key.

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

Пример #4 Индексирани низи без клуч

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] syntax.

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

Забелешка:

Пред PHP 8.0.0, квадратни и кадрави загради можеа да се користат наизменично за пристап до елементите на низата (на пр. $array[42] and $array{42} би правеле исто во горниот пример). Синтаксата со кадрави загради беше отфрлена од PHP 7.4.0 и повеќе не се поддржува од PHP 8.0.0.

Забелешка:

Обидот за пристап до клучен елемент на низа што не е дефиниран е исто како пристап до која било друга недефинирана променлива: ќе се издаде порака за грешка од ниво E_WARNING-ниво (E_NOTICE-ниво пред PHP 8.0.0) ќе се издаде, и резултатот ќе биде null.

Забелешка:

Дереференцирање на скаларна вредност што не е string yields null. Пред PHP 7.4.0, ова не издаваше порака за грешка. Од PHP 7.4.0, ова издава E_NOTICE; од PHP 8.0.0, ова издава E_WARNING.

Креирање/модифицирање со синтаксија со квадратни загради

Постоечки array може да се модифицира со експлицитно поставување вредности во него.

Ова се прави со доделување вредности на array, наведувајќи го клучот во загради. Клучот исто така може да се изостави, што резултира со празен пар загради ([]).

$arr[key] = value;
$arr[] = value;
// key may be an int or string
// value may be any value of any type

Враќа $arr сè уште не постои или е поставен на null or false, ќе биде креиран, така што ова е исто така алтернативен начин за креирање на array. Оваа практика, сепак, се обесхрабрува бидејќи ако $arr веќе содржи некоја вредност (на пр. string од променлива за барање) тогаш оваа вредност ќе остане на место и [] може всушност да значи оператор за пристап до низа. Секогаш е подобро да се иницијализира променлива со директно доделување.

Забелешка: Од PHP 7.1.0, примена на операторот за празен индекс на низа фрла фатална грешка. Претходно, низата беше тивко претворена во низа.

Забелешка: Од PHP 8.1.0, креирање нова низа од false вредност е депресирана. Креирање нова низа од null и недефинирани вредности сè уште е дозволено.

За да промените одредена вредност, доделете нова вредност на тој елемент користејќи го неговиот клуч. За да отстраните пар клуч/вредност, повикајте го unset() функција на неа.

Забелешка:

Како што споменавме погоре, ако не е специфициран клуч, се зема максимумот од постоечките int индекси, а новиот клуч ќе биде тој максимум плус 1 (но најмалку 0). Ако нема int индекси постојат сè уште, клучот ќе биде 0 (нула).

Имајте предвид дека максималниот цел клуч што се користи за ова не мора моментално да постои во array. Мора да постоел само во array во одреден момент од последното време кога array беше повторно индексиран. Следниот пример илустрира:

<?php
// Create a simple array.
$array = array(1, 2, 3, 4, 5);
print_r($array);

// Now delete every item, but leave the array itself intact:
foreach ($array as $i => $value) {
unset($array[$i]);
}
print_r($array);

// Append an item (note that the new key is 5, instead of 0).
$array[] = 6;
print_r($array);

// Re-index:
$array = array_values($array);
$array[] = 7;
print_r($array);
?>

Пример #1 Пример што покажува затворачка ознака што го опфаќа последниот нов ред

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) наместо string ('bar' - забележете ги наводниците). Работи бидејќи PHP автоматски конвертира гол стринг (нецитиран string што не одговара на ниту еден познат симбол) во string што го содржи само string. На пример, ако не е дефинирана константа наречена bar, тогаш PHP ќе го замени со string 'bar' и ќе го користи тоа.

Ова не значи да always го цитирате клучот. Не ги цитирајте клучевите кои се constants or variables, бидејќи ова ќе го спречи PHP да ги толкува.

Пример #1 Пример што покажува затворачка ознака што го опфаќа последниот нов ред

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

Повеќе примери за да се демонстрира ова однесување:

Како што е наведено во syntax секцијата, она што е внатре во квадратните загради ('[' и ']') мора да биде израз. Ова значи дека кодот како овој работи:

Ова е пример за користење на вратена вредност од функција како индекс на низа. PHP исто така знае за константи:

Имајте предвид дека E_ERROR е исто така валиден идентификатор, исто како bar во првиот пример. Но, последниот пример е всушност исто како да напишете:

because E_ERROR equals 1Пример #2 Рестартирање на Apache откако ќе се инсталира PHP