如何在WordPress Astra主题头部用PHP移除搜索表单

以下是几个从源头禁用Astra主题搜索表单的PHP方案，全部基于子主题操作，符合安全规范，无需修改主题核心文件：

方案1：使用Astra官方过滤器（推荐） #

Astra主题内置了专门控制搜索表单渲染的过滤器，直接在子主题的functions.php中添加以下代码即可：

// 阻止Astra渲染全站搜索表单
add_filter( 'astra_do_not_render_search_form', '__return_true' );

这个过滤器是官方提供的标准控制方式，兼容性最好，能直接让主题跳过搜索表单的生成逻辑，从根源解决问题。

方案2：移除搜索表单的挂载钩子 #

如果方案1无效（可能是旧版本Astra主题），可以先排查搜索表单挂载的钩子，再移除它：

1. 先临时添加以下代码到子主题functions.php，查看头部钩子的所有回调函数：

// 临时输出头部钩子的回调列表，用于定位搜索表单挂载点
add_action( 'wp_footer', function() {
    global $wp_filter;
    // 常见的Astra头部钩子有astra_header、astra_header_primary等，可按需调整
    $target_hooks = ['astra_header', 'astra_header_primary', 'astra_header_top'];
    foreach ( $target_hooks as $hook ) {
        if ( isset( $wp_filter[$hook] ) ) {
            echo "<h3>Hook: {$hook}</h3><pre>";
            print_r( $wp_filter[$hook] );
            echo '</pre>';
        }
    }
} );

2. 访问网站前端，查看页面底部输出的钩子列表，找到包含astra_get_search_form的钩子名称及优先级（默认是10）。
3. 移除临时代码，添加对应的移除动作，比如找到钩子是astra_header_primary，优先级10：

// 移除挂载在指定钩子上的搜索表单
remove_action( 'astra_header_primary', 'astra_get_search_form', 10 );

方案3：覆盖主题搜索表单函数 #

如果上述方案都无效，可以直接覆盖Astra的搜索表单函数（前提是父主题的函数未被标记为final）：
在子主题functions.php中添加：

// 覆盖Astra的搜索表单函数，使其返回空内容
if ( ! function_exists( 'astra_get_search_form' ) ) {
    function astra_get_search_form() {
        return '';
    }
}

这样当主题调用该函数时，只会返回空字符串，不会生成任何搜索表单代码。

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