PHP中`man`命令输出字符串与字面量匹配失败的解决方法

问题场景与代码 #

我用PHP的exec()获取man ar的输出，但在判断某行是否为"NAME"时，所有比较都返回false，代码如下：

$oares = array();
exec("man ar", $oares);

foreach ($oares as $kk => $vv) {
    // d()是类似var_dump的自定义调试函数
    d($vv);
    d("NAME");
    d(trim($vv) == "NAME");
    d($vv == "NAME");
    d("NAME" == "NAME");
    d(mb_strpos(trim($vv), "NAME"));
}

调试输出显示：

┌─────────────────────────────────────────────────────────────┐
│ $vv                                                         │
└─────────────────────────────────────────────────────────────┘
UTF-8 string (12) "NAME"
┌─────────────────────────────────────────────────────────────┐
│ literal                                                     │
└─────────────────────────────────────────────────────────────┘
string (4) "NAME"
┌─────────────────────────────────────────────────────────────┐
│ trim($vv)                                                   │
└─────────────────────────────────────────────────────────────┘
UTF-8 string (12) "NAME"
┌─────────────────────────────────────────────────────────────┐
│ trim($vv)=="NAME"                                           │
└─────────────────────────────────────────────────────────────┘
boolean false
┌─────────────────────────────────────────────────────────────┐
│ $vv=="NAME"                                                 │
└─────────────────────────────────────────────────────────────┘
boolean false
┌─────────────────────────────────────────────────────────────┐
│ "NAME"=="NAME"                                              │
└─────────────────────────────────────────────────────────────┘
boolean true

mb_strpos(trim($vv), "NAME") - also return false

我原本猜测是UTF-8和非UTF-8编码不匹配，但实际原因并非如此。

原因分析 #

问题出在man命令的输出上：默认情况下，man会输出带终端格式控制符的内容（比如用于加粗、变色的ANSI转义序列），这些字符肉眼不可见，但会占用字节数，导致"NAME"行的实际长度是12而非4，trim()只能去除空白字符，无法清理这些控制符，所以字符串比较和mb_strpos都会失败。

解决方法 #

有两种可行的处理方式：

方法1：让man输出纯文本（推荐） #

直接修改exec的命令，让man跳过终端格式输出纯文本：

$oares = array();
// 用col -b移除所有控制字符，或者用man --no-colors --no-pager ar（部分系统适用）
exec("man ar | col -b", $oares);

foreach ($oares as $kk => $vv) {
    $cleanLine = trim($vv);
    d($cleanLine == "NAME"); // 现在返回true
    d(mb_strpos($cleanLine, "NAME")); // 返回0
}

不同系统的man参数可能有差异：

• 部分Linux系统可用：man --no-colors --no-pager ar
• macOS可用：man -P cat ar（用cat输出，跳过分页器和格式）

方法2：在PHP中清理控制符 #

如果无法修改man命令，可以在PHP里用正则表达式移除ANSI转义序列：

$oares = array();
exec("man ar", $oares);

foreach ($oares as $kk => $vv) {
    // 移除所有ANSI格式控制符
    $cleanLine = preg_replace('/\x1b\[[0-9;]*m/', '', $vv);
    $cleanLine = trim($cleanLine);
    d($cleanLine == "NAME"); // 返回true
    d(mb_strpos($cleanLine, "NAME")); // 返回0
}

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