管道操作符解决函数嵌套难读和临时变量冗余问题，通过线性链式调用（如$input |> trim() |> strtolower() |> fn($s) => str_replace(' ', '-', $s)）使逻辑与执行顺序一致，要求右侧callable必须且仅接收一个参数。
管道操作符到底解决什么问题
它专治“函数嵌套看花眼”和“临时变量满天飞”这两种日常写法。比如你得把 $input 先 trim，再转小写，再替换空格为连字符，传统写法是 str_replace('-', ' ', strtolower(trim($input)))——读的时候得从里往外扒三层括号，改的时候一不小心就漏掉一层。
用 |> 就变成线性流：$input |> trim() |> strtolower() |> fn($s) => str_replace(' ', '-', $s)。逻辑顺序和执行顺序完全一致，谁都能一眼看出每步干了啥。
哪些函数能直接往管道里塞
右边必须是「只收一个参数」的 callable，否则报错 Fatal error: Uncaught ValueError: Pipe operator requires a callable accepting exactly one required parameter。
-
trim()、strlen()、json_encode()这类内置函数——行 -
fn($x) => str_replace(...)箭头函数——行（记得显式写参数类型更安全） -
$obj->method()或ClassName::staticMethod()——行，但方法签名必须是public function method($input)形式 -
str_replace('a', 'b', $input)这种三参数函数——不行，会直接报错 -
array_map(...)这种接收回调+数组的——不行，除非你包一层fn($arr) => array_map(..., $arr)
真实场景中怎么用才不翻车
别把它当成炫技工具，重点是让数据流清晰可测。下面这几个地方最值得上：
立即学习“PHP免费学习笔记（深入）”；
-
API 输入清洗：用户提交的
$email走|> trim() |> strtolower() |> filter_var(..., FILTER_VALIDATE_EMAIL)，每步都可单独单元测试 -
CSV 行处理流水线：读到一行原始数组后，
|> fn($row) => normalizeRow($row) |> fn($row) => isValidRow($row) ? $row : null |> array_filter()，过滤和转换职责分离 -
HTTP 响应组装：比如
$data |> json_encode() |> gzencode(..., 6) |> base64_encode()，比拼接一堆中间变量干净得多 -
搜索关键词分词：像
$query |> trim() |> strtolower() |> fn($s) => preg_replace('/[^\w\s]/', '', $s) |> fn($s) => explode(' ', $s)，每步专注一件事
注意：箭头函数里别偷偷捕获外部变量，PHP 8.5 要求管道右侧的闭包必须是 static 的（虽然语法没强制写 static fn，但实际运行时若引用 $this 或外部作用域变量会出错）。
容易被忽略的兼容性和陷阱
它不是语法糖，是 PHP 解析器层面的新规则，所以有硬性限制：
- 不能在表达式中间断开，比如
$x |> foo() + 1是非法的，|>右边必须是完整 callable 调用 - 不支持引用传参，像
sort(&$arr)这类函数不能进管道 - 错误堆栈现在会显示管道链中的具体位置，比如
#0 example.php(12): foo() #1 example.php(12): {pipe}，调试比以前清楚，但也意味着你要习惯看{pipe}这种新标记 - 如果你还在用 PHP 8.4 或更低版本，
|>会直接解析失败，报Parse error: syntax error, unexpected token "|>"——上线前务必确认环境版本
最常被卡住的一点：你以为 str_replace() 能直接用，结果发现它要三个参数；你以为 array_filter() 能直接塞进去，结果它要两个。管道不帮你“猜意图”，只做严格的一对一传递。写之前，先盯住函数签名。
