剖析 WordPress `wp_install()` 函数的源码：它是如何创建数据库表和初始站点的。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

嘿，各位代码爱好者们，准备好一起揭开 WordPress 安装过程的神秘面纱了吗？今天我们来扒一扒 wp_install() 这个函数的底裤，看看它到底是怎么把一个光秃秃的数据库变成一个可以运行的 WordPress 站点的。准备好你的咖啡，咱们要开始咯！

第一幕：wp_install() 的登场

首先，我们要找到 wp_install() 这个函数。它藏身于 wp-admin/includes/upgrade.php 文件中。这个文件就像 WordPress 安装和升级过程的幕后大佬，负责处理各种数据库操作。

wp_install() 函数的主要任务是：

验证输入的数据（网站标题，用户名，密码等）。
创建数据库表。
插入初始数据（默认文章，分类，用户等）。
配置 WordPress 选项（网站 URL，管理员邮箱等）。

第二幕：数据验证，容错机制不可少

在开始创建数据库表之前，wp_install() 首先会验证我们输入的数据，比如网站标题、用户名、密码等等。这是为了防止一些恶意攻击，确保数据的安全性。

// 验证 blogname（网站标题）
if ( empty( $_POST['blogname'] ) ) {
    wp_die( __( 'You must provide a blog title.' ) );
}

// 验证用户名
if ( empty( $_POST['user_name'] ) ) {
    wp_die( __( 'You must provide a username.' ) );
}

// ... 其他验证

如果验证失败，WordPress 会友好地提示你哪里出错了，让你重新输入。这个过程虽然简单，但却是保证网站安全的第一道防线。

第三幕：创建数据库表，地基要打好

接下来，重头戏来了！ wp_install() 要开始创建数据库表了。这些表是 WordPress 存储所有数据的容器，包括文章、用户、评论、选项等等。

WordPress 使用 $wpdb 对象来执行数据库操作。 $wpdb 是一个全局对象，它封装了 WordPress 的数据库连接，提供了各种方便的方法来执行 SQL 查询。

global $wpdb;

// 设置字符集和排序规则
$charset_collate = $wpdb->get_charset_collate();

// 创建 posts 表
$sql = "CREATE TABLE {$wpdb->posts} (
  ID bigint(20) unsigned NOT NULL auto_increment,
  post_author bigint(20) unsigned NOT NULL default '0',
  post_date datetime NOT NULL default '0000-00-00 00:00:00',
  post_date_gmt datetime NOT NULL default '0000-00-00 00:00:00',
  post_content longtext NOT NULL,
  post_title text NOT NULL,
  post_excerpt text NOT NULL,
  post_status varchar(20) NOT NULL default 'publish',
  post_name varchar(200) NOT NULL default '',
  post_modified datetime NOT NULL default '0000-00-00 00:00:00',
  post_modified_gmt datetime NOT NULL default '0000-00-00 00:00:00',
  post_content_filtered longtext NOT NULL,
  post_parent bigint(20) unsigned NOT NULL default '0',
  guid varchar(255) NOT NULL default '',
  menu_order int(11) NOT NULL default '0',
  post_type varchar(20) NOT NULL default 'post',
  post_mime_type varchar(100) NOT NULL default '',
  comment_count bigint(20) NOT NULL default '0',
  PRIMARY KEY  (ID),
  KEY post_name (post_name),
  KEY type_status_date (post_type,post_status,post_date,ID),
  KEY post_parent (post_parent),
  KEY post_author (post_author)
) {$charset_collate};";

dbDelta( $sql );

// 创建其他表 (comments, terms, term_taxonomy, term_relationships, options, users, usermeta, links, postmeta)
// ... 类似的代码，创建其他表

这段代码使用了 dbDelta() 函数来创建表。 dbDelta() 是 WordPress 提供的一个非常方便的函数，它可以智能地比较数据库中已存在的表结构和我们定义的表结构，只执行必要的 SQL 语句来更新表结构。这意味着如果你的数据库中已经存在一些表，dbDelta() 不会傻乎乎地重新创建它们，而是会检查它们是否需要更新。

WordPress 的核心数据表

数据表名称	作用
`wp_posts`	存储文章、页面、附件等内容。这是 WordPress 最核心的表之一。
`wp_comments`	存储评论信息。每当有人在你的文章或页面上发表评论，这条评论就会被存储在这个表中。
`wp_terms`	存储分类、标签等术语。这些术语用于组织和分类你的内容。
`wp_term_taxonomy`	存储术语的分类信息。这个表将术语（`wp_terms`）与它们所属的分类法（例如：分类、标签）关联起来。
`wp_term_relationships`	存储文章与术语之间的关系。这个表将文章（`wp_posts`）与术语（`wp_terms`）关联起来，表示文章属于哪个分类或标签。
`wp_options`	存储 WordPress 的配置选项。网站的 URL、主题设置、插件设置等等都存储在这个表中。
`wp_users`	存储用户信息。用户的用户名、密码、邮箱地址等等都存储在这个表中。
`wp_usermeta`	存储用户的附加信息。用户的昵称、个人简介、社交媒体链接等等都存储在这个表中。
`wp_links`	存储链接信息。这个表用于存储友情链接。（这个表在现代 WordPress 中已经很少使用，因为友情链接功能已经被移除。）
`wp_postmeta`	存储文章的附加信息。比如自定义字段的值就存储在这个表中。

第四幕：插入初始数据，万事开头难

