深入理解 WordPress 多站点 domain_mapping 的解析与加载顺序 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

WordPress 多站点 Domain Mapping 深度解析与加载顺序

各位朋友，大家好！今天我们来深入探讨 WordPress 多站点中 domain_mapping 的解析与加载顺序。这部分是多站点配置中至关重要的一环，理解其工作原理对于搭建稳定高效的多站点网络至关重要。我们会从底层代码入手，结合实例分析，力求透彻理解。

什么是 Domain Mapping？

在标准的 WordPress 多站点中，每个子站点通常通过子目录或子域名来访问，例如 example.com/site1 或 site1.example.com。 domain_mapping 的作用就是将这些子站点映射到独立的域名，例如 site1.com。这样，每个站点就可以拥有完全独立的域名，提升品牌形象和用户体验。

Domain Mapping 的实现原理

domain_mapping 的实现依赖于 WordPress 的 sunrise.php 文件和数据库中的相关设置。sunrise.php 是一个在 WordPress 初始化早期加载的文件，它负责在主站点域名之外查找并加载子站点的信息。

1. sunrise.php 的作用:

当一个请求到达 WordPress 时，WordPress 首先加载核心文件。在加载核心文件之前，如果 WP_ALLOW_MULTISITE 定义为 true 且 SUNRISE 定义为 true，WordPress 会尝试加载 sunrise.php 文件。sunrise.php 的主要任务是：

识别域名: 获取当前请求的域名。
查询数据库: 根据域名在数据库中查找对应的站点信息。
设置全局变量: 如果找到匹配的站点，设置全局变量，例如 SITE_ID_CURRENT_SITE 和 BLOG_ID_CURRENT_SITE，以便 WordPress 加载正确的站点信息。

2. 数据库中的相关设置:

wp_options 表中存储了主站点的信息，而各个子站点的信息存储在 wp_sitemeta 表中。domain_mapping 的关键信息通常存储在 wp_sitemeta 表中，使用 domain 键来关联域名和站点ID。

3. 工作流程:

当用户访问 site1.com 时，sunrise.php 会被加载。sunrise.php 获取到 site1.com 这个域名，然后在 wp_sitemeta 表中查找 meta_key 为 domain 且 meta_value 为 site1.com 的记录。如果找到，就获取到对应的 site_id，并将 SITE_ID_CURRENT_SITE 和 BLOG_ID_CURRENT_SITE 设置为该站点的信息。接下来，WordPress 会根据这些全局变量加载 site1.com 对应的站点数据。

`sunrise.php` 代码示例

下面是一个简化的 sunrise.php 代码示例，演示了 domain_mapping 的核心逻辑：

<?php
/**
 * Sunrise.php - Domain Mapping for WordPress Multisite
 */

if ( defined( 'SUNRISE' ) && SUNRISE == 'on' ) {
    global $wpdb;

    $current_domain = $_SERVER['HTTP_HOST']; // 获取当前域名

    // 查询数据库，查找匹配的站点
    $site = $wpdb->get_row( $wpdb->prepare(
        "SELECT site_id FROM {$wpdb->sitemeta} WHERE meta_key = 'domain' AND meta_value = %s",
        $current_domain
    ) );

    if ( $site ) {
        // 获取站点信息
        $site_id = $site->site_id;

        // 设置全局变量
        if ( ! defined( 'SITE_ID_CURRENT_SITE' ) ) {
            define( 'SITE_ID_CURRENT_SITE', (int) $site_id );
        }

        if ( ! defined( 'BLOG_ID_CURRENT_SITE' ) ) {
            $blog_id = $wpdb->get_var( $wpdb->prepare(
                "SELECT blog_id FROM {$wpdb->blogs} WHERE site_id = %d AND domain = %s",
                $site_id,
                $current_domain
            ) );

            define( 'BLOG_ID_CURRENT_SITE', (int) $blog_id );
        }
    }
}

代码解释:

