Composer不管理入口文件，只负责自动加载；入口文件（如index.php）须手动引入vendor/autoload.php，且必须置于最前；自定义全局函数需通过autoload.files配置并防护重复声明。
Composer 不管理入口文件，它只管自动加载
Composer 本身不定义或配置“入口文件”（比如 index.php），它也不修改你的 Web 服务器路由或 CLI 启动逻辑。你看到的“入口文件引用”，实际是通过 autoload 配置让 Composer 知道：哪些 PHP 文件该被提前载入、哪些类名对应哪些路径——仅此而已。
真正决定哪个文件是入口的，是你自己写的 index.php、public/index.php 或命令行脚本，它们手动 require Composer 生成的自动加载器（vendor/autoload.php）。
如何让 Composer 加载自定义入口级文件（如 helpers.php）
如果你有一批全局函数（比如 helpers.php），希望在项目启动时就可用，就得靠 files 自动加载类型。它会在每次调用 vendor/autoload.php 时无条件包含指定文件。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 在
composer.json的autoload或autoload-dev下添加：
"autoload": {
"files": [
"src/helpers.php",
"src/functions.php"
]
}
- 改完后必须运行
composer dump-autoload才生效 - 注意路径是相对于
composer.json所在目录的，不能写成./src/helpers.php或绝对路径 - 这些文件会被反复包含（例如 PHPUnit 运行时也会加载），所以里面不能有重复声明函数或常量，要用
function_exists()或defined()做防护
为什么 require_once 'vendor/autoload.php' 必须出现在入口文件最前面
入口文件（如 index.php）里这行代码不是可选的“配置”，而是自动加载机制生效的前提。它把 Composer 构建的整个类/文件映射关系载入 PHP 运行时。
- 如果放在中间或后面，前面 new 的类会报
Class not found - 如果用了
filesautoload，但没引入vendor/autoload.php，那些辅助函数根本不会执行 - CLI 脚本同样要加这一行，哪怕只是跑一个单文件命令
- 某些框架（如 Laravel）已帮你封装好这步，但纯 Composer 项目必须手写
PSR-4 和 classmap 混用时，入口逻辑容易混乱
当你同时用 PSR-4 映射命名空间和 classmap 扫描具体文件时，入口行为可能出人意料：比如某个工具类既在 PSR-4 下可按命名空间加载，又被 classmap 扫进去了，结果类被加载两次（PHP 会报致命错误）。
- 检查
composer.json是否同时写了psr-4和classmap，且路径有重叠（例如都覆盖了src/） - 运行
composer dump-autoload -o会合并所有映射，但不会自动去重；出错时看vendor/composer/autoload_classmap.php就能发现重复条目 - 优先用 PSR-4，除非你要加载非标准命名的旧类；
classmap更适合lib/这类杂项目录 - 入口文件中不要依赖“谁先加载谁后加载”的顺序，所有依赖应显式声明或通过自动加载解决
入口文件本身永远是手工编排的，Composer 只提供加载能力。最容易忽略的是：你以为配好了 autoload 就万事大吉，结果忘了在 index.php 里 require 它，或者在 files 里写了路径错误却没验证是否真被包含了。
