include_once不会重复包含同一文件，因其内部维护已加载文件列表（eg(included_files)），先规范化路径为绝对路径再查重，命中则直接返回true跳过执行；php 5+已修复windows大小写路径误判问题，但路径未标准化仍可能导致重复加载。
include_once 为什么不会重复包含同一个文件
因为 PHP 内部维护了一个已加载文件列表（EG(included_files)），每次执行 include_once 时，它会先将传入的路径规范化为绝对路径，再查这个列表。如果路径已存在，就直接返回 TRUE，跳过后续加载和执行；否则才真正解析、编译并运行该文件，并把路径加入列表。
这意味着：不是“不执行”，而是“根本没走到执行那步”。哪怕你写了 include_once 'config.php'; 十次，也只会有第一次真正运行 config.php 里的代码（比如 define()、function 声明、$db = new PDO(...); 等）。
Windows 下大小写路径曾导致 include_once 失效
在 PHP 4 时代，Windows 等不区分大小写的系统中，include_once 'A.php'; 和 include_once 'a.php'; 被当成两个不同路径，结果都加载了——引发函数重定义错误。这个问题在 PHP 5+ 已修复：路径会先被标准化（canonicalized），A.php 和 a.php 最终映射到同一绝对路径，include_once 就能正确识别为“已包含”。
但如果你还在用老旧环境（比如某些嵌入式 PHP 或定制容器），或路径里混用了符号链接 + 大小写，仍可能踩坑。建议统一用小写路径命名，并在部署前用 realpath() 验证路径一致性。
include_once 不会阻止跨文件的同名函数冲突
include_once 只保证“同一个文件不被多次加载”，它不管别的文件里有没有定义同名函数或类。常见误判场景：
- 文件
A.php定义了function helper() { ... }，被include_once 'A.php';加载 - 文件
B.php也定义了function helper() { ... }，也被include_once 'B.php';加载 - 只要
A.php和B.php都被加载（哪怕各一次），运行时仍会报Fatal error: Cannot redeclare helper()
所以 include_once 不是命名空间替代品。解决这类问题得靠：
- 用
function_exists('helper')包一层再声明（仅限函数） - 改用
class_exists()+autoload或 Composer 自动加载 - 把逻辑封装进命名空间，避免全局污染
include_once 的返回值和错误处理容易被忽略
include_once 是表达式，有返回值：成功时返回被包含文件的返回值（如最后一行是 return 42;，则整个 include_once 表达式值为 42）；失败时返回 FALSE，并触发 E_WARNING。很多人写成这样：
include_once 'missing.php'; // 错误：没检查是否加载成功，后续代码可能因依赖缺失而崩
更稳妥的做法是显式判断：
if (include_once 'utils.php') {
// 文件存在且加载成功，可放心调用其中函数
} else {
// 记录日志或 fallback 到默认实现
error_log("Failed to load utils.php");
}
注意：include_once 不抛出异常，try/catch 捕不到它的警告；要用 set_error_handler 或检查返回值。
最常被忽略的一点：include_once 的“一次”是按**绝对路径**计数的，不是按字符串字面量。如果你用相对路径又切换了工作目录（chdir()），或者通过 $_SERVER['DOCUMENT_ROOT'] 拼接路径但没做 realpath() 标准化，就可能意外触发多次加载。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