$_SERVER['HTTP_HOST'] 获取当前请求的域名。
$wpdb->get_row() 执行 SQL 查询，从 wp_sitemeta 表中查找匹配的站点。
define() 定义全局常量 SITE_ID_CURRENT_SITE 和 BLOG_ID_CURRENT_SITE。

注意: 这只是一个简化的示例，实际的 sunrise.php 文件可能包含更多的逻辑，例如错误处理、缓存机制等。

Domain Mapping 的加载顺序

理解 domain_mapping 的加载顺序对于调试和解决问题至关重要。下面是 WordPress 多站点加载过程的关键步骤，突出显示了 sunrise.php 的加载位置：

加载 wp-config.php: wp-config.php 文件定义了数据库连接信息、调试模式等。
定义常量: 定义 WordPress 核心常量，例如 ABSPATH 和 WPINC。
加载 wp-settings.php: wp-settings.php 文件加载 WordPress 核心文件。
检查是否启用多站点: wp-settings.php 检查 WP_ALLOW_MULTISITE 是否为 true。
检查是否启用 Domain Mapping: wp-settings.php 检查 SUNRISE 是否为 true。
加载 sunrise.php (如果启用): 如果在 wp-config.php 中定义了 define( 'SUNRISE', 'on' );，则 wp-settings.php 会尝试加载 sunrise.php 文件。
加载插件: 加载已激活的插件。
加载主题: 加载当前主题。

时序图:

sequenceDiagram
    participant Browser
    participant WebServer
    participant WordPress

    Browser->>WebServer: HTTP Request (site1.com)
    WebServer->>WordPress: index.php
    WordPress->>WordPress: Load wp-config.php
    WordPress->>WordPress: Load wp-settings.php
    WordPress->>WordPress: Check WP_ALLOW_MULTISITE
    WordPress->>WordPress: Check SUNRISE
    alt SUNRISE is true
        WordPress->>WordPress: Load sunrise.php
        WordPress->>WordPress: Query wp_sitemeta for domain mapping
        WordPress->>WordPress: Set SITE_ID_CURRENT_SITE and BLOG_ID_CURRENT_SITE
    end
    WordPress->>WordPress: Load Plugins
    WordPress->>WordPress: Load Theme
    WordPress->>WebServer: HTTP Response
    WebServer->>Browser: HTTP Response

表格总结加载顺序:

步骤	文件/操作	描述
1	`wp-config.php`	定义数据库连接和常量
2	`wp-settings.php`	加载核心文件
3	检查 `WP_ALLOW_MULTISITE`	确定是否启用多站点
4	检查 `SUNRISE`	确定是否启用 Domain Mapping
5	`sunrise.php`	域名映射的核心逻辑
6	插件	加载已激活的插件
7	主题	加载当前主题

常见问题及解决方案

1. Domain Mapping 不生效:

问题: 访问映射的域名时，仍然显示主站点的内容。
可能原因:
- sunrise.php 文件不存在或未正确配置。
- wp-config.php 中未定义 define( 'SUNRISE', 'on' );。
- 数据库中没有正确的域名映射记录。
- 服务器 DNS 未正确解析域名。
- 缓存问题（服务器缓存、浏览器缓存）。
解决方案:
- 检查 sunrise.php 文件是否存在于 wp-content 目录下，并且代码正确。
- 确保 wp-config.php 中定义了 define( 'SUNRISE', 'on' );。
- 使用数据库管理工具（例如 phpMyAdmin）检查 wp_sitemeta 表中是否存在正确的域名映射记录，确保 meta_key 为 domain，meta_value 为正确的域名，site_id 对应正确的站点 ID。
- 检查服务器 DNS 设置，确保域名解析到正确的服务器 IP 地址。
- 清除服务器缓存和浏览器缓存。

2. 循环重定向:

问题: 访问映射的域名时，出现循环重定向错误。
可能原因:
- sunrise.php 中的逻辑错误导致无限循环。
- .htaccess 文件中的重定向规则冲突。
- 插件冲突。
解决方案:
- 仔细检查 sunrise.php 文件中的代码，确保逻辑正确，没有无限循环。
- 检查 .htaccess 文件，删除或修改冲突的重定向规则。
- 禁用所有插件，然后逐个启用，找到导致冲突的插件。

