阐述 WordPress `wp-settings.php` 的源码：它是如何通过 `require_once` 链式加载所有核心文件的。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位，系好安全带，今天咱们来一场刺激的 WordPress 源码之旅，目的地是 WordPress 启动的心脏——wp-settings.php。

开场白：WordPress，启动！

想象一下，你打开一个网站，浏览器发出“嗡嗡嗡”的请求，服务器开始忙碌起来。对于 WordPress 网站来说，这个忙碌的起点往往就是 index.php。而 index.php 里，最重要的一行代码，通常是：

<?php
/**
 * Front to the WordPress application. This file doesn't do anything, but loads
 * wp-blog-header.php which in turn loads the WordPress environment.
 *
 * @package WordPress
 */

/**
 * Tells WordPress to load the WordPress theme and output it.
 *
 * @var bool
 */
define( 'WP_USE_THEMES', true );

/** Loads the WordPress Environment and Template */
require __DIR__ . '/wp-blog-header.php';

瞧见没？require __DIR__ . '/wp-blog-header.php';。wp-blog-header.php 才是真正的幕后大佬，而它又会毫不犹豫地把启动的重任交给 wp-settings.php。所以，wp-settings.php 可以说是 WordPress 启动过程中最重要的文件之一。它就像一个精密的指挥中心，负责加载各种核心文件，初始化各种配置，为 WordPress 的顺利运行奠定基础。

第一站：拨开迷雾，wp-settings.php 初探

打开你的 WordPress 安装目录，找到 wp-settings.php。乍一看，代码密密麻麻，让人头皮发麻。别慌，咱们一步一步来。

首先，wp-settings.php 的主要任务可以概括为：

定义常量： 设置各种全局常量，例如 WordPress 版本、路径信息等。
加载核心文件： 通过 require_once 链式加载各种重要的 PHP 文件，包括数据库连接、插件 API、主题 API 等。
初始化全局变量： 创建并初始化一些重要的全局变量，例如 $wpdb (数据库对象)、$wp (主查询对象) 等。
设置时区： 根据 WordPress 设置，设置 PHP 的时区。
加载插件： 加载已激活的插件。
加载主题： 加载当前使用的主题。

接下来，咱们深入代码，看看 wp-settings.php 是如何完成这些任务的。

第二站：常量定义，奠定基础

wp-settings.php 一开始就定义了一堆常量，这些常量就像是盖房子的地基，为后续的加载和初始化提供了必要的信息。

// Define ABSPATH as this prevents endless loops re-requiring ABSPATH
if ( ! defined( 'ABSPATH' ) ) {
    define( 'ABSPATH', dirname( __FILE__ ) . '/' );
}

/** Sets up WordPress vars and included files. */
require_once ABSPATH . 'wp-config.php';

首先，它检查 ABSPATH 是否已经定义。ABSPATH 代表 WordPress 的根目录。如果未定义，则通过 dirname(__FILE__) 获取当前文件 (wp-settings.php) 的目录，并将其定义为 ABSPATH。

紧接着，它又加载了 wp-config.php，这个文件包含了数据库连接信息、调试设置等重要配置。

// Include files required for initialization.
require_once ABSPATH . 'wp-includes/load.php';
require_once ABSPATH . 'wp-includes/default-constants.php';
require_once ABSPATH . 'wp-includes/plugin.php';
require_once ABSPATH . 'wp-includes/pomo/mo.php';

这里，wp-settings.php 开始链式加载核心文件。wp-includes/load.php 负责加载一些基础函数和常量，wp-includes/default-constants.php 定义了更多的默认常量，wp-includes/plugin.php 提供了插件 API，wp-includes/pomo/mo.php 负责处理翻译文件（.mo 文件）。

第三站：核心文件加载，环环相扣

加载核心文件是 wp-settings.php 最重要的任务之一。这些文件包含了 WordPress 的核心功能，例如数据库操作、用户管理、文章管理等。

咱们以 wp-includes/load.php 为例，看看它是如何工作的。

wp-includes/load.php 主要负责以下几件事：

设置错误处理： 根据 WP_DEBUG 常量，设置 PHP 的错误报告级别。
加载多字节字符串支持： 如果服务器支持，加载多字节字符串函数。
加载一些基础函数： 例如 wp_debug_backtrace_summary()、wp_load_translations_early() 等。
定义一些重要函数： 例如 __() (翻译函数)、esc_attr__() (转义属性的翻译函数) 等。

wp-includes/load.php 也会加载其他文件，例如：

require( ABSPATH . WPINC . '/version.php' );

wp-includes/version.php 定义了 WordPress 的版本信息。

接下来，看看 wp-includes/default-constants.php。这个文件定义了大量的默认常量，例如：

WP_HOME: WordPress 的主页 URL。
WP_SITEURL: WordPress 的站点 URL。
WP_CONTENT_DIR: WordPress 内容目录的绝对路径。
WP_PLUGIN_DIR: WordPress 插件目录的绝对路径。
WP_CONTENT_URL: WordPress 内容目录的 URL。
WP_PLUGIN_URL: WordPress 插件目录的 URL。

这些常量在 WordPress 的各个地方都会用到，例如生成 URL、加载资源等。

再来看看 wp-includes/plugin.php。这个文件提供了插件 API，允许插件开发者扩展 WordPress 的功能。它定义了大量的函数，例如：

add_action(): 注册一个动作钩子。
add_filter(): 注册一个过滤器钩子。
do_action(): 执行一个动作钩子。
apply_filters(): 应用一个过滤器钩子。
plugins_url(): 获取插件目录的 URL。

这些函数是插件开发的基础。

第四站：数据库连接，数据之源

