如何让cPanel的Pipe to Program执行后继续运行其他全局邮件过滤器？

问题场景 #

我在cPanel主机上用Global Filters管理邮件投递，想通过Pipe to Program脚本分析邮件内容并记录日志，之后让邮件继续走后续的Global Filters流程，但遇到了问题：

• 首个Pipe to Program过滤器能正常运行，日志记录正常
• 执行后后续Global Filters完全失效，邮件既不投递也不退回
• 即使使用仅含exit(0);的极简脚本，问题依旧；删除该过滤器后所有流程恢复正常

我的脚本结构如下：

#!/usr/bin/php -q
<?php

/*** 此处为分析邮件内容、写入日志的代码 ***/

exit(0);
?>

文件权限设为755，运行无异常。

解决方案 #

cPanel的Global Filters中，默认的「Pipe to Program」动作会直接终止后续邮件处理流程，不管脚本返回什么状态码。要让流程继续，有两种可行方案：

方案1：用「转发到管道地址」替代直接Pipe动作（推荐） #

不要选择「Pipe to Program」动作，而是选择「Forward to Email Address」，然后在地址栏填写带管道前缀的脚本绝对路径，格式为：

|/home/your-cpanel-username/path/to/your/script.php

这种方式下，脚本执行完成后，邮件会自动进入后续的Global Filters流程，最终正常投递到原收件人。

注意事项：

• 必须使用绝对路径，不能用相对路径
• 脚本权限保持755，所有者设为你的cPanel账户用户（不要用root）

方案2：修改脚本，回传完整邮件内容 #

如果一定要用「Pipe to Program」动作，必须在脚本中读取完整的原始邮件内容，处理完成后将内容完整输出到STDOUT，这样邮件系统才会继续处理后续流程。

修改后的示例脚本：

#!/usr/bin/php -q
<?php
// 读取STDIN中的完整邮件内容
$rawMail = file_get_contents('php://stdin');

// 此处执行邮件分析、日志记录操作
// ...

// 将原始邮件完整输出回STDOUT，确保后续流程能获取到邮件
echo $rawMail;

exit(0);
?>

关键注意点：

• 不能在输出中添加任何额外内容（比如调试信息），否则会破坏邮件格式
• 必须确保输出的内容和输入的原始邮件完全一致

验证方法 #

可以通过手动测试脚本的输入输出，确认没有额外内容：

1. 保存一份测试邮件内容到文件test-mail.txt
2. 执行命令：cat test-mail.txt | /path/to/your/script.php > output.txt
3. 对比test-mail.txt和output.txt，确保内容完全一致

内容的提问来源于stack exchange，提问作者HippoMan