classmap 配置必须写死真实路径、手动执行 composer dump-autoload -a 才生效,不支持通配符或相对/绝对路径;应按用途分置于 autoload(生产)或 autoload-dev(测试),两者完全隔离。

classmap 配置必须写死路径、手动触发扫描,不支持通配符,也不自动生效——改完 composer.json 后不运行 composer dump-autoload -a,新类永远找不到。
classmap 该加在 autoload 还是 autoload-dev 里
加在 "autoload" 下才进生产环境;加在 "autoload-dev" 里只对测试生效,比如 PHPUnit 运行时能加载,但线上 new MyClass() 会直接报错 Class not found。两者完全隔离,不能混用。
- 生产用的老旧工具类(如
lib/Utils.php)、无命名空间的类、动态生成的类文件 → 放"autoload": {"classmap": [...]} - 测试专用的 Mock 类、测试辅助类 → 放
"autoload-dev": {"classmap": [...]} - 如果同时写了
autoload和autoload-dev的classmap,必须分别执行composer dump-autoload和composer dump-autoload --dev,否则其中一套不会更新
classmap 路径写法常见错误
它只认真实存在的目录或文件路径,不解析 glob、不支持 * 或 **,也不能用 ./ 开头或绝对路径。写错一个字符,整个目录就扫不到。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- ✅ 正确:
"classmap": ["src/", "app/Exceptions/", "legacy/"](结尾斜杠可选,但推荐加) - ❌ 错误:
"classmap": ["src/**/*.php"](通配符无效) - ❌ 错误:
"classmap": ["/var/www/myapp/src/"](绝对路径被忽略) - ❌ 错误:
"classmap": ["./src/"](./是多余前缀,Composer 会报路径不存在) - 扫描结果以
vendor/composer/autoload_classmap.php为准,可直接打开看有没有你期望的类名和对应路径
为什么 dump-autoload -o 没提速,而 -a 才管用
-o(optimize)只是把已有的 PSR-4 映射转成 classmap 格式,但它不会重新扫描目录;-a(archive)才是强制递归扫描 classmap 列出的所有路径,提取每个 .php 文件里的 class、interface、trait 声明。
- 如果你新增了
src/Commands/DeployCommand.php,但没跑composer dump-autoload -a,这个类就不会出现在autoload_classmap.php里 -
-o对纯 PSR-4 项目效果有限,真正提速靠的是classmap+-a+ APCu 缓存 autoloader 实例(不是缓存 classmap 数组本身) - CI/CD 部署时建议加
--no-dev --optimize-autoloader,但前提是classmap已覆盖全部生产类,否则漏掉的类会静默失败
最易被忽略的一点:classmap 不验证命名空间是否合法,也不管文件里有没有 namespace 声明——它只认 class XXX 这种字面量。所以哪怕你把 functions.php 误加进 classmap,只要里面没 class 声明,它就啥也不映射,也不会报错,只会让你以为“配置生效了”。










