require_once与composer autoload须职责分离：前者用于引导、动态路径或调试等特定场景，后者通过psr-4/classmap/files自动加载；混用易致重复定义或类找不到。
能一起用，但必须分清职责边界：require_once 是手动加载单个文件的底层机制，Composer autoload 是基于 PSR-4/classmap/files 规则的自动类/函数发现系统；混用时若不明确分工，极易导致重复定义、类找不到或函数重载报错。
require_once 和 vendor/autoload.php 的关系
vendor/autoload.php 是 Composer 自动生成的入口文件，它本身内部就用了多个 require_once（比如加载 autoload_real.php、autoload_static.php 等）。你在项目入口写 require_once 'vendor/autoload.php'，本质是“一次性委托给 Composer 全权处理后续所有类和文件的加载”。
常见错误是：在已引入 vendor/autoload.php 后，又手动 require_once 'src/Helper.php' 或 require_once 'vendor/some-lib/lib.php' —— 这不仅多余，还可能因路径不一致或加载顺序问题引发 Fatal error。
- 只要类/函数已正确声明在
composer.json的autoload或autoload-dev中，就不要手动 require - vendor 目录下的第三方库，必须通过 Composer 安装（
composer require xxx），不能直接下载后用 require_once 引入——否则其依赖无法解析 - 若某个文件确实需要“无论 autoload 是否生效都强制加载”（如全局配置、环境补丁），应走
files配置，而不是手写 require_once
什么时候必须用 require_once（绕过 autoload）
只有三类情况值得保留手动 require_once：
-
vendor/autoload.php尚未加载前的引导代码，比如早期日志初始化、环境变量加载（require_once 'env.php'） - 动态路径或运行时才确定的文件，比如插件目录下按条件加载的
plugin-{$name}/init.php，这种无法被 Composer 静态分析 - 调试临时 bypass：比如想跳过 autoload 查看某个类原始定义是否语法错误，可
require_once 'src/MyClass.php'单独加载测试
注意：这类手动加载的文件，不能与 files 配置中的路径重复，否则会触发 Cannot redeclare function 错误。
autoload 配置里 files 和 require_once 的等价性
"files" 字段在 composer.json 中声明的路径，会在每次 PHP 请求启动时被 require_once 一次——Composer 内部就是靠它实现“全局函数自动可用”。所以：
- 写
"files": ["src/helpers.php"]等价于在vendor/autoload.php执行时自动插入require_once 'src/helpers.php' - 但你不能在
helpers.php里再写require_once __DIR__ . '/helpers.php'，这是典型循环加载 -
files路径必须相对于composer.json，不能带./或绝对路径，否则composer dump-autoload会失败并报错file not found
容易忽略的加载顺序陷阱
PHP 的 spl_autoload_register 是先进先执行，而 Composer 的 loader 默认注册时用了 $prepend = true（见 autoload_real.php），意味着它比你自己写的 autoload 函数更早响应。但 require_once 是立即执行的，不受 autoload 机制控制。
- 如果你在
vendor/autoload.php之前require_once 'my-early-loader.php'，而该文件里又定义了同名函数，就会覆盖files加载的版本 - PSR-4 类和 classmap 类冲突时（比如两个不同路径下都有
AppUser），Composer 优先返回 classmap 结果，且不报错——这会让问题潜伏到运行时才暴露 - 启用 OPcache 或预加载（preloading）时，
require_once语句仍会执行，但vendor/autoload.php内部逻辑可能已被提前编译，此时手动 require 的文件若不在 preload 列表里，会导致“类存在但方法不可用”的诡异行为
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
