剖析 WordPress `wp_loaded` 钩子的源码：它在核心加载流程中扮演什么角色。

咳咳，各位观众老爷们，晚上好！我是你们的老朋友，今儿个咱们来聊聊 WordPress 里一个神秘又关键的钩子：wp_loaded。 别看它名字平平无奇，实际上它在 WordPress 的核心加载流程中扮演着举足轻重的角色。 很多时候，你写的插件或者主题功能没生效，八成就是没摸清这个钩子的脾气。 别慌，今晚我就把它的老底给你们扒个精光，保证你们以后用得顺手。

一、WordPress 加载流程简述：像搭积木一样

想理解 wp_loaded，咱们得先对 WordPress 的加载流程有个大概的认识。 简单来说，WordPress 加载就像搭积木一样，一步一步把各种模块组装起来，最终呈现出一个完整的网站。 下面这张表可以帮助你理解：

阶段	关键文件/函数	主要任务
1. 加载核心文件	wp-config.php, wp-settings.php	定义常量，加载数据库连接信息，加载核心函数库，设置时区等。
2. 加载插件	wp-settings.php (通过 plugins_loaded 钩子)	加载已激活的插件，执行插件的初始化代码。 这个阶段插件可以注册钩子，定义函数，但不能依赖用户身份验证、主题等信息，因为这些还没加载。
3. 加载主题	wp-settings.php (通过 setup_theme 钩子)	加载当前主题，执行主题的 functions.php 文件，设置主题特性（如特色图像、导航菜单等）。
4. wp_loaded	wp-settings.php	一个信号！表示 WordPress 核心、插件和主题的基本框架已经加载完毕，可以开始进行更复杂的操作，比如根据用户身份验证结果进行权限判断，处理用户请求等。
5. template_redirect	template-loader.php	根据请求的 URL 确定要加载的模板文件。
6. 显示页面	模板文件 (index.php, single.php 等)	根据数据生成 HTML 代码，最终呈现给用户。

二、wp_loaded 钩子：姗姗来迟的关键先生

wp_loaded 钩子在 wp-settings.php 文件中被触发。 咱们来看一下 wp-settings.php 的源码片段：

// wp-settings.php 的片段

// Require Multisite boot file, loads wp-content/advanced-cache.php if present
if ( is_multisite() ) {
    require( ABSPATH . WPINC . '/ms-settings.php' );
}

// Define constants that rely on the API to obtain the default value.
// Including plugin and load order constants.
define( 'WP_CONTENT_URL', get_option('siteurl') . '/wp-content');
define( 'WP_PLUGIN_DIR', WP_CONTENT_DIR . '/plugins' );
define( 'WP_PLUGIN_URL', WP_CONTENT_URL . '/plugins' );

// 其他代码...

// Load the L10N support.
require_once( ABSPATH . 'wp-includes/l10n.php' );

// Run the installer if wp-config.php exists but install.php doesn't.
if ( file_exists( ABSPATH . 'wp-config.php' ) && ! file_exists( ABSPATH . 'wp-admin/install.php' ) ) {
    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    wp_check_mysql_version();
    wp_load_translations_early();
}

// Allow plugins to use wp_redirect during init.
do_action( 'init' );

// Set up current user.
$GLOBALS['wp']->init();

// Custom Post Types
do_action( 'wp_loaded' ); // 关键先生闪亮登场！

看到了没？ do_action( 'wp_loaded' ) 这行代码就是触发 wp_loaded 钩子的关键。

那么，为什么 wp_loaded 如此重要呢？

因为在 wp_loaded 之前，有些关键信息还没加载完毕，比如用户身份验证信息。 如果你的插件或主题代码需要用到这些信息，就必须等到 wp_loaded 之后才能执行。

三、wp_loaded 的应用场景：哪里需要哪里搬

wp_loaded 钩子就像一块砖，哪里需要哪里搬。 常见的应用场景包括：

1. 处理用户请求： 根据用户身份验证结果，进行权限判断，比如限制某些用户访问特定页面或功能。

2. 初始化主题或插件的某些功能： 比如加载主题的某些配置，或者插件的某些模块。

3. 执行一些需要依赖 WordPress 核心功能的代码： 比如使用 WordPress 的数据库 API，或者访问 WordPress 的全局变量。

四、代码示例：手把手教你用 wp_loaded

光说不练假把式，咱们来几个代码示例，让你更直观地了解 wp_loaded 的用法。

示例 1：限制特定用户访问后台

