使用 var_dump 和 print_r 调试正则回调逻辑

在使用 preg_replace_callback_array 处理复杂文本替换时，常常需要在正则回调函数中调试匹配项、判断逻辑是否正确。PHP 提供了两个非常实用的调试函数：var_dump() 和 print_r()。本文将通过实例演示，如何在 preg_replace_callback_array 中借助这两个函数更方便地调试正则回调逻辑。

什么是 preg_replace_callback_array？

preg_replace_callback_array() 是 PHP 7.0 及以上版本提供的函数，允许你传入一个正则表达式与回调函数组成的关联数组，它会遍历匹配文本并根据对应的回调函数进行替换。

preg_replace_callback_array(array $patterns_and_callbacks, string $subject, int $limit = -1, int &$count = null): string

相比 preg_replace_callback，它能处理多个正则表达式和多个回调函数，逻辑更清晰、扩展性更强。

实战案例：调试多模式替换逻辑

假设我们有一段文本，里面混合了 Markdown 风格的链接和自定义的 {{code}} 标签，我们想用 preg_replace_callback_array 统一处理它们：

$text = '点击 [这里](https://m66.net) 查看详情，或者使用 {{print_name}} 变量。';

我们定义两个模式，并为它们指定各自的回调函数：

$patterns = [
    // 匹配 markdown 链接：[文本](URL)
    '/\[(.*?)\]\((.*?)\)/' => function ($matches) {
        echo "匹配到 markdown 链接:\n";
        print_r($matches);
        return '<a href="' . htmlspecialchars($matches[2]) . '">' . htmlspecialchars($matches[1]) . '</a>';
    },
    // 匹配 {{变量}} 形式
    '/\{\{(.*?)\}\}/' => function ($matches) {
        echo "匹配到变量标签:\n";
        var_dump($matches);
        $variableName = $matches[1];
        // 模拟变量替换
        $variables = [
            'print_name' => '用户名'
        ];
        return isset($variables[$variableName]) ? $variables[$variableName] : '';
    }
];

$result = preg_replace_callback_array($patterns, $text);
echo "\n最终替换结果：\n" . $result;

输出结果示例：

匹配到 markdown 链接:
Array
(
    [0] => [这里](https://m66.net)
    [1] => 这里
    [2] => https://m66.net
)
匹配到变量标签:
array(2) {
  [0]=>
  string(17) "{{print_name}}"
  [1]=>
  string(10) "print_name"
}

最终替换结果：
点击 <a href="https://m66.net">这里</a> 查看详情，或者使用 用户名 变量。

使用建议

• 使用 print_r() 输出结构清晰的数组，更适合人类阅读；

• 使用 var_dump() 查看数据类型和长度，在处理多种数据结构时尤其有用；

• 为了避免调试信息污染网页输出，建议在 CLI 或日志文件中进行调试；

• 在上线前移除或注释所有调试语句，确保输出整洁。

总结

preg_replace_callback_array 提供了强大的多模式正则替换能力，在调试阶段配合 var_dump() 与 print_r() 能帮助我们快速了解匹配情况、验证逻辑是否正确。掌握这套调试方法，能大大提高你处理复杂文本处理任务的效率。