WordPress 是一个基于数据库的系统，因此，连接数据库是必不可少的。wp-settings.php 会加载 wp-config.php 文件，这个文件包含了数据库连接信息，例如数据库主机、数据库用户名、数据库密码等。

/** The name of the database for WordPress */
define( 'DB_NAME', 'database_name_here' );

/** MySQL database username */
define( 'DB_USER', 'username_here' );

/** MySQL database password */
define( 'DB_PASSWORD', 'password_here' );

/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

/** Database Charset to use in creating database tables. */
define( 'DB_CHARSET', 'utf8' );

/** The Database Collate type. Don't change this if in doubt. */
define( 'DB_COLLATE', '' );

在加载 wp-config.php 之后，wp-settings.php 会创建一个全局的数据库对象 $wpdb，用于执行数据库查询。

global $wpdb;

require_wp_db();

require_wp_db() 函数会加载 wp-includes/wp-db.php 文件，这个文件定义了 $wpdb 对象。$wpdb 对象提供了一系列方法，用于执行各种数据库操作，例如 query() (执行 SQL 查询)、get_results() (获取查询结果) 等。

第五站：加载插件，扩展无限

WordPress 的强大之处在于其丰富的插件生态系统。wp-settings.php 会加载已激活的插件，从而扩展 WordPress 的功能。

if ( ! defined( 'WP_INSTALLING' ) || WP_INSTALLING === false ) {
    /**
     * Fires before the plugins are loaded.
     *
     * @since 2.3.0
     */
    do_action( 'plugins_loaded' );

    // Measure Plugin Load Time.
    if ( WP_DEBUG ) {
        timer_start();
    }

    foreach ( wp_get_active_and_valid_plugins() as $plugin ) {
        do_action( 'activate_plugin: ' . $plugin );
        include_once( $plugin );
        do_action( 'after_plugin_loaded: ' . $plugin );
    }

    if ( WP_DEBUG ) {
        timer_stop();
        global $timestart;
        $load_time = timer_float( $timestart, timer_stop() );
        printf( /* translators: %s: Load time in seconds. */
            __( 'Plugins loaded in %s seconds.' ),
            number_format( $load_time, 3 )
        );
        echo '<br />';
    }

    /**
     * Fires after all plugins are loaded.
     *
     * @since 2.0.0
     */
    do_action( 'after_setup_theme' );
}

这段代码首先触发 plugins_loaded 动作钩子，允许其他代码在插件加载之前执行一些操作。然后，它遍历已激活的插件，并使用 include_once() 函数加载每个插件。在加载每个插件之前和之后，它分别触发 activate_plugin: $plugin 和 after_plugin_loaded: $plugin 动作钩子，允许插件执行一些初始化操作。

第六站：加载主题，展现个性

WordPress 的外观由主题决定。wp-settings.php 会加载当前使用的主题，从而展现 WordPress 的个性。

if ( ! defined( 'WP_INSTALLING' ) || WP_INSTALLING === false ) {
    if ( wp_recovery_mode() ) {
        add_filter( 'template_include', 'wp_recovery_mode_template' );
    } else {
        /**
         * Defines the templates.
         *
         * @since 4.7.0
         *
         * @param string $template The path of the template to include.
         */
        $template = apply_filters( 'template_include', 'template_include' );

        if ( validate_file( $template ) ) {
            wp_die(
                sprintf(
                /* translators: 1: Template name, 2: esc_url() */
                    __( 'Invalid template: %1$s. Back to <a href="%2$s">WordPress Administration</a>.' ),
                    esc_html( $template ),
                    esc_url( admin_url() )
                )
            );
        }

        /**
         * Fires before the theme is loaded.
         *
         * @since 5.2.0
         */
        do_action( 'wp_loaded' );

        include( $template );
    }
}

这段代码首先检查是否处于恢复模式。如果处于恢复模式，则使用 wp_recovery_mode_template() 函数加载恢复模式的模板。否则，它通过 template_include 过滤器钩子获取要加载的模板文件。然后，它使用 include() 函数加载模板文件。

总结：wp-settings.php，启动之钥

wp-settings.php 是 WordPress 启动的关键文件。它通过定义常量、加载核心文件、初始化全局变量、设置时区、加载插件和主题，为 WordPress 的顺利运行奠定了基础。

为了更清晰地展示 wp-settings.php 的加载流程，咱们可以用一张表格来总结一下：

步骤	任务	涉及的文件
1	定义 `ABSPATH` 常量，确定 WordPress 根目录。	`wp-settings.php`
2	加载 `wp-config.php` 文件，包含数据库连接信息、调试设置等。	`wp-config.php`
3	加载核心文件，包括基础函数、常量、插件 API、翻译文件等。	`wp-includes/load.php`、`wp-includes/default-constants.php`、`wp-includes/plugin.php`、`wp-includes/pomo/mo.php`
4	创建全局数据库对象 `$wpdb`，用于执行数据库查询。	`wp-includes/wp-db.php`
5	设置时区。	`wp-settings.php`
6	加载已激活的插件，扩展 WordPress 的功能。	各个插件文件
7	加载当前使用的主题，展现 WordPress 的个性。	主题的模板文件

结语：掌握核心，玩转 WordPress

通过今天的学习，相信你对 wp-settings.php 有了更深入的了解。掌握了 wp-settings.php，就掌握了 WordPress 启动的钥匙，可以更好地理解 WordPress 的工作原理，从而更好地开发和维护 WordPress 网站。

记住，学习源码是一个漫长的过程，需要不断地实践和探索。希望今天的讲座能帮助你入门 WordPress 源码，开启你的 WordPress 进阶之旅！

下次有机会，我们再一起探索 WordPress 的其他核心模块，例如主题系统、插件系统等。敬请期待！

发表回复 取消回复

发表回复取消回复