PHP中include路径以当前工作目录（CWD）为基准解析相对路径，而非当前文件所在目录；绝对路径和./、../开头的相对路径直接按CWD解析，无前缀路径则按include_path→CWD→当前文件目录顺序查找；推荐用__DIR__构建稳定绝对路径。
PHP包含文件报“找不到文件”，90%以上是路径解析逻辑被误读导致的，不是文件真丢了，也不是服务器坏了。
include 路径到底以谁为基准？
很多人以为 include '../config.php' 是以当前文件（比如 admin/index.php）所在目录为起点向上找，其实不是——PHP 默认以当前工作目录（CWD）为基准解析相对路径，而 CWD 在 Web 环境下通常等于入口脚本（如 index.php）所在目录，跟 include 写在哪一层文件里无关。
这意味着：
-
include '../config.php'永远从入口脚本目录上一级去找，不是从admin/index.php所在目录 -
include 'lib/utils.php'（无./或../）会先查include_path，再查 CWD，最后查当前include所在文件的目录 -
include './header.php'和include 'header.php'行为完全不同：前者强制按 CWD 解析，后者走三步查找流程
用 __DIR__ 构建稳定路径最可靠
魔术常量 __DIR__ 始终返回当前文件所在的绝对目录路径，不受调用位置、工作目录或符号链接影响，是解决嵌套包含问题的首选。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 替换所有硬编码相对路径，例如把
include '../config.php'改成include __DIR__ . '/../config.php' - 跨多层目录时，统一用
__DIR__拼接，比如include __DIR__ . '/../../vendor/autoload.php' - 避免混用
__DIR__和getcwd()，后者在 CLI 和 Web 下行为不一致，容易踩坑 - 不要用
realpath('./')代替__DIR__，它依赖当前工作目录，且在某些配置下可能返回意外路径
require 和 include 的错误表现差异要分清
两者路径解析规则完全一致，区别只在失败时的处理方式：
-
include找不到文件 → 触发E_WARNING，脚本继续执行 -
require找不到文件 → 触发E_ERROR，脚本立即终止 -
include_once/require_once多一层去重逻辑，但路径查找机制不变
所以如果页面白屏没报错，很可能是 require 失败后直接中断；如果页面部分缺失但有输出，大概率是 include 静默失败了。别光看浏览器，一定要开 PHP 错误日志（error_log）确认真实报错信息。
虚拟主机和 .htaccess 可能悄悄改掉路径
一键环境（如 phpStudy、XAMPP）启用虚拟主机或伪静态后，DocumentRoot 和实际文件系统路径可能不一致，导致 include 查找目标与预期不符。
排查要点：
- 检查 Apache 的
httpd-vhosts.conf中DocumentRoot是否指向你认为的 Web 根目录 - 临时重命名项目根目录下的
.htaccess，排除重写规则干扰（比如把/api/重写成index.php后，include就可能在错误上下文中执行） - 用
var_dump(__DIR__, getcwd(), $_SERVER['SCRIPT_FILENAME']);在出问题的文件开头打印，对比三者值是否符合预期
最隐蔽的问题往往出在：你以为自己在访问 http://localhost/project/index.php，实际 Apache 把请求路由到了另一个目录，而 __DIR__ 还是准的，getcwd() 却已偏移。
