wordpress函数get_header()的妙用

get_header()是 WordPress 核心函数，用于在模板中载入 header.php文件。其妙用远不止加载一个简单的页头，通过巧妙定制，能极大提升开发效率和灵活性。

核心作用与基本用法：

// 在主题模板文件（如 index.php, single.php, page.php）开头调用
get_header();

这会加载当前主题目录下的 header.php文件。

高级妙用与技巧

1. 加载不同的头部模板 (条件化页头)

通过传递参数，为不同页面加载定制化的 header文件，实现页面布局的多样化。

// 加载 header-special.php
get_header( 'special' );

// 应用场景示例：
if ( is_front_page() ) {
    get_header( 'home' ); // 加载 header-home.php，用于首页全屏横幅等
} elseif ( is_singular( 'product' ) ) {
    get_header( 'shop' ); // 加载 header-shop.php，用于商品单页，可能包含迷你购物车
} else {
    get_header(); // 默认 header.php
}

2. 与钩子（Hooks）结合，实现精细控制

在 header.php文件中精心放置 WordPress 钩子（如 wp_head, 自定义钩子），然后在函数文件中通过 add_action注入代码，实现内容与结构的解耦。

// 在 header.php 中放置一个自定义钩子
do_action( 'mytheme_before_navigation' );

// 在 functions.php 中为不同条件添加内容
add_action( 'mytheme_before_navigation', 'mytheme_add_banner' );
function mytheme_add_banner() {
    if ( is_page( 'about' ) ) {
        echo '<div class="page-banner">关于我们的横幅</div>';
    }
}

3. 传递变量或查询参数

虽然 get_header()本身不直接支持传参，但可通过全局变量或查询参数 ($_GET, $_POST) 实现动态控制 header.php内的逻辑。

// 在模板文件中设置一个全局标志
global $my_special_header;
$my_special_header = true;
get_header();

// 在 header.php 中检查该标志
global $my_special_header;
if ( isset( $my_special_header ) && $my_special_header ) {
    // 执行特殊样式或脚本
}

4. 在非 WordPress 环境中集成

可以在独立的 PHP 文件中加载 WordPress 头部，以保持站点风格一致。

// 在一个独立的 custom-page.php 中
define( 'WP_USE_THEMES', false );
require( './wp-blog-header.php' ); // 加载 WordPress 环境
get_header(); // 加载主题头部
// ... 自定义内容 ...
get_footer();

5. 结合 get_template_part()实现模块化

对于更复杂的组件化结构，可以在 header.php内部使用 get_template_part()来加载可复用的模块片段。

// 在 header.php 内部
get_template_part( 'template-parts/header', 'top-bar' );
get_template_part( 'template-parts/header', 'main-nav' );
get_template_part( 'template-parts/header', 'hero' );

这样可以将头部拆分为多个逻辑部分，便于管理和复用。

6. 用于 AJAX 请求或 REST API 端点

在创建自定义 AJAX 处理或 REST API 端点时，有时需要加载主题的头部以获取样式或脚本依赖。但需谨慎，通常只应加载必要的部分。

最佳实践与注意事项：

子主题支持：get_header()会自动优先加载子主题中的 header.php或 header-{name}.php文件，这是子主题覆盖父主题头部的基础。
性能：避免在单个页面请求中多次调用 get_header()。
必含元素：确保 header.php中包含 wp_head()函数调用，这是 WordPress 核心、插件和主题添加脚本和样式的关键钩子。
配合使用：通常与 get_footer()、get_sidebar()和 get_template_part()协同工作，构建完整的页面模板体系。