PHP中使用正则表达式实现轻量级模板的最优方案

我来帮你搞定这个简易模板系统的问题！你之前的代码没用到正则导致无法正常运行，其实正则是处理这种模板变量替换最方便的方式，而且咱们还得把变量不存在的异常情况处理好。

下面是完整的可运行实现，我会给你拆解每个部分的作用：

class Markdown {
    private static $folder = 'markdowns/';

    public static function render($filename, $data = []) {
        // 拼接完整的Markdown文件路径（自动加.md后缀）
        $filePath = self::$folder . $filename . '.md';

        // 先检查文件是否存在，避免读取失败
        if (!file_exists($filePath)) {
            return "错误：模板文件 {$filename}.md 不存在，请检查路径或文件名";
        }

        // 读取文件内容
        $content = file_get_contents($filePath);
        if ($content === false) {
            return "错误：无法读取模板文件 {$filename}.md";
        }

        // 核心：匹配并替换所有{{变量}}格式的内容
        $renderedContent = preg_replace_callback(
            // 正则规则：匹配{{ 变量名 }}，允许变量前后有空格（更友好）
            '/{{\s*(\w+)\s*}}/',
            function ($matches) use ($data) {
                $variableName = $matches[1];
                // 检查变量是否存在，存在则替换为对应值，否则返回自定义提示（也可以返回空）
                return isset($data[$variableName]) ? $data[$variableName] : "[未定义变量: {$variableName}]";
            },
            $content
        );

        return $renderedContent;
    }
}

// 使用示例
$data = [
    'pageTitle' => '我的个人博客',
    'author' => 'Steve',
    'articleContent' => '这是通过模板变量动态生成的博客内容~'
];

// 渲染markdowns目录下的test.md文件
echo Markdown::render('test', $data);

关键细节说明： #

• 正则匹配：用/{{\s*(\w+)\s*}}/可以精准匹配{{变量}}、{{ 变量 }}这种带空格的格式，兼容性更好；括号里的(\w+)会捕获变量名，方便后续处理。
• 变量存在性检查：通过isset($data[$variableName])判断变量是否存在，避免出现数组键不存在的警告，不存在时可以返回空字符串或者自定义提示文本（这里用了[未定义变量: xxx]，你可以改成自己需要的内容）。
• 文件安全处理：增加了文件存在性和读取结果的判断，避免因为文件不存在或权限问题导致的报错。
• 灵活性：默认$data是空数组，即使不传数据也不会报错，模板里未定义的变量会显示提示。

为什么不用正则不行？ #

如果不用正则，你可能需要用str_replace遍历所有变量，但这种方式有两个大问题：

1. 没法处理模板里动态的变量名（你不知道用户会写哪些变量）；
2. 无法兼容变量前后带空格的情况，用户体验不好；
3. 效率低，需要多次替换，而正则可以一次性处理所有匹配项。

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