include_once 仍报“cannot redeclare”因只比较物理路径，不识别逻辑等价路径；软链接、nfs、docker卷等导致 realpath() 不稳定；应统一用绝对路径、启用 require_once 关键文件、优先使用 autoloader，并用 define 守卫防重复加载。
include_once 为什么还会报 Cannot redeclare function
因为 include_once 只认「物理路径是否相同」，不认逻辑等价。比如 ./config.php 和 config.php 在 PHP 看来是两个文件；软链接、NFS 挂载、Windows Docker 共享卷下 realpath() 返回不稳定，也会导致判断失效。
常见错误现象：Fatal error: Cannot redeclare my_helper_function()，但代码里只写了 1 次 include_once 'helpers.php'。
- 统一用绝对路径：改写为
include_once __DIR__ . '/helpers.php'; - 避免混用相对路径变体（
lib/utils.php、./lib/utils.php、../app/lib/utils.php） - 开发时开
opcache.enable=0，防止 OPcache 缓存了错误的 realpath 映射
require_once 比 include_once 更适合关键文件
两者防重复逻辑一致，但 require_once 在文件不存在时抛 Fatal error 并终止执行，而 include_once 只报 Warning 继续跑——这会让配置缺失、类定义失败等问题被掩盖。
使用场景：加载核心配置、数据库连接、框架启动器等不可缺的文件。
- 生产环境所有关键依赖都该用
require_once - 入口脚本第一行就该是
require_once __DIR__ . '/vendor/autoload.php';（Composer 场景） - 不要为了“兼容性”在关键路径上退化成
include_once，错误早暴露比晚崩溃代价小得多
autoload 比 include_once 更可靠
手写 include_once 是脆弱的源头：路径硬编码、顺序敏感、无法跨命名空间复用。而 autoloader 天然幂等，且由 PHP 内核保证「类未注册才加载」。
哪怕不用 Composer，也能 5 行写出安全 autoloader：
spl_autoload_register(function($class) {
$file = __DIR__ . '/src/' . str_replace('\', '/', $class) . '.php';
if (file_exists($file)) require $file;
});
- 函数库要进命名空间或类中，别留裸函数在全局作用域
- 类文件名必须严格匹配 PSR-4 规则（如
AppUtilLogger→src/Util/Logger.php） - 禁用
__autoload()（已废弃），只用spl_autoload_register()
define + require 守卫比 include_once 更易调试
当必须加载过程式代码（比如老项目 config.php）又怕多处 include 导致 define() 冲突时，守卫常量比 include_once 的静默跳过更可控。
错误信息对比：Constant MYAPP_CONFIG_LOADED already defined 直接指出谁重复加载了，而 include_once 出错时你得翻日志找哪个文件先触发了定义。
- 写法：
if (!defined('MYAPP_CONFIG_LOADED')) { define('MYAPP_CONFIG_LOADED', true); require 'config.php'; } - 常量名必须带项目前缀，避免和第三方库冲突
- 注意：
require失败会 fatal，include失败只是 warning，这里用require是为了保底语义明确
真正难的不是选 include_once 还是 require_once，而是路径归一化和加载时机控制——同一份代码在 CLI、Web、测试环境下 __DIR__ 含义不同，realpath() 行为也可能分裂。这些细节不压平，光换关键字没用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
