阐述 WordPress `wpdb` 类的 `__construct()` 源码：它是如何建立数据库连接的。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

咳咳，各位观众，晚上好！今天咱们聊聊WordPress里那个神通广大的wpdb类，特别是它的__construct()方法，也就是它的“出生过程”。咱们要看看它怎么一出生就连接上了数据库，开始干活。

开场白：wpdb，WordPress的数据库管家

在WordPress的世界里，数据是血液，而wpdb类就是那个负责输送血液的“数据库管家”。所有的数据库交互，比如读取文章，保存设置，都离不开它。所以搞清楚wpdb是怎么工作的，对于理解WordPress的底层机制至关重要。

第一幕：__construct() 方法的剖析

__construct() 方法，顾名思义，就是类的构造函数。当咱们用 new wpdb() 创建一个 wpdb 对象时，这个方法就会自动执行。

咱们先来一段简化版的__construct()代码（基于WordPress源码，略有简化，方便理解）：

<?php

class wpdb {

    public $dbhost;
    public $dbuser;
    public $dbpassword;
    public $dbname;
    public $dbh; // Database handle
    public $last_error;
    public $num_queries = 0;
    public $queries = array();
    public $use_mysqli = true; // 默认使用 mysqli 扩展

    public function __construct( $dbuser, $dbpassword, $dbname, $dbhost ) {
        $this->dbuser = $dbuser;
        $this->dbpassword = $dbpassword;
        $this->dbname = $dbname;
        $this->dbhost = $dbhost;

        $this->db_connect();
    }

    public function db_connect() {
        $this->dbh = @mysqli_connect( $this->dbhost, $this->dbuser, $this->dbpassword, $this->dbname );

        if ( ! $this->dbh ) {
            $this->last_error = mysqli_connect_error();
            return false;
        }

        return true;
    }

    // 更多 wpdb 方法...
}

?>

这段代码做了以下几件事：

接收数据库连接信息： __construct() 接收四个参数：$dbuser (数据库用户名), $dbpassword (数据库密码), $dbname (数据库名), 和 $dbhost (数据库服务器地址)。这些信息就像是打开数据库大门的钥匙。
保存连接信息： 把这些参数保存到类的属性中，比如 $this->dbuser，$this->dbpassword 等。这样，wpdb 对象就能在后续的操作中随时使用这些信息。
建立数据库连接： 调用 $this->db_connect() 方法，尝试连接数据库。

第二幕：深入 db_connect() 方法

db_connect() 方法才是真正建立连接的地方。咱们再仔细看看：

<?php
public function db_connect() {
    $this->dbh = @mysqli_connect( $this->dbhost, $this->dbuser, $this->dbpassword, $this->dbname );

    if ( ! $this->dbh ) {
        $this->last_error = mysqli_connect_error();
        return false;
    }

    return true;
}
?>

尝试连接： 使用 mysqli_connect() 函数尝试连接数据库。 mysqli_connect() 是 PHP 的 mysqli 扩展提供的函数，专门用来连接 MySQL 数据库。@ 符号在这里的作用是抑制错误信息，防止直接暴露敏感信息。
检查连接结果： 如果连接失败 ( ! $this->dbh )，就把错误信息保存到 $this->last_error 属性中，并返回 false。这样，调用 db_connect() 的地方就能知道连接失败了。
返回连接句柄： 如果连接成功，mysqli_connect() 会返回一个数据库连接句柄 (database handle)，也就是 $this->dbh。这个句柄就像是连接数据库的“通行证”，后续的数据库操作都要用到它。

第三幕：连接选项和错误处理

实际的 wpdb 类的 __construct() 方法比咱们上面看到的要复杂一些，因为它还包含了连接选项的处理和更完善的错误处理。

持久连接： WordPress 允许使用持久连接，也就是在脚本执行完毕后仍然保持数据库连接。这样可以减少每次请求都重新连接数据库的开销。

<?php
// 实际的 wpdb 构造函数中可能包含持久连接的判断
if ( WP_USE_EXT_MYSQL && defined( 'MYSQL_PERSISTENT' ) && MYSQL_PERSISTENT ) {
    $this->dbh = @mysqli_pconnect( $this->dbhost, $this->dbuser, $this->dbpassword, $this->dbname );
} else {
    $this->dbh = @mysqli_connect( $this->dbhost, $this->dbuser, $this->dbpassword, $this->dbname );
}
?>

mysqli_pconnect() 就是 mysqli_connect() 的持久连接版本。

