分析 WordPress `wp_loaded` 钩子的源码：它在 WordPress 加载流程中处于哪个阶段，以及其在插件初始化中的作用。

各位观众，各位朋友，欢迎来到今天的 WordPress 源码小讲堂！我是你们的老朋友，代码界的段子手，今天咱们要聊的是 WordPress 世界里一个默默奉献却又至关重要的角色 —— wp_loaded 钩子。

准备好了吗？咱们这就开始解剖这个钩子，看看它到底是个什么来头，又在咱们的插件开发中扮演着什么样的角色。

一、WordPress 加载流程简述：故事的开端

要理解 wp_loaded 的作用，咱们得先简单过一下 WordPress 的加载流程。想象一下，你打开一个 WordPress 网站，背后发生的事情就像一场精心编排的舞台剧。

wp-config.php：剧本的开端
- 这是整个剧本的开端，定义了数据库连接信息、安全密钥等关键参数。就像戏曲开场前的锣鼓，告诉你“好戏要开始了！”
wp-settings.php：演员就位
- 加载 WordPress 核心文件，设置常量，包含函数库，并开始加载插件。演员们开始陆续登场，准备就绪。
wp-load.php：舞台搭建
- 它负责引导 WordPress 加载过程，确保所有必要的组件都加载完毕。舞台搭建完毕，灯光就位，只等主角登场。
wp() 函数：剧情展开
- 这是 WordPress 的核心函数，它会根据请求的 URL 解析请求类型，并加载相应的模板。剧情正式展开，高潮迭起。
各种 Actions 和 Filters：即兴表演
- 在整个加载过程中，WordPress 提供了大量的 Actions 和 Filters，允许插件和主题修改 WordPress 的行为。演员们可以根据剧本进行即兴发挥，让剧情更加精彩。

二、wp_loaded：大幕拉开的信号

现在，重点来了，wp_loaded 钩子就出现在 wp-settings.php 文件的末尾。就像舞台剧的大幕拉开，演员们全部就位，灯光音响一切准备就绪，正式演出开始！

让我们看看 wp-settings.php 文件的相关代码片段：

// wp-settings.php (部分代码)

// ... 前面的代码 ...

// Load the functions for the current theme, after the theme is initiated.
if ( ! defined( 'WP_INSTALLING' ) || 'WP_INSTALLING' !== WP_INSTALLING ) {
    if ( TEMPLATEPATH !== ABSPATH . WPINC ) {
        require( ABSPATH . WPINC . '/template-loader.php' );
    }
}

/**
 * Fires once WP has loaded.
 *
 * @since 2.3.0
 */
do_action( 'wp_loaded' );

看到了吗？ do_action( 'wp_loaded' ) 这行代码，它触发了 wp_loaded 钩子。这意味着，当 WordPress 完成了大部分核心文件的加载，并且已经确定了当前使用的主题后，wp_loaded 钩子就会被触发。

三、wp_loaded 在插件初始化中的作用：最佳时机

那么，wp_loaded 钩子在插件初始化中到底有什么作用呢？简单来说，它提供了一个非常好的时机来执行一些需要在 WordPress 核心加载完毕后才能执行的代码。

插件依赖检查：确保万事俱备

有些插件可能依赖于其他的插件或 WordPress 的某些特定功能。在 wp_loaded 钩子中，你可以检查这些依赖关系是否满足，如果不满足，可以优雅地禁用你的插件，或者显示一个友好的提示信息。

add_action( 'wp_loaded', 'my_plugin_check_dependencies' );

function my_plugin_check_dependencies() {
    if ( ! class_exists( 'Some_Other_Plugin_Class' ) ) {
        // 依赖的插件未激活，禁用当前插件
        deactivate_plugins( plugin_basename( __FILE__ ) );
        add_action( 'admin_notices', 'my_plugin_dependency_notice' );
    }
}

function my_plugin_dependency_notice() {
    echo '<div class="error"><p>My Plugin requires Some Other Plugin to be active.</p></div>';
}

这段代码检查了 Some_Other_Plugin_Class 是否存在，如果不存在，就禁用当前插件，并显示一个管理后台的提示信息。

加载翻译文件：让你的插件说多种语言

如果你的插件需要支持多种语言，那么在 wp_loaded 钩子中加载翻译文件是一个不错的选择。
```
add_action( 'wp_loaded', 'my_plugin_load_textdomain' );

function my_plugin_load_textdomain() {
    load_plugin_textdomain( 'my-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
}
```
这段代码加载了 my-plugin 插件的翻译文件，让你的插件可以根据用户的语言设置显示不同的文本。

注册自定义文章类型和分类法：构建你的内容世界

如果你需要在插件中注册自定义文章类型或分类法，那么在 wp_loaded 钩子中进行注册也是一个不错的选择。

add_action( 'wp_loaded', 'my_plugin_register_post_type' );

