Composer是独立依赖管理工具，非PHP框架组成部分；需通过composer init生成合规composer.json（含PSR-4 autoload），用composer require区分dev/production依赖并控制版本，严格区分install（按lock）与update（重解析），autoload失败须检查映射路径、执行dump-autoload并验证文件有效性。
Composer 不是 PHP 框架的一部分，它是独立的依赖管理工具；你用 Laravel、Symfony 或纯 PHP 项目，都靠它装包、锁版本、自动加载——关键不是“怎么嵌入框架”，而是“怎么让项目正确识别并使用它”。
初始化项目时为什么必须运行 composer init 而不是直接写 composer.json
手动写 composer.json 容易漏掉 autoload 配置或写错 type 字段，导致后续 composer install 后类找不到。而 composer init 会交互式帮你生成最小可用结构，并默认推荐 PSR-4 自动加载路径（比如 "App\": "src/"）。
- 执行后检查生成的
composer.json，确认autoload下的命名空间与实际目录匹配，否则composer dump-autoload也救不了 - 如果项目已有
src/目录但没声明 autoload，composer install成功了，new AppServiceXxx()仍会报Class not found -
composer init不会覆盖已有composer.json，已有文件时直接跳过，别误以为它“没生效”
composer require 加包时哪些参数最常被忽略
加包不只写 composer require monolog/monolog 就完事。生产环境和开发依赖要分开，PHP 版本兼容性要显式控制，否则上线后可能因低版本 PHP 报错。
- 加开发专用包（如测试工具）：用
--dev，例如composer require phpunit/phpunit --dev，这样composer install --no-dev部署时就不会装它们 - 锁定特定版本（防意外升级）：用
@v2.10.0或@stable，例如composer require guzzlehttp/guzzle:^7.5@stable - 跳过平台检查（仅调试用）：遇到
Your requirements could not be resolved且确认 PHP 版本没问题，可临时加--ignore-platform-reqs，但上线前务必删掉
为什么 composer install 和 composer update 不能混用
composer install 只按 composer.lock 装包，保证所有人环境一致；composer update 会无视 lock 文件，重新解析依赖树、升级到最新兼容版本——后者在 CI/CD 或协作开发中极易引发线上 bug。
立即学习“PHP免费学习笔记（深入）”；
- 新成员拉代码后，永远先跑
composer install（确保跟 lock 一致），不是update - 想升级某个包？用
composer update vendor/package-name，而不是全量update，避免连带升级其他间接依赖 - CI 流水线里写
composer install --no-interaction --optimize-autoloader，加--optimize-autoloader能显著提升生产环境类加载速度
autoload 生效失败的三个典型表现和对应检查点
类找不到、Class 'AppHttpControllersController' not found、Call to undefined function AppUtilshelper() —— 这些都不是框架报错，是 Composer 的 autoload 没走通。
- 检查
composer.json中autoload是否包含对应路径，比如用了psr-4却把类放在app/下却没映射"App\": "app/" - 改过
autoload配置后，必须运行composer dump-autoload（加-o参数生成优化版映射） - 如果用了
files类型加载函数文件（如"files": ["app/Helpers/functions.php"]），该文件必须存在且不能有语法错误，否则整个 autoload 失败
Composer 的复杂性不在命令多，而在每个操作背后都牵扯到 composer.json、composer.lock、vendor/autoload.php 三者的状态同步；一次 update 或手改 JSON，就可能让本地能跑、测试通过、上线报错。
