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

WordPress wp_loaded 钩子：插件初始化的黄金时刻

大家好！我是你们今天的讲师，很高兴能和大家聊聊 WordPress 的 wp_loaded 钩子。这可不是一个随便的钩子，它在 WordPress 的加载流程中扮演着关键角色，尤其是对于插件的初始化来说，它简直就是黄金时刻。今天，我们就来扒一扒它的源码，看看它到底藏着什么秘密，以及我们如何利用它来让我们的插件更上一层楼。

WordPress 加载流程：一场精心编排的舞台剧

首先，我们要对 WordPress 的加载流程有一个大致的了解。你可以把它想象成一场精心编排的舞台剧，每个阶段都有特定的任务和角色。简单来说，这个流程可以分为以下几个阶段：

1. wp-config.php：剧本的开始。这个文件定义了数据库连接信息、调试模式等等，相当于剧本的开头，告诉 WordPress 接下来该怎么演。

2. wp-settings.php：演员就位。这个文件加载了 WordPress 的核心文件，包括函数库、类等等，相当于演员们各就各位，准备登台。

3. wp-load.php：舞台搭建完成。这个文件加载了 wp-config.php 和 wp-settings.php，相当于舞台搭建完成，准备开始表演。

4. wp-includes/functions.php：导演登场。这个文件包含了 WordPress 的核心函数，相当于导演开始指挥演员，推动剧情发展。

5. WP 类实例化：剧情开始展开。WP 类负责解析 URL、处理请求、查询数据库等等，相当于剧情开始展开，各种事件开始发生。

6. 插件加载：配角登场。WordPress 会加载已经激活的插件，相当于配角们陆续登场，丰富剧情。

7. 主题加载：主角亮相。WordPress 会加载当前主题，相当于主角终于亮相，剧情进入高潮。

8. 模板加载：高潮迭起。WordPress 会根据请求加载相应的模板文件，相当于剧情进入高潮，各种场景切换。

9. 输出：落幕。WordPress 将最终的 HTML 输出到浏览器，相当于舞台剧落幕，观众鼓掌。

而我们的主角 wp_loaded 钩子，就藏在插件加载和主题加载之间。它就像一个重要的幕间休息，让插件们有机会做一些准备工作，迎接即将到来的主角——主题。

wp_loaded 钩子的源码探秘：它到底在哪里？

要找到 wp_loaded 钩子，我们需要深入 WordPress 的源码。打开 wp-settings.php 文件（这个文件是 WordPress 加载流程的关键），你会发现以下代码：

// Fires after WordPress has finished loading but before any headers are sent.
// Useful for intercepting actions on wp-login.php.
do_action( 'wp_loaded' );

这段代码非常简单，就是调用了 do_action('wp_loaded')。do_action 函数是 WordPress 中触发钩子的核心函数，它会将所有注册到 wp_loaded 钩子上的函数都执行一遍。

所以，wp_loaded 钩子的源码其实就是这一行代码。它表明，在 WordPress 完成加载后，但在发送任何头部信息之前，会触发 wp_loaded 钩子。

wp_loaded 钩子的作用：插件初始化的黄金时刻

那么，wp_loaded 钩子有什么作用呢？为什么说它是插件初始化的黄金时刻呢？

• 更早的初始化时机：相对于其他钩子，比如 init，wp_loaded 触发得更早。这意味着你可以在 wp_loaded 钩子上注册你的插件初始化函数，确保你的插件在其他插件和主题之前完成初始化。

• 访问核心函数和类：在 wp_loaded 钩子触发时，WordPress 的核心函数和类都已经加载完毕，你可以放心地使用它们。

• 处理一些全局性的任务：比如，你可以使用 wp_loaded 钩子来加载插件的语言包，注册自定义的 post type，或者执行一些需要全局配置的任务。

• 兼容性更好：由于 wp_loaded 触发得比较早，可以减少插件之间的冲突。

wp_loaded 钩子的使用方法：代码示例

现在，让我们来看一些代码示例，看看如何使用 wp_loaded 钩子。

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

<?php
/**
 * Plugin Name: My Awesome Plugin
 * Description: This is an awesome plugin.
 * Version: 1.0.0
 */

add_action( 'wp_loaded', 'my_awesome_plugin_load_textdomain' );

