PHP: Функции

Распаковка аргументов

Spread Operator в вызовах функций синтаксически идентичен Spread Operator в определениях, но выполняет обратное действие:

<?php

$arrayOfArrays = [
    [1, 2],
    [2, 3]
];

array_merge(...$arrayOfArrays);
# Array
# (
#     [0] => 1
#     [1] => 2
#     [2] => 2
#     [3] => 3
# )

Другими словами, Spread Operator раскладывает массив на аргументы. Количество аргументов, полученных Spread Operator, равно количеству элементов массива. По сути код выше преобразуется в вызов:

<?php

array_merge($arrayOfArrays[0], $arrayOfArrays[1]);
// array_merge([1, 2], [2, 3]);

Как и в случае с определением функций, Spread Operator может использоваться совместно с позиционными аргументами:

<?php

array_merge([3], ...$arrayOfArrays);
# Array
# (
#     [0] => 3
#     [1] => 1
#     [2] => 2
#     [3] => 2
#     [4] => 3
# )

То же самое справедливо и для большего количества аргументов:

<?php

$array = [3, 2];
array_merge([3], $array, ...$arrayOfArrays);
# Array
# (
#     [0] => 3
#     [1] => 3
#     [2] => 2
#     [3] => 1
#     [4] => 2
#     [5] => 2
#     [6] => 3
# )

И точно так же должен всегда оказываться последним аргументом.

<?php

array_merge(...$arrayOfArrays, [3, 2]);
// Fatal error: Cannot use positional argument after argument unpacking

В PHP Spread Operator применяется не каждый день, но иногда бывает нужен, если аргументы оказываются записаны в массив.

---