Функциональный оператор

PHP версии 8.5 и новее поддерживает один оператор, который работает с callable-выражениями. Оператор |>, или оператор конвейеризации, принимает в правой части callable-выражение с единственным параметром, передаёт в него значение левой части и возвращает результат вычисления вызываемого выражения. В правой части оператор принимает допустимое в PHP callable-выражение: объект класса Closure, callable-выражение как объект первого класса, объект, класс которого реализует метод __invoke(), и другие вызываемые значения.

Каждые две следующие строки эквивалентны.

21
21

Конвейерный оператор с единственным вызовом бесполезен, но принесёт пользу при множественных вызовах, которые объединяются в цепочку. Следующие два фрагмента кода эквивалентны:

Array
(
    [0] => P
    [1] => H
    [2] => P
    [3] =>
    [4] => R
    [6] => C
    [7] => K
    [8] => S
)
Array
(
    [0] => P
    [1] => H
    [2] => P
    [3] =>
    [4] => R
    [6] => C
    [7] => K
    [8] => S
)

В левой части оператор конвейера принимает произвольное значение или выражение, а в правой — допустимое в PHP callable-выражение, которое принимает только один аргумент. Функции с двумя или больше обязательными параметрами не сработают и вызовут ошибку, как при стандартном вызове с недостаточным количеством аргументов. В правой части оператора нельзя указывать функции, которые принимают переменную по ссылке. PHP выбросит ошибку Error, если в правую часть оператора передали значение, которое невозможно вызвать как функцию.

Замечание:

Стрелочные функции в правой части оператора конвейеризации ОБЯЗАТЕЛЬНО указывают в круглых скобках, чтобы избежать синтаксической двусмысленности, как в предыдущем примере. При нарушении требования PHP выдаст фатальную ошибку.