include_once加载失败默认仅触发E_WARNING警告而不中断执行，需通过返回值false判断并兜底处理；应规范路径、区分环境、避免重复加载及与autoloader冲突。
include_once 加载失败却不报错？检查文件路径和返回值
PHP 的 include_once 在文件不存在或权限不足时默认只发警告（E_WARNING），不中断执行，容易误以为“加载成功了”。实际 include_once 返回 false 表示失败，但很多人忽略判断。
- 务必用返回值做兜底：if (include_once 'config.php' === false) { die('配置加载失败'); }
- 相对路径以当前执行脚本为基准，不是
__FILE__所在位置；建议统一用__DIR__ . '/path/to/file.php' - Windows 下大小写不敏感，Linux 下敏感——
Config.php和config.php在 Linux 是两个文件 - 如果用了 opcache，修改被 include 的文件后可能不会立即生效，需清理缓存或关掉 opcache.validate_timestamps
想按条件动态包含不同配置？别硬套 if-else 嵌套 include_once
直接在 if 分支里写多个 include_once 看似合理，但容易漏掉「未命中任何分支」的兜底，也难维护。更稳妥的做法是把路径计算和加载分离。
- 先构造完整路径：
$file = __DIR__ . '/env/' . ($_ENV['APP_ENV'] ?? 'prod') . '.php'; - 再统一加载并校验：
if (file_exists($file) && is_readable($file)) { include_once $file; } else { throw new RuntimeException("环境配置缺失: $file"); } - 避免在循环或函数内反复调用
include_once——它内部有全局已加载列表缓存，重复调用无意义，还拖慢性能 - 不要用
include_once加载纯变量定义文件后，又在别处重新include_once同一文件试图“覆盖”，PHP 不会重载，变量值不会变
require_once 和 include_once 到底该选哪个？看错误容忍度
两者核心区别就一条：require_once 失败时抛 Fatal error，直接终止；include_once 只抛 Warning，继续执行。选哪个，取决于这个文件是不是程序运行的刚性依赖。
- 加载核心类库、数据库连接、路由注册等——必须用
require_once，缺了就无法启动 - 加载可选的语言包、第三方插件钩子、灰度功能开关文件——可用
include_once，失败后走默认逻辑 - 注意：
require_once的 fatal error 无法被try/catch捕获（除非用set_error_handler+register_shutdown_function），而include_once的 warning 可以被错误处理器接管 - 别为了“看起来更安全”全换成
require_once——某些场景下静默降级比崩掉更合理
为什么 include_once 在 CLI 和 Web 下行为不一致？关注工作目录和自动加载干扰
CLI 模式下当前工作目录是执行命令的位置，Web 模式下通常是 webroot，include_once 'lib/helper.php' 这种相对路径极易因环境不同而失效。另外，Composer 自动加载机制会干扰你对 include_once 的预期。
立即学习“PHP免费学习笔记（深入）”；
- CLI 脚本开头加一句
chdir(__DIR__);统一工作目录，避免路径漂移 - 如果项目已启用 Composer autoload，别再用
include_once手动加载类文件——autoloader 会按命名空间自动找，重复 include 既多余又可能引发“Cannot redeclare class”错误 - 用
get_included_files()查看当前已加载哪些文件，调试时比猜路径快得多 - 某些 SAPI（如 PHP-FPM）会复用进程，
include_once的“once”是进程级的，跨请求不会重复加载——这点常被当成 bug 报，其实是设计如此
最常被忽略的是：include_once 的“once”只认文件路径字符串，不解析符号链接。/var/www/app/config.php 和 /var/www/app/../app/config.php 被视为两个文件，都会加载。真要确保唯一，得先用 realpath() 规范路径。
