WordPress wp-config.php自定义常量每次页面加载未定义问题求解

1、为什么所有页面请求都会调用wp-config文件？ #

wp-config.php是WordPress的核心基础配置文件，存储了数据库连接凭据、安全授权密钥、运行模式开关等全局核心配置参数。WordPress任意类型的请求（前端页面、后台操作、AJAX接口、REST API调用等）的初始化流程，都必须先读取该文件的配置才能完成后续的启动步骤，缺少该文件WordPress无法正常运行，因此每次独立的HTTP请求都会重新加载一次wp-config.php。

2、常量定义无法跨请求生效的原因及解决方案 #

根本原因 #

PHP属于单请求生命周期的脚本语言，所有运行期定义的常量、变量、对象等数据，都仅在当前单次请求的执行进程内存中有效，请求处理完成后所有相关内存资源会被系统完全回收。你预期的“首次定义后后续请求可读取”属于跨请求持久化存储的需求，PHP默认不支持跨请求保留内存数据，因此每次请求加载wp-config.php时，!defined('DB_CONFIGURED')的判断结果永远为真，你的业务逻辑每次都会重新执行，也不可能读取到上一次请求定义的常量。

修复方案 #

根据你的业务场景可选择对应方案：

• 若你的业务逻辑只需要全局执行一次：用持久化存储代替内存常量做执行状态判断
  • 已完成数据库连接初始化的场景：执行完业务逻辑后调用update_option('db_configured_done', 1)存储标记，判断逻辑改为if (!get_option('db_configured_done'))即可
  • 数据库还未连接的场景：用本地文件做标记，执行完业务逻辑后在wp-config.php同级目录生成空锁文件file_put_contents(__DIR__ . '/db_configured.lock', '')，判断逻辑改为if (!file_exists(__DIR__ . '/db_configured.lock'))
• 若你需要这个常量全局可用，不需要条件执行：直接把define('DB_CONFIGURED', true);写在wp-config.php的全局作用域，不要包裹任何条件判断，每次请求加载时都会自动定义该常量，整个WordPress运行流程中都可以正常读取。

内容的提问来源于stack exchange，提问作者Safari