在 WordPress 环境外直接执行 PHP 文件时，若未加载 WordPress 核心环境，$wpdb 对象将为 null，导致数据库查询失败；必须显式引入 wp-config.php（或更规范地使用 wp-load.php）以初始化 WordPress 运行时。
在 wordpress 环境外直接执行 php 文件时，若未加载 wordpress 核心环境，`$wpdb` 对象将为 `null`，导致数据库查询失败；必须显式引入 `wp-config.php`（或更规范地使用 `wp-load.php`）以初始化 wordpress 运行时。
WordPress 的 $wpdb 是一个全局数据库访问对象，仅在 WordPress 主循环或已完整加载其核心文件的上下文中才可用。当你通过 HTML 表单 POST 到一个独立的 .php 文件（如 /wp-content/themes/mytheme/custom-handler.php）时，该文件默认处于“裸 PHP”环境——它不自动包含 WordPress 的配置、函数库或数据库连接逻辑，因此 global $wpdb 实际引用的是未初始化的 null，调用其方法（如 get_var()）会触发致命错误：Call to a member function get_var() on null。
✅ 正确做法是：在使用 $wpdb 前，手动加载 WordPress 环境。推荐方式是引入 wp-load.php（位于 WordPress 根目录），因为它会按顺序加载 wp-config.php、wp-settings.php 等关键文件，完整初始化核心对象（包括 $wpdb）：
<?php
// 确保路径正确：根据当前 PHP 文件位置向上定位到 WordPress 根目录
require_once($_SERVER['DOCUMENT_ROOT'] . '/wp-load.php');
if ($_SERVER["REQUEST_METHOD"] === "POST") {
echo "Hi";
global $wpdb;
// 注意：务必对表名使用 $wpdb->prefix 以支持多站点和自定义前缀
$table_name = $wpdb->prefix . 'atblNewsletter';
$result = $wpdb->get_var($wpdb->prepare("SELECT EmailAdrs FROM {$table_name} LIMIT 1"));
if ($result !== null) {
echo esc_html($result);
} else {
echo "No record found or query failed.";
}
}
?>⚠️ 注意事项：
- 不要仅 require_once('wp-config.php')：虽然能解决连接问题，但缺少 wp-settings.php 导致 WordPress 函数、钩子、常量及 $wpdb 的完整初始化可能不完整，存在兼容性风险；
- 路径需准确：wp-load.php 必须从 WordPress 根目录引入；若脚本不在根目录下，请用 dirname(__DIR__) 或 $_SERVER['DOCUMENT_ROOT'] 构建绝对路径；
- 安全加固：始终使用 $wpdb->prepare() 防止 SQL 注入；输出前用 esc_html() 转义，避免 XSS；
- 权限与用途：此类外部 PHP 文件绕过 WordPress 请求生命周期，不推荐用于生产环境核心功能；应优先考虑使用 WordPress REST API 或 admin-ajax.php 实现安全、可维护的前后端交互。
简言之：没有 WordPress 环境，就没有 $wpdb；加载 wp-load.php 是让独立 PHP 文件“成为 WordPress 一部分”的最可靠方式。
立即学习“PHP免费学习笔记（深入）”；
