WordPress中如何让模板子文件访问主模板的PHP变量

为什么主模板的变量无法在子模板中访问？ #

WordPress的get_template_part()函数内部是在独立的函数作用域中执行文件引入的，也就是说子模板（page_tab_x.php）的代码运行在函数内部，而你在主模板顶部声明的变量属于主模板所在的作用域（通常是全局或当前模板的作用域），无法直接穿透到get_template_part()的函数作用域里，所以子模板访问不到这些变量。

更优雅的解决方案 #

方案1：使用WordPress官方推荐的set_query_var()/get_query_var() #

这是最符合WordPress开发规范的方式，专门用于在模板间传递变量：

• 在主模板page_template.php中设置变量：

// 主模板顶部
set_query_var('my_variable', 'Test'); // 这里可以替换成你的复杂计算逻辑

• 在子模板page_tab_1.php中获取变量：

$my_variable = get_query_var('my_variable');
echo $my_variable; // 正常输出Test

方案2：使用全局变量（简单但需注意污染） #

如果项目规模不大，也可以用全局变量快速解决：

• 主模板中声明全局变量：

// 主模板顶部
global $my_variable;
$my_variable = 'Test'; // 复杂计算逻辑放在这里

• 子模板中调用时先声明全局：

global $my_variable;
echo $my_variable;

注意：全局变量可能会和其他插件/主题的变量冲突，不推荐在大型项目中使用。

方案3：优化现有函数方案（避免重复计算） #

你当前用的函数方案可以优化，通过静态变量缓存计算结果，确保复杂逻辑只执行一次：

// 主模板顶部
function get_my_variable() {
    static $cached_value;
    if (!isset($cached_value)) {
        // 这里放你的复杂计算逻辑，只会执行一次
        $cached_value = 'Test';
    }
    return $cached_value;
}

之后在主模板和子模板中直接调用get_my_variable()即可，无需重复计算。

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