如何通过PHP检测其他目录同名.tpl文件并实现模板覆盖加载

核心逻辑 #

封装通用的模板加载判断逻辑，在PHP端注册为模板引擎的全局可调用函数，无需在每个.tpl文件中单独编写分支判断。

具体实现（以Smarty模板引擎为例） #

1. 提前配置目录常量 #

先在全局配置文件中定义好默认模板目录和覆盖模板目录的绝对路径：

// 覆盖文件存放目录绝对路径，根据实际项目修改
define('OVERWRITE_TPL_DIR', '/var/www/your_project/overwrites/');
// 原默认模板存放目录绝对路径，根据实际项目修改
define('DEFAULT_TPL_DIR', '/var/www/your_project/templates/');

2. 注册自定义模板加载函数 #

在Smarty实例初始化的位置，注册自定义的include函数：

// 定义自定义include函数逻辑
function smarty_custom_include($params, $smarty) {
    $tpl_filename = $params['file'];
    // 先检查覆盖目录是否存在同名文件
    $overwrite_file = OVERWRITE_TPL_DIR . $tpl_filename;
    if (file_exists($overwrite_file) && is_file($overwrite_file)) {
        return $smarty->fetch($overwrite_file);
    }
    // 不存在则加载默认目录的模板
    $default_file = DEFAULT_TPL_DIR . $tpl_filename;
    return $smarty->fetch($default_file);
}

// 将函数注册到Smarty，模板中可通过{include_cover}调用
$smarty->registerPlugin('function', 'include_cover', 'smarty_custom_include');

3. 模板中使用 #

所有需要支持覆盖加载的模板位置，直接调用自定义函数即可，不需要写判断逻辑：

{* 原来的写法 {include file="head.tpl"} 替换为下面的写法 *}
{include_cover file="head.tpl"}

零改模板进阶方案 #

如果不想修改现有模板中的所有{include}标签，可以额外注册Smarty的预处理过滤器，自动替换所有原生include调用：

$smarty->registerFilter('pre', function($source, $smarty) {
    // 正则匹配所有原生include标签，自动替换为自定义的覆盖加载函数
    return preg_replace('/\{include\s+file="([^"]+)"([^}]*)\}/', '{include_cover file="$1"$2}', $source);
});

注意事项 #

• 路径请使用服务器绝对路径配置，避免相对路径导致file_exists判断错误
• 若使用除Smarty外的其他模板引擎，逻辑一致，仅需将上述注册插件的步骤替换为对应引擎的自定义函数注册逻辑即可

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