PHP中使用相对路径包含文件时，路径解析基于当前执行脚本的位置而非被包含文件的位置，导致函数在后续代码中不可用；应统一使用__DIR__配合realpath()或绝对路径方式确保包含成功。
php中使用相对路径包含文件时，路径解析基于当前执行脚本的位置而非被包含文件的位置，导致函数在后续代码中不可用；应统一使用__dir__配合realpath()或绝对路径方式确保包含成功。
在PHP项目中，常见的模板分离结构（如templates/header.php + 根目录下example.php）容易因路径解析逻辑误解引发函数不可见问题。根本原因在于：PHP的include语句中的相对路径始终相对于当前正在执行的脚本（即“入口脚本”）的工作目录，而非被包含文件自身所在位置。
以您的目录结构为例：
- index.php ← 当前工作目录在此（Web服务器入口）
- example.php
- templates/
- header.php
- footer.php当index.php执行include 'templates/header.php'时，控制权进入header.php；但其中的include '../example.php'仍以index.php所在目录为基准向上查找——即尝试访问/example.php的父目录（通常为系统根目录），这显然失败，触发致命错误（Fatal Error），PHP立即终止执行，后续代码（包括index.php中对someFunction()的调用）根本不会运行。
✅ 正确做法是：在header.php中使用基于自身位置的绝对路径包含example.php：
立即学习“PHP免费学习笔记（深入）”；
<!-- templates/header.php --> <?php // ✅ 正确：__DIR__ 指向当前文件（header.php）所在目录，即 templates/ // 因此 __DIR__.'/../example.php' 精确指向根目录下的 example.php include realpath(__DIR__ . '/../example.php'); // 或更简洁安全的写法（无需 realpath，PHP 5.3+ 支持）： // include __DIR__ . '/../example.php'; ?> <html> <head><title>Example Title</title></head> <body> <h1><?php echo someFunction(); ?></h1>
⚠️ 注意事项：
- 避免依赖
getcwd()或chdir()，它们易受运行环境影响； -
realpath()可规范化路径并验证文件存在，推荐用于生产环境； - 若项目部署路径不确定，建议将核心函数文件集中放入
includes/目录，并在index.php最顶部统一引入，保证全局作用域； - 函数定义必须在调用前完成加载，PHP不支持“后声明前调用”。
? 总结：PHP包含机制的本质是“文本嵌入+顺序执行”，路径解析锚点永远是初始执行脚本。要实现跨层级可靠包含，请始终以__DIR__（被包含文件自身目录）为基准构建路径，这是最健壮、可移植的实践方式。
