require 'vendor/autoload.php'必须放在入口第一行,因为它是调用spl_autoload_register()注册加载器的启动开关,PHP在解析new或use时立即触发autoload队列,若此时未注册则直接报Class not found且不重试。

vendor 目录不是“放包的文件夹”,它是 Composer 自动加载机制的物理锚点;没引入 vendor/autoload.php 或删了 vendor/composer/,Class not found 立刻出现,且无法靠“多试几次”绕过。
为什么 require 'vendor/autoload.php' 必须放在入口第一行
这行代码本质是调用 spl_autoload_register() 注册加载器,把 PSR-4、classmap 等规则挂进 PHP 的 autoload 队列。PHP 在解析到 new SomeClass() 或 use SomeClass 时,会立刻触发 autoload 队列——如果此时还没执行这行,队列为空,直接报错,不重试。
- 不能包在
if、函数体或try/catch里:PHP 解析到类使用就触发 autoload,作用域还没进函数 - CLI 脚本中路径写成
./vendor/autoload.php很危险:当前工作目录不一定是项目根目录,路径失效 - Laravel/Symfony 等框架已封装该逻辑;纯脚本必须显式写:
require __DIR__ . '/vendor/autoload.php';
vendor/autoload.php 和 vendor/composer/autoload_*.php 是什么关系
vendor/autoload.php 是门面,只做两件事:引入 vendor/composer/autoload_real.php,再调用 ClassLoader::getLoader() 注册回调。真正干活的是 vendor/composer/ 下那些硬编码数组文件:
-
autoload_psr4.php:存命名空间前缀到路径的映射,比如['Monolog\' => ['src/']]→ 查MonologLogger就去vendor/monolog/monolog/src/Logger.php -
autoload_classmap.php:仅当配置了"classmap"或用了-o参数才生成,靠扫描class Xxx字面量登记,大小写、拼写必须完全一致 -
autoload_static.php:启用"optimize-autoloader": true后生成,把所有映射编译成静态数组,加载更快,但改了类必须手动跑composer dump-autoload
删掉整个 vendor/composer/ 目录,autoload.php 文件还在,但运行时报 Class not found 或警告找不到映射文件——因为“调度中心”还在,但“地图”没了。
vendor/monolog/monolog 这种双层路径是怎么来的
它不是约定,是硬编码:Composer 完全按 Packagist 上包的 "name" 字段拆分生成,比如 "monolog/monolog" → vendor/monolog/monolog/,"symfony/http-foundation" → vendor/symfony/http-foundation/。
- 厂商名和包名必须全小写:
Monolog/monolog会导致目录建错,PSR-4 映射失效 - 手动改
vendor/monolog/monolog成vendor/monolog/Monolog:下次composer update直接覆盖,且autoload_psr4.php仍查原路径 - 这个结构绑定包自身的
autoload.psr-4配置:比如"Monolog\": "src/"实际指向的是vendor/monolog/monolog/src/,不是你本地随便挪的路径
删了 vendor 目录后为什么 composer install 能恢复,但乱动 vendor/composer/ 就不行
vendor/ 是可重建的镜像,而 vendor/composer/ 是不可替代的元数据快照:
- 删整个
vendor/→composer install从composer.lock重新下载、解压、生成vendor/composer/全套文件,没问题 - 只删
vendor/autoload.php→composer dump-autoload就能重建它(前提是vendor/composer/还在) - 只删
vendor/composer/autoload_psr4.php→ 即使包文件都在,Class not found照出;必须composer dump-autoload重新生成,不能靠复制或手写 - 手动改
vendor/composer/autoload_psr4.php→ 下次composer install或dump-autoload会被彻底覆盖,白干
最常被忽略的一点:自动加载不是“实时扫描”,而是静态生成。改了命名空间、挪了文件、加了新类,不跑 composer dump-autoload,映射表就不会更新——哪怕文件物理存在,也加载不到。


















