Мой Telegram-канал с материалами по PHP и архитектуре: https://t.me/berloga_aiti

В версии PHP 8.5 появился оператор |> — так называемый pipe operator. Он давно используется в других языках (F#, Elixir, OCaml) и активно применяется в JavaScript. Его основная цель — упростить передачу результата одной операции в следующую, делая код более читаемым и линейным.

В этой статье рассмотрим историю появления оператора, его устройство, корректные способы использования, типичные ошибки и рекомендации.

Историческая справка

Идея оператора «передай дальше» появилась в функциональных языках ещё в 1990-х. Например, в F# оператор |> стал одним из ключевых механизмов функционального стиля. Позднее схожий подход начали применять в JavaScript.

Для PHP обсуждение pipe-оператора началось в 2021 году. Первые RFC предлагали реализацию, аналогичную JavaScript:

value |> fn($x) => ...

Однако обсуждение затягивалось, так как PHP должен был сохранить обратную совместимость и учесть существующие правила вызова функций. В результате к 2024 году родился более аккуратный и предсказуемый вариант — тот, что вошёл в PHP 8.5.

Главное свойство оператора - он подставляет результат слева как первый аргумент функции справа.

Базовый принцип работы

$x |> f()

эквивалентно вызову:

f($x);

Механизм работает для:

• глобальных функций;

• методов объектов (через замыкания);

• любых замыканий и стрелочных функций.

Правила использования правой части |>

В левой части оператора |> может находиться произвольное значение или выражение. В правой части должно быть допустимое callable-выражение, которое принимает единственный параметр.

Основные ограничения:

1. Функции с двумя и более обязательными параметрами запрещены.
   Если попытаться вызвать такую функцию через pipe, PHP выдаст ошибку, как при стандартном вызове с недостаточным количеством аргументов:

   function add($a, $b) { return $a + $b; }
   
   $result = 5 |> add(); // Ошибка: недостаточно аргументов

2. Нельзя передавать функции с аргументами по ссылке.
   PHP выбросит ошибку, если функция в правой части принимает переменную по ссылке:

   function increment(&$x) { $x++; }
   
   $value = 10;
   $value |> increment(); // Ошибка

3. В правой части должно быть вызываемое значение (callable).
   Если передать что-то, что не является функцией или замыканием, PHP выдаст Error:

   $value = 5;
   $value |> 123; // Ошибка: 123 не является callable

4. Стрелочные функции в цепочке требуют круглых скобок (из-за синтаксической двусмысленности):

   $value
       |> (fn($x) => $x + 1)
       |> (fn($y) => $y * 2);
   

Примеры использования

Получение длины строки

$size = 'Welcome to PHP!' |> strlen();

Обработка строки

$message
    |> trim()
    |> strtolower()
    |> ucwords();

Работа с массивами

$products
    |> (fn($items) => array_column($items, 'categories'))
    |> (fn($lists) => array_merge(...$lists))
    |> array_unique()
    |> array_values();

Бизнес-логика в виде цепочки

$employees
    |> array_filter(fn($emp) => $emp['salary'] > 48000)
    |> array_map(fn($emp) => $emp['name'])
    |> implode(', ');

Типичные ошибки и их причины

Ошибка №1. Функция не принимает аргументов

$value |> decodeJson(); // Ошибка: Too many arguments

Решение:

$value |> (fn($x) => decodeJson($x));

или если аргументы не нужны:

$value |> (fn() => decodeJson());

Ошибка №2. Неверный порядок аргументов функции

$value |> preg_match('/test/'); // Не соответствует порядку аргументов

Решение:

$value |> (fn($x) => preg_match('/test/', $x));

Ошибка №3. Метод объекта нельзя вызвать напрямую

$user |> $service->process(); // PHP интерпретирует как $service->process($user)

Правильно:

$user |> (fn($x) => $service->process($x));

Ошибка №4. Неправильное использование с конструкторами

$data |> new DTO(); // PHP вызовет new DTO($data)

Корректно:

$data |> (fn($x) => new DTO($x));

Ошибка №5. Пайп там, где ухудшает читаемость

Pipe operator удобен для длинных цепочек преобразований, но для простых или атомарных вызовов лучше оставить классический вызов.

Рекомендации по использованию

1. Использовать pipe для многошаговых преобразований.

2. Для функций с аргументами в «неподходящем» порядке — применять лямбды.

3. Не превращать каждую операцию в pipe; стиль важнее моды.

4. При сомнениях в сигнатуре функции — оборачивать в замыкание.

5. Стрелочные функции в пайпах обязательно заключать в круглые скобки, если они участвуют в цепочке.

Взгляд в будущее

Появление pipe operator в PHP 8.5 - это первый шаг к более функциональному стилю программирования. В ближайших версиях ожидается развитие:

• Partial application (частичное применение функций);

• Композиция функций;

• Улучшение поддержки чистых функций в PHP.

Это позволит писать код, более похожий на F# или Elixir, где цепочки преобразований становятся естественным инструментом.

Заключение

Pipe operator делает PHP более современным, облегчает чтение и поддержку кода.

Главное - правильно использовать его с учётом аргументов функций и методов, не превращать побочные эффекты в пайпы и использовать лямбды с контролем порядка аргументов.

Мой Telegram-канал с материалами по PHP и архитектуре: https://t.me/berloga_ait