函数文档

require_wp_db()

💡 云策文档标注

概述

require_wp_db() 函数用于加载 WordPress 数据库类文件并实例化全局变量 $wpdb,确保数据库连接可用。

关键要点

  • 加载 class-wpdb.php 文件以引入数据库类
  • 检查并加载自定义 db.php 文件(如果存在)
  • 使用 DB_USER、DB_PASSWORD、DB_NAME 和 DB_HOST 常量实例化 $wpdb 对象
  • 如果 $wpdb 已设置,则直接返回以避免重复实例化

代码示例

Source function require_wp_db() {
	global $wpdb;

	require_once ABSPATH . WPINC . '/class-wpdb.php';

	if ( file_exists( WP_CONTENT_DIR . '/db.php' ) ) {
		require_once WP_CONTENT_DIR . '/db.php';
	}

	if ( isset( $wpdb ) ) {
		return;
	}

	$dbuser     = defined( 'DB_USER' ) ? DB_USER : '';
	$dbpassword = defined( 'DB_PASSWORD' ) ? DB_PASSWORD : '';
	$dbname     = defined( 'DB_NAME' ) ? DB_NAME : '';
	$dbhost     = defined( 'DB_HOST' ) ? DB_HOST : '';

	$wpdb = new wpdb( $dbuser, $dbpassword, $dbname, $dbhost );
}

📄 原文内容

Loads the database class file and instantiates the $wpdb global.

Source

function require_wp_db() {
	global $wpdb;

	require_once ABSPATH . WPINC . '/class-wpdb.php';

	if ( file_exists( WP_CONTENT_DIR . '/db.php' ) ) {
		require_once WP_CONTENT_DIR . '/db.php';
	}

	if ( isset( $wpdb ) ) {
		return;
	}

	$dbuser     = defined( 'DB_USER' ) ? DB_USER : '';
	$dbpassword = defined( 'DB_PASSWORD' ) ? DB_PASSWORD : '';
	$dbname     = defined( 'DB_NAME' ) ? DB_NAME : '';
	$dbhost     = defined( 'DB_HOST' ) ? DB_HOST : '';

	$wpdb = new wpdb( $dbuser, $dbpassword, $dbname, $dbhost );
}

Changelog

Version Description
2.5.0 Introduced.