PHP配置加载失败主因是路径、权限、包含方式或服务器环境映射问题：需用__DIR__构建绝对路径，确保文件权限与SELinux策略合规，关键配置必须用require_once，避免别名或重写导致的路径错位，并添加运行时验证。
PHP 配置无法正常加载，最常见的情况是 require_once 或 include 语句执行后配置变量未定义、脚本静默失败，或直接报 Warning: Failed to open stream。核心问题通常不在配置内容本身，而在于路径、权限、包含方式或服务器环境映射这四个环节。
路径错误：相对路径在 CLI 和 Web 下行为不一致
用 ./config.php 或 ../config.php 在命令行运行脚本时可能成功，但通过浏览器访问时却失败——因为 getcwd() 返回的是 Web 服务器的工作目录（如 /var/www/html），而非你的项目根目录。
- 永远用
__DIR__构建绝对路径：require_once __DIR__ . '/../config/database.php'; - 不要依赖
set_include_path()，它容易被其他组件覆盖，且不直观 - 加一行
if (!file_exists($path)) { die("Config not found: $path"); }快速暴露路径问题
文件权限与 SELinux：Web 进程读不到配置文件
Linux 下即使文件存在，www-data（Ubuntu）或 apache（CentOS）用户也可能无权读取。更隐蔽的是 SELinux 强制策略，它会拦截读取操作却不报明显错误。
- 检查权限：
ls -l config.php，确保至少是-rw-r--r--（644） - 检查父目录执行权限：
ls -ld ./config/—— 目录必须有x权限才能进入 - 若启用了 SELinux（
sestatus显示enforcing），临时测试：setenforce 0；若此时配置能加载，说明需修复上下文：chcon -t httpd_sys_content_t config.php
包含方式错误：用 include 加载关键配置等于埋雷
include 在找不到文件时只抛 Warning 并继续执行，导致后续代码因缺少 $db_host 等变量而崩溃，错误源头却被掩盖。
立即学习“PHP免费学习笔记（深入）”；
- 所有关键配置文件必须用
require_once或require，确保失败即终止 - 避免重复引入：如果
config.php已被autoload.php引入过，再require_once一次会被跳过，可临时改用require测试是否真被加载 - 别在条件分支里
require配置，例如if ($env === 'prod') require 'prod.php';—— 容易漏掉分支，也难调试
Apache/Nginx 路径映射干扰：别名或重写让 __DIR__ 指向意外位置
当使用 Apache Alias 或 Nginx alias 指令将 URL 映射到非文档根目录时，__DIR__ 仍指向物理文件所在路径，但 Web 请求的上下文已变，可能导致配置路径计算错位。
- 打印
echo __FILE__, ' | ', $_SERVER['DOCUMENT_ROOT'];对比两者关系 - 若配置文件放在
/opt/myapp/config/，但DOCUMENT_ROOT是/var/www/html，就别用__DIR__ . '/../../config.php'这类跨级写法 - 更稳妥的做法是定义一个明确的常量：
define('CONFIG_DIR', '/opt/myapp/config');，然后require CONFIG_DIR . '/database.php';
最容易被忽略的一点：某些部署流程（如 Capistrano、Docker 多阶段构建）会在运行时覆盖或清空 config/ 目录，但不会报错——建议在加载配置后加一句 assert(isset($database_host), 'Config not loaded: $database_host missing'); 做运行时兜底验证。