字符集设置： 为了保证数据的正确存储和显示，wpdb 会在连接建立后设置数据库的字符集。
```
<?php
if ( $this->dbh ) {
    mysqli_set_charset( $this->dbh, DB_CHARSET );
}
?>
```
DB_CHARSET 是 WordPress 配置文件中定义的数据库字符集。
错误处理： wpdb 提供了更详细的错误处理机制，可以记录错误信息，甚至触发 WordPress 的错误处理函数。

第四幕：从 wp-config.php 引入连接信息

现在，咱们来回答一个关键问题：wpdb 类的构造函数需要的那些参数 ($dbuser, $dbpassword, $dbname, $dbhost) 从哪里来？

答案是：从 wp-config.php 文件来。

wp-config.php 是 WordPress 的配置文件，包含了数据库连接信息、密钥等重要设置。在 WordPress 初始化过程中，会加载 wp-config.php 文件，并定义一些常量，比如 DB_NAME、DB_USER、DB_PASSWORD、DB_HOST。

然后，在 WordPress 的核心代码中，会创建一个 wpdb 对象，并将这些常量作为参数传递给构造函数：

<?php
// 位于 wp-settings.php 或其他核心文件中
global $wpdb;

$wpdb = new wpdb( DB_USER, DB_PASSWORD, DB_NAME, DB_HOST );
?>

第五幕： wpdb 类的属性

除了连接信息，wpdb 类还有很多其他的属性，用来存储数据库连接状态、查询结果等信息。咱们来看看一些重要的属性：

属性名	类型	描述
`$dbhost`	string	数据库服务器地址
`$dbuser`	string	数据库用户名
`$dbpassword`	string	数据库密码
`$dbname`	string	数据库名
`$dbh`	resource	数据库连接句柄，也就是 `mysqli_connect()` 的返回值
`$last_error`	string	上一次数据库操作的错误信息
`$num_queries`	integer	执行的查询次数
`$queries`	array	存储所有执行过的查询语句和执行时间
`$use_mysqli`	boolean	是否使用 mysqli 扩展， WordPress 默认使用 mysqli

第六幕： wpdb 的使用场景

有了 wpdb 对象，咱们就可以执行各种数据库操作了。 wpdb 类提供了很多方法，比如：

$wpdb->query(): 执行任意 SQL 查询。
$wpdb->get_results(): 获取查询结果，返回一个对象数组。
$wpdb->get_row(): 获取查询结果的第一行，返回一个对象。
$wpdb->insert(): 插入数据。
$wpdb->update(): 更新数据。
$wpdb->delete(): 删除数据。

举个例子，咱们可以用 $wpdb 来获取最新的 10 篇文章：

<?php
global $wpdb;

$results = $wpdb->get_results( "SELECT * FROM {$wpdb->posts} WHERE post_status = 'publish' AND post_type = 'post' ORDER BY post_date DESC LIMIT 10" );

if ( $results ) {
    foreach ( $results as $post ) {
        echo '<h2>' . $post->post_title . '</h2>';
        echo '<p>' . $post->post_excerpt . '</p>';
    }
} else {
    echo '没有找到文章。';
}
?>

注意，{$wpdb->posts} 是 WordPress 的文章表名。 wpdb 类会自动处理表名前缀，保证在不同的 WordPress 安装环境下都能正确访问表。

第七幕：总结和注意事项

咱们今天详细分析了 wpdb 类的 __construct() 方法，了解了它是如何建立数据库连接的。总结一下，wpdb 的“出生”过程可以概括为以下几步：

从 wp-config.php 获取数据库连接信息。
使用 mysqli_connect() (或 mysqli_pconnect() ) 尝试连接数据库。
设置数据库字符集。
保存连接句柄和错误信息。

在使用 wpdb 类的时候，需要注意以下几点：

安全性： 避免直接在 SQL 查询中使用用户输入，防止 SQL 注入攻击。 wpdb 类提供了 prepare() 方法，可以安全地处理用户输入。
性能： 尽量使用 wpdb 类提供的辅助方法 (比如 insert(), update(), delete() )，而不是直接执行 SQL 查询。这些方法经过优化，可以提高性能。
错误处理： 在执行数据库操作后，要检查 $wpdb->last_error 属性，判断是否发生了错误。

结尾：wpdb，WordPress 的基石

wpdb 类是 WordPress 的基石之一。理解它的工作原理，对于开发 WordPress 主题和插件至关重要。希望今天的讲解能帮助大家更好地理解 WordPress 的底层机制。

今天的讲座就到这里，谢谢大家！祝各位编程愉快！

发表回复 取消回复

发表回复取消回复