PHP 8.5 pipe 操作符怎样串联返回值

PHP 8.5 新增的 pipe 操作符是 |>。它把左侧表达式的返回值作为一个参数传给右侧 callable，再把这次调用的返回值继续交给下一段，因此可以把“从里向外读”的嵌套调用改成“从左到右读”的数据链。它不是 shell 管道，也不会自动替你处理多个参数、异常或 null。

官方地址：https://www.php.net/releases/8.5/en.php

记住一句话：$value |> callable(...) 等价于把 $value 作为唯一输入调用右侧 callable；链中的下一段拿到的是上一段的返回值。

先确认 pipe 的输入输出规则

PHP 官方对 pipe 的定义很直接：它按从左到右的方向串联 callable，并减少中间变量。下面的最小例子里，第一段返回字符串，第二段接收这个字符串并继续返回结果。

 trim(...)
    |> strtolower(...);

// 这里的 $result 是 'php pipe'。
echo $result;

这里的关键不是符号看起来像箭头，而是返回值契约：trim(...) 的结果会成为 strtolower(...) 的输入。如果某段返回了数组，下一段就应该能接收数组；如果某段返回了 null，下一段收到的仍然是 null。

首类 callable 适合直接串联的函数

当函数本身已经符合“接收一个值并返回一个值”时，使用首类 callable 语法最简洁。函数名后面的 ... 不是省略号注释，而是把函数转换为可传递的 callable。

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

echo $slug; // php-85-released

这段链路的阅读顺序和数据变化顺序一致：原始标题先进入 trim，再进入两个闭包，最后进入 strtolower。如果你只需要把一个值交给函数，首类 callable 通常比手写一个同名闭包更容易读。

多参数函数要用闭包收口

pipe 每一段只会把上一步的值作为一个参数传给右侧 callable。像 str_replace 这样还需要固定前缀、替换值或其他配置的函数，不能直接把“管道值”自动塞进任意参数位置，应该用闭包把额外参数固定下来。

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

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

判断是否需要闭包的方法很简单：把当前返回值替换到函数调用中，若函数还缺少固定参数，就用闭包完成一次参数适配。闭包的参数类型和返回类型也能把每一段的边界写得更清楚。

为什么它比嵌套调用更容易排查

同样的转换可以写成嵌套形式：

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

pipe 的价值主要是表达式的方向更稳定，而不是保证性能更高。PHP 官方示例也把它用于一连串字符串处理；如果链条只有一两个函数，传统调用往往已经足够，没必要为了符号而改写。

返回值和 null 不会被 pipe 自动修复

pipe 只负责传值，不负责改变类型，也不提供隐式的空值短路。下面的函数可能返回 null，后面的 callable 必须明确接受它，或者在进入下一段前把空值转换成业务需要的默认值。

 'PHP']
    |> findLabel(...)
    |> (fn (?string $value): string => $value ?? '未命名');

echo $label;

如果链中某一段抛出异常，异常仍按普通 PHP 调用规则传播；如果返回类型和下一段的参数类型不匹配，问题也应该在对应边界处处理，而不是期待 |> 替你做类型转换。

PHP 8.5 项目落地时的版本清单

常见疑问

pipe 操作符会把左值传给右侧函数的哪个参数？

它把左侧值作为右侧 callable 的唯一输入参数。需要其他固定参数时，使用闭包把多参数函数包装成单参数 callable。

PHP 8.4 能否直接使用 |>？

不能。pipe 是 PHP 8.5 的语言能力，旧版本应使用普通函数调用、嵌套表达式或临时变量保持兼容。

pipe 是否等同于自动处理 null 的安全链？

不是。它只传递返回值；是否允许 null、是否提供默认值，都要由下一段 callable 或业务代码明确决定。

把 pipe 当成“可读的数据传递语法”就不容易用错：先看每段的输入输出，再决定直接使用 callable 还是用闭包适配。对于 PHP 8.5 项目，这种写法尤其适合连续的字符串、数组或对象转换；对于需要兼容旧版本的公共库，则应把兼容范围放在选型之前。