分析 WordPress `do_action(‘plugins_loaded’)` 的源码：此钩子在何时被触发，以及其重要性。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

咳咳，各位观众老爷，今天咱们不聊风花雪月，来点硬核的。今天的主题是 WordPress 的 do_action('plugins_loaded')，一个经常被忽视，但又极其重要的钩子。别看它名字平平无奇，但它可是插件世界的“定海神针”之一。接下来，就让咱们一起扒一扒它的源码，看看它到底在什么时候被触发，以及为什么它这么重要。

源码探秘：`plugins_loaded` 的触发时间

要了解一个钩子的重要性，首先得知道它在什么时候“冒出来”。plugins_loaded 这个钩子是在 WordPress 的核心启动流程中被触发的，具体来说，是在 wp-settings.php 文件里。

我们先简单回顾一下 WordPress 的启动流程（简化版）：

wp-config.php：定义数据库连接信息、路径等。
wp-settings.php：加载 WordPress 核心文件，初始化各种全局变量、常量等。
wp-load.php：包含 wp-settings.php，定义一些常用函数。
wp-blog-header.php：加载主题文件，开始渲染页面。

plugins_loaded 就藏在 wp-settings.php 这个看似平淡的文件里。打开你的 WordPress 安装目录，找到 wp-settings.php，然后搜索 do_action( 'plugins_loaded' )，你就能找到它的身影。

// wp-settings.php (简化版)

// ... 大量的初始化代码 ...

// Load active plugins.
foreach ( wp_get_active_and_valid_plugins() as $plugin ) {
    include_once( $plugin );
}

// Fires after plugins are loaded.
do_action( 'plugins_loaded' );

// ... 剩下的初始化代码 ...

看到没？do_action( 'plugins_loaded' ) 就在加载所有启用的插件之后，才被触发。这意味着什么呢？这意味着，当这个钩子被触发的时候，所有的插件都已经加载到内存里了，但是插件的代码可能还没有完全执行完毕。

为什么我说“可能还没有完全执行完毕”呢？因为插件加载的方式是 include_once()，这仅仅是把插件的文件包含进来。插件内部可能还有其他函数或者类的定义，而这些定义只有在被调用的时候才会真正执行。

重要性分析：为什么 `plugins_loaded` 如此关键？

现在我们知道了 plugins_loaded 的触发时间，接下来就要聊聊它的重要性了。简单来说，plugins_loaded 提供了一个非常好的时机，让插件之间可以互相“认识”，并且安全地进行交互。

1. 插件依赖管理

想象一下，如果你的插件 A 依赖于插件 B 的某个函数，那么插件 A 必须确保插件 B 已经加载并且函数已经定义，才能安全地调用。plugins_loaded 就提供了一个完美的时机来做这件事。

// 插件 A 的代码 (假设它依赖于插件 B 的 my_plugin_b_function 函数)

add_action( 'plugins_loaded', 'my_plugin_a_init' );

function my_plugin_a_init() {
    if ( function_exists( 'my_plugin_b_function' ) ) {
        // 插件 B 的函数已经定义，可以安全地调用
        $result = my_plugin_b_function( 'hello' );
        echo '插件 B 的返回结果：' . $result;
    } else {
        // 插件 B 的函数未定义，显示错误信息
        echo '插件 A 需要插件 B 才能正常工作！';
    }
}

在这个例子中，插件 A 通过 plugins_loaded 钩子来检查插件 B 的函数是否存在。如果存在，就安全地调用；如果不存在，就提示用户。这避免了插件 A 因为缺少依赖而崩溃。

2. 插件间的 API 共享

很多插件会提供一些 API 供其他插件调用。plugins_loaded 提供了一个理想的时机来注册这些 API。

// 插件 B 的代码 (提供一个 API 函数)

function my_plugin_b_function( $message ) {
    return '插件 B 说：' . $message;
}

// 插件 C 的代码 (使用插件 B 的 API)

add_action( 'plugins_loaded', 'my_plugin_c_init' );

function my_plugin_c_init() {
    if ( function_exists( 'my_plugin_b_function' ) ) {
        $result = my_plugin_b_function( '你好' );
        echo '插件 C 调用插件 B 的结果：' . $result;
    } else {
        echo '插件 C 需要插件 B 才能正常工作！';
    }
}

在这个例子中，插件 B 定义了一个 my_plugin_b_function 函数，作为 API 供其他插件调用。插件 C 通过 plugins_loaded 钩子来检查该函数是否存在，并安全地调用。

3. 国际化 (i18n) 加载

WordPress 的国际化功能允许你的插件支持多种语言。通常情况下，插件会在 plugins_loaded 钩子中加载它的语言包。

// 插件 D 的代码 (加载语言包)

add_action( 'plugins_loaded', 'my_plugin_d_load_textdomain' );

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

在这个例子中，插件 D 使用 load_plugin_textdomain() 函数来加载它的语言包。这个函数会根据用户的语言设置，加载相应的 .mo 文件。

4. 插件设置初始化

有些插件需要在所有插件加载完毕后，进行一些全局设置的初始化。plugins_loaded 也是一个合适的时机。

// 插件 E 的代码 (初始化全局设置)

add_action( 'plugins_loaded', 'my_plugin_e_init_settings' );

function my_plugin_e_init_settings() {
    global $my_plugin_e_settings;

    $my_plugin_e_settings = get_option( 'my_plugin_e_settings' );

    if ( ! is_array( $my_plugin_e_settings ) ) {
        $my_plugin_e_settings = array(
            'option_1' => 'default_value_1',
            'option_2' => 'default_value_2',
        );
        update_option( 'my_plugin_e_settings', $my_plugin_e_settings );
    }
}

在这个例子中，插件 E 在 plugins_loaded 钩子中，从数据库中读取插件的设置，如果设置不存在，则初始化默认值。

5. 解决插件冲突

虽然 plugins_loaded 不能完全避免插件冲突，但它可以提供一个机会来检测和缓解一些冲突。例如，你可以检查是否有其他插件也在使用相同的函数名或类名，并采取相应的措施，比如重命名你的函数或类。

`plugins_loaded` vs. 其他钩子：该如何选择？

WordPress 提供了很多钩子，那么我们为什么要选择 plugins_loaded 呢？它和其他钩子有什么区别呢？

| 钩子名称 | 触发时间 | 适用场景

源码探秘：plugins_loaded 的触发时间

重要性分析：为什么 plugins_loaded 如此关键？