function my_plugin_register_post_type() {
    register_post_type( 'my_custom_post_type',
        array(
            'labels' => array(
                'name' => __( 'My Custom Post Types' ),
                'singular_name' => __( 'My Custom Post Type' )
            ),
            'public' => true,
            'has_archive' => true,
            'rewrite' => array( 'slug' => 'my-custom-post-type' ),
            'supports' => array( 'title', 'editor', 'thumbnail' )
        )
    );
}

这段代码注册了一个名为 my_custom_post_type 的自定义文章类型。

初始化 Session：记住用户的足迹

如果你需要在插件中使用 Session 来存储用户的状态信息，那么在 wp_loaded 钩子中初始化 Session 是一个常见的做法。
```
add_action( 'wp_loaded', 'my_plugin_init_session' );

function my_plugin_init_session() {
    if ( ! session_id() ) {
        session_start();
    }
}
```
这段代码检查 Session 是否已经启动，如果没有启动，就启动 Session。

四、wp_loaded 与其他钩子的比较：选择合适的舞台

WordPress 提供了大量的 Actions 和 Filters，那么为什么我们要选择 wp_loaded 呢？它和其他常用的钩子有什么区别呢？咱们来做个对比：

钩子名称	触发时机	适用场景	注意事项
`plugins_loaded`	在所有插件加载完毕后触发。	插件依赖检查，加载插件的公共函数库。	早于 `wp_loaded`，但此时 WordPress 核心还没有完全加载完毕，因此不适合执行需要依赖 WordPress 核心功能的代码。
`after_setup_theme`	在主题加载完毕后触发。	设置主题支持的功能，如自定义菜单、特色图像等。	主要用于主题开发，插件一般不使用此钩子。
`init`	在 WordPress 初始化完成后触发。	注册自定义文章类型和分类法，初始化 Session。	晚于 `wp_loaded`，但早于 `wp`，此时 WordPress 已经完成了大部分的初始化工作。
`wp_loaded`	在 WordPress 完成大部分核心文件的加载，并且已经确定了当前使用的主题后触发。	插件依赖检查，加载翻译文件，注册自定义文章类型和分类法，初始化 Session。	介于 `plugins_loaded` 和 `init` 之间，提供了一个很好的平衡点，既保证了 WordPress 核心已经加载完毕，又不会太晚导致某些操作无法正常执行。
`wp`	在 WordPress 完成查询解析后触发。	根据请求类型加载相应的模板。	晚于 `wp_loaded` 和 `init`，主要用于主题开发，插件一般不使用此钩子。

总的来说，wp_loaded 钩子就像一个黄金分割点，它提供了一个非常好的时机来执行一些需要在 WordPress 核心加载完毕后才能执行的代码，同时又不会太晚导致某些操作无法正常执行。

五、wp_loaded 的最佳实践：优雅的代码风格

在使用 wp_loaded 钩子时，我们应该遵循一些最佳实践，以确保我们的代码优雅、高效、易于维护。

避免在 wp_loaded 钩子中执行耗时的操作：
- wp_loaded 钩子在 WordPress 加载流程的关键路径上，如果在其中执行耗时的操作，会影响网站的加载速度。
- 如果必须执行耗时的操作，可以考虑使用异步任务或缓存来优化性能。
使用 is_admin() 函数判断是否在管理后台：
- 有些代码只需要在管理后台执行，可以使用 is_admin() 函数来判断当前是否在管理后台。
- 这样可以避免在前端执行不必要的代码，提高网站的性能。
```
add_action( 'wp_loaded', 'my_plugin_admin_only_function' );

function my_plugin_admin_only_function() {
    if ( is_admin() ) {
        // 只在管理后台执行的代码
        // ...
    }
}
```
使用 defined( 'DOING_AJAX' ) && DOING_AJAX 判断是否在 AJAX 请求中：
- 有些代码只需要在 AJAX 请求中执行，可以使用 defined( 'DOING_AJAX' ) && DOING_AJAX 来判断当前是否在 AJAX 请求中。
- 这样可以避免在非 AJAX 请求中执行不必要的代码，提高网站的性能。
```
add_action( 'wp_loaded', 'my_plugin_ajax_only_function' );

function my_plugin_ajax_only_function() {
    if ( defined( 'DOING_AJAX' ) && DOING_AJAX ) {
        // 只在 AJAX 请求中执行的代码
        // ...
    }
}
```
使用适当的优先级：
- add_action() 函数可以指定优先级，优先级越低，执行顺序越早。
- 根据你的代码的依赖关系，选择合适的优先级，以确保代码按照正确的顺序执行。

六、总结：wp_loaded，插件开发的得力助手

好了，各位朋友，今天的 wp_loaded 钩子之旅就到这里了。我们了解了 wp_loaded 钩子在 WordPress 加载流程中的位置，以及它在插件初始化中的作用。记住，wp_loaded 就像一个可靠的信使，它会在 WordPress 完成大部分核心文件的加载后，及时通知你，让你可以在最佳时机执行你的代码。

希望今天的讲解对你有所帮助，如果你在插件开发中遇到了问题，不妨回头看看 wp_loaded 钩子，也许它就是你苦苦寻找的答案。

下次再见，祝大家编程愉快！

发表回复 取消回复

发表回复取消回复