表创建好之后，wp_install() 就要开始往这些表中插入初始数据了。这些数据包括：

默认的文章 "Hello world!"
默认的分类 "Uncategorized"
管理员用户
一些默认的选项

// 插入默认的文章
$now = current_time( 'mysql' );
$now_gmt = current_time( 'mysql', 1 );
$owner_user = wp_get_current_user();

$result = $wpdb->insert(
    $wpdb->posts,
    array(
        'post_author'           => $owner_user->ID,
        'post_date'             => $now,
        'post_date_gmt'         => $now_gmt,
        'post_content'          => __( 'Welcome to WordPress. This is your first post. Edit or delete it, then start writing!' ),
        'post_title'            => __( 'Hello world!' ),
        'post_status'           => 'publish',
        'comment_status'        => 'open',
        'ping_status'           => 'open',
        'post_name'             => 'hello-world',
        'post_modified'         => $now,
        'post_modified_gmt'     => $now_gmt,
        'post_content_filtered' => '',
        'post_type'             => 'post',
    )
);
$hello_world_post_id = $wpdb->insert_id;

// 插入默认的分类
$cat_name = __( 'Uncategorized' );
$cat_slug = sanitize_title( $cat_name );
if ( empty( $cat_slug ) ) {
    $cat_slug = 'uncategorized';
}

$result = $wpdb->insert(
    $wpdb->terms,
    array(
        'name'       => $cat_name,
        'slug'       => $cat_slug,
        'term_group' => 0,
    )
);
$cat_id = $wpdb->insert_id;

$result = $wpdb->insert(
    $wpdb->term_taxonomy,
    array(
        'term_id'     => $cat_id,
        'taxonomy'    => 'category',
        'description' => __( 'Default category' ),
        'parent'      => 0,
        'count'       => 1,
    )
);
$cat_tax_id = $wpdb->insert_id;

$result = $wpdb->insert(
    $wpdb->term_relationships,
    array(
        'object_id'        => $hello_world_post_id,
        'term_taxonomy_id' => $cat_tax_id,
        'term_order'       => 0,
    )
);

// ... 类似的代码，插入其他数据

这些初始数据是 WordPress 正常运行的基础。没有它们，你的网站就无法正常显示。

第五幕：配置 WordPress 选项，网站的灵魂

最后，wp_install() 会配置 WordPress 的选项。这些选项控制着网站的各种行为，包括网站的 URL、管理员邮箱、主题设置等等。

// 设置网站 URL
update_option( 'siteurl', 'http://' . $_SERVER['HTTP_HOST'] . $path );
update_option( 'home', 'http://' . $_SERVER['HTTP_HOST'] . $path );

// 设置管理员邮箱
update_option( 'admin_email', $_POST['admin_email'] );

// 设置博客标题
update_option( 'blogname', $_POST['blogname'] );

// ... 类似的代码，设置其他选项

WordPress 使用 wp_options 表来存储这些选项。 update_option() 函数用于更新选项的值。

重要选项

选项名称	作用
`siteurl`	网站的 URL。这是 WordPress 访问你网站的主要地址。
`home`	网站的首页 URL。通常与 `siteurl` 相同，但有时可以不同，例如，当你的 WordPress 安装在子目录中时。
`admin_email`	管理员的邮箱地址。 WordPress 会使用这个邮箱地址发送通知和警告。
`blogname`	网站的标题。这个标题会显示在你的网站的顶部和标题栏中。
`blogdescription`	网站的描述。这个描述通常会显示在搜索引擎结果中。
`default_category`	默认的分类 ID。当你在发布文章时没有选择分类，WordPress 会自动将文章分配到这个分类。
`template`	当前使用的主题名称。这个选项告诉 WordPress 使用哪个主题来显示你的网站。
`stylesheet`	当前使用的主题样式表名称。通常与 `template` 相同，但有时可以不同，例如，当使用子主题时。
`timezone_string`	网站的时区。这个选项用于设置网站的时间显示。
`users_can_register`	是否允许用户注册。如果设置为 `1`，则允许用户注册；如果设置为 `0`，则不允许用户注册。

第六幕：收尾工作，大功告成

在完成所有这些步骤之后，wp_install() 会执行一些收尾工作，例如设置重定向 URL，清除缓存等等。然后，它会提示你安装成功，并引导你登录到 WordPress 后台。

// 设置重定向 URL
$redirect = admin_url( 'index.php?wp-installing' );

// ... 其他收尾工作

// 重定向到后台
wp_redirect( $redirect );
exit;

总结：wp_install() 的流程图

为了更好地理解 wp_install() 的工作流程，我们可以用一个流程图来概括一下：

graph TD
    A[开始] --> B{数据验证};
    B -- 验证通过 --> C{创建数据库表};
    B -- 验证失败 --> D[显示错误信息];
    C --> E{插入初始数据};
    E --> F{配置 WordPress 选项};
    F --> G[收尾工作];
    G --> H[安装完成，重定向到后台];
    D --> A;
    H --> I[结束];

结语：深入理解 WordPress 安装过程

通过今天的分析，我们深入了解了 wp_install() 函数的源码，了解了 WordPress 安装过程的各个环节。希望这次讲座能帮助你更好地理解 WordPress 的底层机制，为你的 WordPress 开发之路打下坚实的基础。

记住，理解源码是成为 WordPress 大神的必经之路！继续探索，你会发现更多有趣的东西！祝你编码愉快！

发表回复 取消回复

发表回复取消回复