require vendor/autoload.php必须放在入口文件顶部或cli脚本首行，且仅执行一次；路径需用__dir__确保准确；改composer.json后须运行composer update；自动加载依赖映射表，非文件存在即可用。
PHP里require vendor/autoload.php到底要放在哪儿
必须在所有使用Composer包的代码之前执行，且只能执行一次。不是“随便放个地方就行”，位置错会导致Class not found或Cannot redeclare class。
常见错误现象：页面白屏、报Fatal error: Uncaught Error: Class "GuzzleHttpClient" not found，但vendor/autoload.php明明存在。
- 入口文件（如
index.php、api.php）最顶部立即require，不要等路由分发完再加载 - CLI脚本同理，
#!/usr/bin/env php之后第一行就require 'vendor/autoload.php'; - 不要在函数或条件分支里
require——自动加载器必须全局可用，延迟加载会破坏类发现机制 - 确认路径正确：
require __DIR__ . '/vendor/autoload.php';比require 'vendor/autoload.php';更安全，避免include_path干扰
composer.json改了但PHP还是用旧版本包
改完composer.json不等于生效，Composer不会自动重装或更新依赖，必须显式执行命令。
使用场景：升级monolog/monolog到^3.0后，new MonologLogger()仍报错说找不到Logger构造参数变更——其实是旧版本缓存没清。
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer update（全量更新）或composer update monolog/monolog（单包）才真正拉取新代码 -
composer install只按composer.lock还原，改composer.json却不跑update，等于白改 - 删掉
vendor目录和composer.lock再composer install是重置最彻底的方式，但别在线上直接干 - 留意
autoload段是否被手动修改过——Composer生成的autoload.php依赖该配置，乱动会导致类映射失效
为什么new一个类报错“Class not found”，但vendor里明明有那个文件”
不是文件存在就等于能用，Composer自动加载靠的是vendor/composer/autoload_*.php里的映射表，映射没生成或不匹配就找不到。
典型表现：vendor/phpunit/phpunit/src/Framework/TestCase.php物理存在，但class_exists('PHPUnitFrameworkTestCase')返回false。
- 检查
composer dump-autoload是否执行过——尤其当你手动加了psr-4映射或改了autoload配置后 - 确认命名空间与目录结构严格对应，比如
"App\": "src/"要求AppFooBar必须在src/Foo/Bar.php，多一层src/App/Foo/Bar.php就不认 - Windows下大小写不敏感，Linux服务器可能因路径大小写不一致导致加载失败（如
src/Helper/写成src/helper/） -
composer show看包是否真被安装；composer why-not vendor/package查冲突依赖
require_once和require对autoload.php的影响
用require_once是安全的，但require重复引入会直接报Fatal error: Cannot redeclare function——因为autoload.php里定义了大量函数和常量。
性能影响几乎为零，但错误引入方式会让整个项目启动失败，而且这种错误往往藏得深：某个被include的配置文件又require了一次autoload.php。
- 统一用
require_once __DIR__ . '/vendor/autoload.php';，别图省事写require - 如果用Swoole、RoadRunner这类常驻内存模型，
autoload.php只需在worker启动时加载一次，后续请求不能重复require - IDE或静态分析工具（如PHPStan）有时会误报“未加载autoload”，实际是它没走你的真实执行路径，别被误导去加冗余require
自动加载不是“有文件就能用”，它是Composer根据配置生成的一套映射+注册逻辑。路径、命令、时机、唯一性，四个点里错一个，类就消失。别假设它该工作——每次出问题，先盯住这四点。
