PHP 8.5 pipe operator 适合怎样串联纯函数

如果一段 PHP 代码只是把一个值依次交给几个纯函数处理，PHP 8.5 的 |> 很适合把它写成从左到右的数据流。它的右侧必须是只接收一个参数的合法 callable，管道返回该 callable 的结果；因此它改善的是表达顺序，不是把任意函数自动改造成流水线。

官方文档：https://www.php.net/operators.functional

先把嵌套调用改成左到右数据流

以生成 URL slug 为例，旧写法从最内层向外读，函数一多就难以判断每一步的输入。管道写法把“清理空格、替换字符、转小写”排成数据流，变量只在最终结果处出现：

 trim(...)
    |> (fn(string $value): string => str_replace(' ', '-', $value))
    |> (fn(string $value): string => strtolower($value));

echo $slug; // php-8.5-pipe-operator

这里没有隐含的占位符：左侧值会作为唯一实参传给右侧 callable。命名函数可以用 trim(...) 这样的 first-class callable；需要改参数或组合内置函数时，再写一个括号包住的箭头函数。

命名函数和箭头函数要满足同一个 callable 边界

管道右侧可以是 Closure、first-class callable 或实现 __invoke() 的对象，但最终都必须能用一个参数调用。箭头函数的括号是容易遗漏的语法细节，下面的写法才安全：

 trim($value);
$result = '  PHP 8.5  '
    |> $normalize
    |> (static fn(string $value): string => strtolower($value));

// 错误示例：箭头函数未加括号时，管道符可能被解析进函数表达式。
// $result = 'PHP' |> fn($value) => strtolower($value);

不要把 |> 当成支持任意参数插入点的占位语法。strlen(...) 这类单参数函数很直观；一个需要两个必填参数的 callable 会像普通调用缺少参数一样失败，右侧不是 callable 则抛出 Error。

多参数函数要先收口成单参数 callable

真实项目往往有固定配置和当前数据两个输入。例如 str_replace() 需要搜索值、替换值和目标字符串，不能直接放在管道右侧。把前两个参数封装进 Closure，管道只负责传递当前值，边界就清楚了：

 trim(...)
    |> $removePunctuation
    |> (static fn(string $value): string => str_replace(' ', '-', $value));

echo strtolower($slug); // php-85

这类收口也适合把配置对象、正则或格式化规则固定在 Closure 的外层。注意“纯函数”是设计目标，不是 |> 的强制保证：如果阶段写文件、改全局状态或依赖当前时间，链仍然能写，但调试和重试成本会明显上升。

四个边界决定是否应该使用 |>

上线改造时可以先从三到五个无副作用阶段开始，并为每一段保留输入输出类型。链条一旦混入异常恢复、条件分支、日志和资源释放，显式中间变量往往更易维护。结论很简单：|> 适合表达“一个值持续转换成另一个值”，不适合掩盖控制流。

相关问题

PHP 8.4 能使用 pipe operator 吗？

不能。该运算符从 PHP 8.5 开始提供；旧版本应使用嵌套调用、中间变量或项目已有的 Pipeline 实现。

箭头函数为什么必须加括号？

这是为避免管道与箭头函数表达式的解析歧义。写成 |> (fn($value) => ...)，不要省略外层括号。