假设我们想禁止 ID 为 1 的用户访问 WordPress 后台，可以这样写：

add_action( 'wp_loaded', 'restrict_admin_access' );

function restrict_admin_access() {
    $user = wp_get_current_user();

    if ( $user->ID == 1 && is_admin() ) {
        wp_safe_redirect( home_url() ); // 重定向到首页
        exit;
    }
}

这段代码的意思是：

• add_action( 'wp_loaded', 'restrict_admin_access' ): 将 restrict_admin_access 函数绑定到 wp_loaded 钩子上，意味着当 wp_loaded 钩子被触发时，restrict_admin_access 函数会被执行。
• restrict_admin_access(): 这个函数首先获取当前用户的信息，然后判断用户 ID 是否为 1，并且是否正在访问后台。 如果满足这两个条件，就将用户重定向到首页。

示例 2：加载插件的语言包

如果你开发的插件需要支持多语言，可以在 wp_loaded 钩子中加载插件的语言包：

add_action( 'wp_loaded', 'load_my_plugin_textdomain' );

function load_my_plugin_textdomain() {
    load_plugin_textdomain(
        'my-plugin', // 插件的 text domain
        false,
        dirname( plugin_basename( __FILE__ ) ) . '/languages/' // 语言包的路径
    );
}

这段代码的意思是：

• add_action( 'wp_loaded', 'load_my_plugin_textdomain' ): 将 load_my_plugin_textdomain 函数绑定到 wp_loaded 钩子上。
• load_my_plugin_textdomain(): 这个函数使用 load_plugin_textdomain() 函数加载插件的语言包。 'my-plugin' 是插件的 text domain，用于区分不同的语言包。 dirname( plugin_basename( __FILE__ ) ) . '/languages/' 是语言包的路径，通常放在插件目录下的 languages 文件夹中。

示例 3：根据用户角色显示不同的内容

假设你想根据用户的角色，在网站上显示不同的内容，可以这样写：

add_action( 'wp_loaded', 'show_content_based_on_role' );

function show_content_based_on_role() {
    $user = wp_get_current_user();

    if ( in_array( 'administrator', (array) $user->roles ) ) {
        // 管理员显示的内容
        echo '<p>欢迎管理员！</p>';
    } else {
        // 其他用户显示的内容
        echo '<p>欢迎普通用户！</p>';
    }
}

这段代码的意思是：

• add_action( 'wp_loaded', 'show_content_based_on_role' ): 将 show_content_based_on_role 函数绑定到 wp_loaded 钩子上。
• show_content_based_on_role(): 这个函数首先获取当前用户的信息，然后判断用户是否是管理员。 如果是管理员，就显示 "欢迎管理员！"，否则显示 "欢迎普通用户！"。

五、wp_loaded vs init：傻傻分不清楚？

很多同学可能会把 wp_loaded 和 init 钩子搞混，觉得它们好像差不多。 别急，我来给你捋一捋：

• init 钩子： 在 wp-settings.php 中，wp 对象初始化之前被触发。 主要用于注册自定义文章类型、分类法，以及执行一些初始化操作。 在这个阶段，用户身份验证信息还没有完全加载完毕。
• wp_loaded 钩子： 在 wp-settings.php 中，wp 对象初始化之后被触发。 在这个阶段，WordPress 核心、插件和主题的基本框架已经加载完毕，用户身份验证信息也已经可用。

简单来说，init 钩子更早，主要用于注册和初始化； wp_loaded 钩子更晚，主要用于处理用户请求和执行一些需要依赖 WordPress 核心功能的代码。

你可以把 init 想象成盖房子的地基，wp_loaded 想象成房子盖好之后，开始装修和入住。

六、总结：wp_loaded，你的 WordPress 好帮手

好了，讲了这么多，相信你对 wp_loaded 钩子已经有了更深入的了解。 记住，wp_loaded 钩子是 WordPress 核心加载流程中的一个关键节点，它标志着 WordPress 核心、插件和主题的基本框架已经加载完毕，可以开始进行更复杂的操作。 在开发 WordPress 插件或主题时，合理利用 wp_loaded 钩子，可以让你更好地控制代码的执行时机，避免出现一些意想不到的问题。

总而言之，wp_loaded 钩子是你的 WordPress 好帮手，用好了它，你的代码就能更流畅、更稳定地运行。

今天的讲座就到这里，谢谢大家的收听！ 如果有什么疑问，欢迎随时提问。 祝大家编程愉快！