3. 混合内容错误:

问题: 网站使用了 HTTPS，但部分资源（例如图片、CSS 文件）仍然通过 HTTP 加载，导致浏览器显示混合内容错误。
可能原因:
- 数据库中存储的站点 URL 仍然是 HTTP。
- 主题或插件中使用了硬编码的 HTTP URL。
解决方案:
- 使用数据库搜索替换工具，将数据库中的所有 HTTP URL 替换为 HTTPS URL。
- 检查主题和插件代码，将硬编码的 HTTP URL 替换为 HTTPS URL 或相对路径。
- 配置 WordPress 使用 HTTPS，在 wp-config.php 中添加 define('FORCE_SSL_ADMIN', true); 和 $_SERVER['HTTPS'] = 'on';。

4. 域名解析错误:

问题: 域名无法解析到服务器。
可能原因:
- 域名 DNS 设置错误。
- 域名注册商的问题。
- 服务器防火墙阻止了 DNS 查询。
解决方案:
- 检查域名 DNS 设置，确保 A 记录或 CNAME 记录指向正确的服务器 IP 地址。
- 联系域名注册商，确认域名状态正常。
- 检查服务器防火墙设置，允许 DNS 查询。

进一步优化 Domain Mapping

除了基本的 domain_mapping 功能，我们还可以进行一些优化，以提高性能和安全性：

使用缓存: sunrise.php 的每次请求都会查询数据库，这会影响性能。可以使用缓存机制（例如 WordPress 对象缓存或 Memcached）来缓存域名映射结果，减少数据库查询次数。
CDN 加速: 使用 CDN（内容分发网络）可以加速静态资源的加载，提高网站访问速度。
HTTPS 支持: 强制使用 HTTPS 可以提高网站安全性，保护用户数据。
监控和日志: 配置监控和日志系统，可以及时发现和解决问题。

代码示例：使用对象缓存优化 Domain Mapping

<?php
/**
 * Sunrise.php - Domain Mapping with Object Cache
 */

if ( defined( 'SUNRISE' ) && SUNRISE == 'on' ) {
    global $wpdb, $wp_object_cache;

    $current_domain = $_SERVER['HTTP_HOST'];

    // 尝试从对象缓存中获取站点信息
    $cache_key = 'domain_mapping_' . md5( $current_domain );
    $site = wp_cache_get( $cache_key, 'domain_mapping' );

    if ( false === $site ) {
        // 如果缓存未命中，则查询数据库
        $site = $wpdb->get_row( $wpdb->prepare(
            "SELECT site_id FROM {$wpdb->sitemeta} WHERE meta_key = 'domain' AND meta_value = %s",
            $current_domain
        ) );

        // 将站点信息添加到对象缓存
        wp_cache_set( $cache_key, $site, 'domain_mapping', 3600 ); // 缓存 1 小时
    }

    if ( $site ) {
        $site_id = $site->site_id;

        if ( ! defined( 'SITE_ID_CURRENT_SITE' ) ) {
            define( 'SITE_ID_CURRENT_SITE', (int) $site_id );
        }

        if ( ! defined( 'BLOG_ID_CURRENT_SITE' ) ) {
            $blog_id = $wpdb->get_var( $wpdb->prepare(
                "SELECT blog_id FROM {$wpdb->blogs} WHERE site_id = %d AND domain = %s",
                $site_id,
                $current_domain
            ) );

            define( 'BLOG_ID_CURRENT_SITE', (int) $blog_id );
        }
    }
}

代码解释:

wp_cache_get() 尝试从对象缓存中获取站点信息。
wp_cache_set() 将站点信息添加到对象缓存。
3600 表示缓存时间为 1 小时。

总结性概述

今天我们深入探讨了 WordPress 多站点的 domain_mapping 机制，包括其实现原理、加载顺序、常见问题以及优化方法。希望通过今天的讲解，大家能够更好地理解和应用 domain_mapping，搭建稳定高效的多站点网络。掌握域名映射是多站点管理的关键。