WordPress 维护模式下排除特定页面的正确实现方法-php教程-PHP中文网

WordPress 维护模式下排除特定页面的正确实现方法

本文详解如何在 WordPress 自定义维护模式插件中，安全、可靠地排除指定页面（如登录页、调研页等）不显示维护页面，重点解决 is_page() 在早期钩子中不可用的问题及正确挂载时机。

本文详解如何在 wordpress 自定义维护模式插件中，安全、可靠地排除指定页面（如登录页、调研页等）不显示维护页面，重点解决 `is_page()` 在早期钩子中不可用的问题及正确挂载时机。

在 WordPress 开发中，为网站启用临时维护模式是常见需求，但必须确保关键页面（如 /wp-login.php、用户注册页、邮件订阅页、问卷调查页等）仍可正常访问。原始代码使用 wp_loaded 钩子配合 is_admin() 和 $pagenow 判断，虽能排除后台和登录页，却无法直接使用 is_page()——因为此时 WordPress 主题与全局查询（$wp_query）尚未完全初始化，is_page() 等条件标签尚不可用，强行调用将始终返回 false。

✅ 正确解法：分层判断 + 延迟挂载

核心思路是：

Wordpress REST API

OpenClaw技能，提供WordPress REST API命令行工具，支持通过原生HTTP处理文章、页面、分类、标签、用户及自定义请求。

下载

先用早期可用的变量（如 $pagenow、$_SERVER['REQUEST_URI']）快速排除明确路径（如 wp-login.php）；
对需依赖 is_page() 的页面（如自定义页面 survey），改用 template_redirect 或 wp 钩子——此时主查询已就绪，is_page() 完全可用；
避免在 wp_loaded 中直接调用 is_page()，而是重构逻辑，在合适时机执行维护拦截。

以下是推荐的优化实现：

function ng_maintenance_mode() {
    // 1. 快速排除：登录页、后台、管理员用户（早期即可判断）
    global $pagenow;
    if ( $pagenow === 'wp-login.php' || is_admin() || current_user_can( 'manage_options' ) ) {
        return;
    }

    // 2. 检查是否为需豁免的前端页面（如 slug 为 'survey' 的页面）
    // 注意：此处必须在 wp 或 template_redirect 钩子中运行，确保 is_page() 可用
    if ( is_page( 'survey' ) || is_page( 'opt-in' ) || is_page( 'thank-you' ) ) {
        return;
    }

    // 3. 触发维护响应头并加载维护页
    status_header(503);
    header('Content-Type: text/html; charset=utf-8');
    $maintenance_file = plugin_dir_path(__FILE__) . 'views/maintenance.php';
    if (file_exists($maintenance_file)) {
        require_once $maintenance_file;
    }
    exit;
}

// 关键：挂载到 wp 钩子（而非 wp_loaded），确保主查询已初始化
add_action('wp', 'ng_maintenance_mode');

? 重要注意事项：

❌ 不要将 is_page() 放在 wp_loaded 回调内——该钩子触发时 $wp_query 尚未设置，is_page() 必然失效；
✅ wp 钩子在 WP::main() 执行后、模板加载前触发，此时所有条件标签（is_page()、is_home()、is_singular() 等）均已可靠可用；

? 若需排除多个页面，建议使用数组形式提升可维护性：

$excluded_pages = ['survey', 'opt-in', 'contact', 'privacy-policy'];
if (is_page() && in_array(get_queried_object()->post_name, $excluded_pages)) {
    return;
}