WordPress中如何实现header.php变量向全站模板跨文件传递？

你遇到的问题是PHP变量作用域导致的——header.php中定义的$home_url、$logo_url是局部变量，仅在header.php的作用域内有效，无法直接被template.php访问。以下是两种可行的解决办法：

方案1：使用全局变量（快速修复） #

在header.php中定义变量前添加global声明，将变量升级为全局变量：

// header.php 开头添加全局声明
global $home_url, $logo_url;

// 原有的页面/分类判断逻辑保持不变
$post = get_post();
$page_id = get_the_ID($post);
$page_parent_id = wp_get_post_parent_id($page_id);
if($page_parent_id==0) { $page_parent_id = $page_id; }
switch($page_parent_id) {
    case 24:
        $logo_url = "/wp-content/uploads/2019/03/logo-lestradeditorino.png";
        $home_url = "/torino";
    break;
    // ...其他case逻辑
}

在template.php中使用前，同样需要声明全局：

// template.php
global $home_url;
echo $home_url;

或者直接通过$GLOBALS数组访问（无需额外声明）：
header.php中赋值时：

$GLOBALS['home_url'] = "/torino";

template.php中调用：

echo $GLOBALS['home_url'];

方案2：封装为主题函数（推荐，更规范） #

将变量生成逻辑封装到主题的functions.php中，通过函数调用获取值，避免全局变量污染：

// functions.php
function get_custom_site_vars() {
    // 初始化默认值
    $home_url = "/";
    $logo_url = esc_url(get_theme_mod('logo')); // 替换原$theme_settings为WordPress标准函数

    // 处理页面类型逻辑
    $post = get_post();
    if ($post) {
        $page_id = get_the_ID($post);
        $page_parent_id = wp_get_post_parent_id($page_id);
        $page_parent_id = $page_parent_id ?: $page_id;

        switch($page_parent_id) {
            case 24:
                $logo_url = "/wp-content/uploads/2019/03/logo-lestradeditorino.png";
                $home_url = "/torino";
            break;
            case 27:
                $logo_url = "/wp-content/uploads/2019/03/logo-lestradedimilano.png";
                $home_url = "/milano";
            break;
            case 29:
                $logo_url = "/wp-content/uploads/2019/03/logo-lestradedigenova.png";
                $home_url = "/genova";
            break;
            case 34:
                $logo_url = "/wp-content/uploads/2019/03/logo-lestradediroma.png";
                $home_url = "/roma";
            break;
            case 42030:
                $logo_url = "/wp-content/uploads/2022/07/logo-lestradedinapoli.png";
                $home_url = "/napoli";
            break;
            case 50629:
                $logo_url = "/wp-content/uploads/2022/07/logo-lestradediparma.png";
                $home_url = "/parma";
            break;
            case 52120:
                $logo_url = "/wp-content/uploads/2022/07/logo-lestradediverona.png";
                $home_url = "/verona";
            break;
        }
    }

    // 处理文章分类逻辑
    $category = get_the_category();
    if (!empty($category)) {
        $post_parent = [];
        if (count($category) > 1) {
            $post_parent = get_ancestors($category[0]->term_id, 'category');
            $post_parent = array_reverse($post_parent);
        } else {
            $post_parent[0] = $category[0]->cat_ID;
        }
        $post_parent = array_reverse($post_parent);

        if (!empty($post_parent[0])) {
            switch($post_parent[0]) {
                case 4:
                    $logo_url = "/wp-content/uploads/2019/03/logo-lestradeditorino.png";
                    $home_url = "/torino";
                break;
                case 12:
                    $logo_url = "/wp-content/uploads/2019/03/logo-lestradedimilano.png";
                    $home_url = "/milano";
                break;
                case 18:
                    $logo_url = "/wp-content/uploads/2019/03/logo-lestradedigenova.png";
                    $home_url = "/genova";
                break;
                case 222:
                    $logo_url = "/wp-content/uploads/2019/03/logo-lestradediroma.png";
                    $home_url = "/roma";
                break;
                case 419:
                    $logo_url = "/wp-content/uploads/2022/07/logo-lestradediparma.png";
                    $home_url = "/parma";
                break;
                case 386:
                    $logo_url = "/wp-content/uploads/2022/07/logo-lestradediverona.png";
                    $home_url = "/verona";
                break;
                case 385:
                    $logo_url = "/wp-content/uploads/2022/07/logo-lestradedinapoli.png";
                    $home_url = "/napoli";
                break;
            }
        }
    }

    // 返回包含两个变量的数组
    return compact('home_url', 'logo_url');
}

之后在任何模板文件中调用：
header.php中：

$site_vars = get_custom_site_vars();
$home_url = $site_vars['home_url'];
$logo_url = $site_vars['logo_url'];

template.php中：

$site_vars = get_custom_site_vars();
echo $site_vars['home_url'];

注意事项 #

• 封装函数时，建议用get_theme_mod()代替直接调用$theme_settings，符合WordPress主题开发规范。
• 函数中添加了$post和$category的非空判断，避免页面无内容时出现PHP警告。
• 全局变量方案适合快速修复，但长期维护推荐使用函数封装，减少全局作用域污染。

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