PHP 8.5 管道操作符怎样串联函数调用

PHP 8.5 的管道操作符是 |>：它把左侧表达式的结果交给右侧 callable，并把 callable 的返回值继续作为下一段输入。这样一段连续的文本处理就可以按“输入 → 转义 → 拆分 → 映射 → 过滤”的方向书写，读者不必在多层嵌套函数里来回寻找数据流。

官方地址：https://www.php.net/manual/en/language.operators.functional.php

本文用一个命令行文本清洗小项目演示管道链。右侧 callable 需要能够接收一个参数；箭头函数放在管道右侧时要用括号包住。项目代码只适用于 PHP 8.5 及以上版本。

• 普通函数可以用首类 callable 形式，例如 strlen(...)。
• 每个 |> 都只把当前左值传给下一段 callable。
• 箭头函数写成 (fn ($value) => ...)，不要省略外层括号。
• 需要多个必填参数或引用传参的函数不能直接作为管道右侧。

项目目标：把文本处理改写成左到右

假设我们要做一个很小的文本清洗器：先把用户输入转成 HTML 安全文本，再拆成字符，接着把字符转成大写，最后去掉字母 O。传统写法可以通过临时变量完成，但步骤一多就容易把“谁是上一步结果”藏在嵌套调用里。

这个小项目的验收结果不是网页截图，而是一组可以在命令行打印出来的字符数组。每个阶段只接收上一个阶段的结果，正好适合用管道操作符表达。

准备 PHP 8.5 环境和输入数据

先确认命令行解释器是 PHP 8.5 或更高版本。PHP 手册把管道操作符列为 PHP 8.5 的新功能；如果在旧版本运行，解析阶段就会因为不认识 |> 而失败。

# 查看命令行 PHP 版本，确认解释器至少是 8.5
php -v

# 创建本次小项目目录并进入目录
mkdir -p php-pipe-demo
cd php-pipe-demo

新建 pipe.php，先只放输入字符串和一段普通函数调用。示例中的中文注释说明数据要经过的阶段，避免把管道符误解成 shell 的管道。

用普通函数开始第一段管道

管道右侧接收的是 callable，而不是“已经执行完的返回值”。因此要写 htmlentities(...)、str_split(...) 这种首类 callable，让 PHP 在管道传值时调用它。单个步骤的写法如下：

 htmlentities(...);

// escaped 的结果再传给 str_split，得到字符数组。
$characters = $escaped |> str_split(...);

print_r($characters);

这里的关键是左值的生命周期：第一行的结果交给第二行，第二行的结果才是字符数组。它等价于先保存临时变量再调用函数，但表达方向更接近“数据从哪里流向哪里”。

把箭头函数接到管道中

内置函数能覆盖固定的一步处理，但项目通常还需要一段只服务于当前任务的逻辑。例如要把每个字符都转成大写，可以用 array_map；要把回调参数写清楚，就用一个箭头函数返回新的数组。

 (fn (array $items): array =>
    array_map(strtoupper(...), $items)
);

// 过滤掉字母 O，保留空格和其他字符。
$filtered = $upper |> (fn (array $items): array =>
    array_filter($items, static fn (string $item): bool => $item !== 'O')
);

// 用 JSON 输出便于观察最终数组，而不是依赖调试器界面。
echo json_encode(array_values($filtered), JSON_UNESCAPED_UNICODE), PHP_EOL;

箭头函数的外层括号不是装饰。PHP 手册明确提示，为了避免语法歧义，箭头函数放在 |> 右侧时必须包在括号中。这里每个箭头函数都只声明一个必填参数 $items，因此能接收上一段产生的数组。

整理成一个可运行的小项目

为了让每一段都在同一个文件里，最终版本可以把输入、普通函数链、两个箭头函数和输出验收放在一起。代码中的每个处理函数都只处理当前阶段，出现错误时也容易定位到具体一段。

 htmlentities(...)
    // 再按字符拆分，供后续数组回调处理。
    |> str_split(...)
    // 箭头函数用括号包裹，统一把数组作为唯一参数。
    |> (fn (array $items): array => array_map(strtoupper(...), $items))
    // 过滤 O 后重置数字键，方便序列化为紧凑数组。
    |> (fn (array $items): array => array_values(
        array_filter($items, static fn (string $item): bool => $item !== 'O')
    ));

// JSON 输出是可复制的验收结果，不代表浏览器页面截图。
echo json_encode($result, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), PHP_EOL;

保存后运行：

# PHP 8.5 CLI 执行管道示例，错误会直接返回非零退出状态
php pipe.php

预期会得到一个 JSON 数组，数组中的字符已经经过转义、拆分、转大写和过滤。实际输出的细节会随输入字符串改变；验收重点是每个阶段确实把上一步返回值交给下一步，而不是把整个链写成无法观察的嵌套表达式。

参数传递边界：哪些 callable 不能直接接入

管道操作符的规则可以压缩成一句话：右侧必须最终得到一个可调用对象，并且这个 callable 只能依赖一个由管道提供的必填参数。普通函数、首类 callable、Closure、箭头函数以及实现 __invoke() 的对象都可以成为右侧目标，但参数契约仍然要满足。

 (fn (string $value): string => join_parts($value, ' 8.5'));
echo $suffix, PHP_EOL;

不要把 join_parts(...) 直接放到管道右侧期待 PHP 自动补齐第二个参数；它仍会像普通函数调用一样因为缺少必填参数而失败。引用传参函数也不能直接用管道填入，因为管道传入的是一个计算结果，不是可供被调用方修改的变量引用。

同理，右侧表达式如果最终不是有效 callable，也会抛出错误。把“需要多个输入”的业务函数包在只接收一个值的箭头函数里，或者先在链外准备好固定参数，是更清晰的适配方式。

运行验收与后续改造

完成小项目后，可以按下面的顺序验收：解释器版本是 8.5 以上；普通函数写成首类 callable；箭头函数带有外层括号；每段只声明一个管道提供的必填参数；最后的 JSON 输出能反映过滤规则。若语法报错，优先检查 PHP 版本和箭头函数括号，而不是先修改业务逻辑。

常见问题

PHP 8.4 能不能使用 |>？

不能按本文语法直接使用。管道操作符是 PHP 8.5 的语言功能，运行前应确认 CLI 和实际部署环境的 PHP 版本一致。

管道右侧可以写普通函数调用吗？

右侧需要的是 callable，因此应使用首类 callable、Closure、箭头函数或可调用对象。像 strlen() 这样先执行再把结果放到右侧，不表达管道需要的调用契约。

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

括号用于消除 |> 与箭头函数之间的语法歧义。写成 |> (fn ($value) => ...)，让整个箭头函数表达式成为右侧 callable。

多个参数的函数应该怎样接入？

先用箭头函数或 Closure 接收管道提供的一个值，再在函数体内补入固定参数。这样数据流边界清楚，也不会让管道隐式猜测其他参数来源。

PHP 8.5 的管道操作符适合表达连续、单向、单输入的转换链。把每一步写成可独立理解的 callable，再用一个小项目验证最终结果，就能在可读性和参数边界之间取得平衡。