function my_awesome_plugin_load_textdomain() {
    load_plugin_textdomain( 'my-awesome-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
}

这段代码首先定义了一个插件的基本信息，然后使用 add_action 函数将 my_awesome_plugin_load_textdomain 函数注册到 wp_loaded 钩子上。my_awesome_plugin_load_textdomain 函数负责加载插件的语言包。

示例 2：注册自定义的 post type

<?php
/**
 * Plugin Name: My Awesome Plugin
 * Description: This is an awesome plugin.
 * Version: 1.0.0
 */

add_action( 'wp_loaded', 'my_awesome_plugin_register_post_type' );

function my_awesome_plugin_register_post_type() {
    $labels = array(
        'name'               => _x( 'Books', 'post type general name', 'my-awesome-plugin' ),
        'singular_name'      => _x( 'Book', 'post type singular name', 'my-awesome-plugin' ),
        'menu_name'          => _x( 'Books', 'admin menu', 'my-awesome-plugin' ),
        'name_admin_bar'     => _x( 'Book', 'add new on admin bar', 'my-awesome-plugin' ),
        'add_new'            => _x( 'Add New', 'book', 'my-awesome-plugin' ),
        'add_new_item'       => __( 'Add New Book', 'my-awesome-plugin' ),
        'new_item'           => __( 'New Book', 'my-awesome-plugin' ),
        'edit_item'          => __( 'Edit Book', 'my-awesome-plugin' ),
        'view_item'          => __( 'View Book', 'my-awesome-plugin' ),
        'all_items'          => __( 'All Books', 'my-awesome-plugin' ),
        'search_items'       => __( 'Search Books', 'my-awesome-plugin' ),
        'parent_item_colon'  => __( 'Parent Books:', 'my-awesome-plugin' ),
        'not_found'          => __( 'No books found.', 'my-awesome-plugin' ),
        'not_found_in_trash' => __( 'No books found in Trash.', 'my-awesome-plugin' )
    );

    $args = array(
        'labels'             => $labels,
        'public'             => true,
        'publicly_queryable' => true,
        'show_ui'            => true,
        'show_in_menu'       => true,
        'query_var'          => true,
        'rewrite'            => array( 'slug' => 'book' ),
        'capability_type'    => 'post',
        'has_archive'        => true,
        'hierarchical'       => false,
        'menu_position'      => null,
        'supports'           => array( 'title', 'editor', 'author', 'thumbnail', 'excerpt', 'comments' )
    );

    register_post_type( 'book', $args );
}

这段代码使用 wp_loaded 钩子来注册一个名为 book 的自定义 post type。

示例 3：执行一些需要全局配置的任务

<?php
/**
 * Plugin Name: My Awesome Plugin
 * Description: This is an awesome plugin.
 * Version: 1.0.0
 */

add_action( 'wp_loaded', 'my_awesome_plugin_global_config' );

function my_awesome_plugin_global_config() {
    // 检查是否已经设置了某个选项
    if ( ! get_option( 'my_awesome_plugin_option' ) ) {
        // 如果没有设置，则设置一个默认值
        update_option( 'my_awesome_plugin_option', 'default_value' );
    }
}

这段代码使用 wp_loaded 钩子来检查是否已经设置了某个选项，如果没有设置，则设置一个默认值。

wp_loaded 与 init 的比较：选择哪个钩子？

很多开发者可能会疑惑，wp_loaded 和 init 都是常用的初始化钩子，那么我们应该选择哪个呢？

特性	wp_loaded	init
触发时间	WordPress 完成加载后，发送头部信息之前。	WordPress 初始化完成后。
用途	加载语言包，注册 post type，全局配置。	处理用户身份验证，注册脚本和样式，创建短代码。
优势	初始化时机更早，兼容性更好。	更加灵活，可以访问更多的 WordPress 功能。
劣势	无法访问一些在 init 阶段才加载的功能。	初始化时机较晚，可能与其他插件冲突。

简单来说，如果你需要尽早地进行一些全局性的配置，那么 wp_loaded 是一个不错的选择。如果你需要访问一些在 init 阶段才加载的功能，或者需要处理用户身份验证等任务，那么 init 更加适合。

使用 wp_loaded 的注意事项：避免踩坑

虽然 wp_loaded 钩子非常有用，但在使用时也需要注意一些事项，避免踩坑。

• 避免过度使用：不要在 wp_loaded 钩子上执行过于复杂的任务，这可能会影响 WordPress 的加载速度。

• 注意钩子的执行顺序：wp_loaded 钩子上的函数会按照注册的顺序执行，因此你需要注意钩子的执行顺序，避免出现依赖关系问题。

• 避免与主题冲突：虽然 wp_loaded 触发得比较早，但仍然有可能与主题冲突。因此，你需要测试你的插件在各种主题下的兼容性。

总结：wp_loaded 是插件开发的利器

总而言之，wp_loaded 钩子是 WordPress 插件开发的一个利器。它可以让你在 WordPress 加载流程的早期阶段进行初始化，确保你的插件能够正常运行。掌握 wp_loaded 钩子的使用方法，可以让你编写出更加高效、兼容性更好的 WordPress 插件。

希望今天的讲座对你有所帮助！下次再见！