不能在现有项目中用 composer require 安装 Laravel、Symfony、Yii2 等完整框架，因其依赖骨架结构和初始化逻辑；只能安全引入满足解耦条件的扩展包（如 laravel/sanctum）或纯库（如 monolog/monolog），且需手动配置、区分 dev 依赖，并验证 autoload 映射。
不能在现有项目中用 composer require 安装 Laravel、Symfony、Yii2 这类“完整框架模块”——它们不是可插拔的组件，而是需要骨架结构和初始化逻辑的独立应用体系。你真正能 require 的，是框架生态里的**扩展包（extension）或独立组件（standalone package）**，比如 laravel/sanctum、symfony/http-client、yiisoft/yii2-debug。
哪些框架模块能安全 require
只有满足以下全部条件的包，才适合用 composer require 引入：
- 不依赖框架专属入口文件（如
index.php或web/index.php） - 不修改
config/、routes/等框架配置目录结构 - 不注册全局 Artisan/Yii 命令（如
php artisan sanctum:install会失败） - 自身无 post-install-cmd 脚本，或脚本可被跳过（否则
--no-scripts后功能残缺）
典型可用模块：monolog/monolog（日志）、guzzlehttp/guzzle（HTTP 客户端）、league/flysystem（文件系统抽象）——这些是纯库，与框架解耦。
require 框架扩展包时必须配 --dev 或改配置
像 laravel/sanctum、yiisoft/yii2-gii 这类扩展，虽属框架生态，但本质仍是独立 Composer 包。引入后不会自动生效，需手动接入：
- 对 Laravel：要手动在
config/app.php的providers数组里加SanctumServiceProvider::class，再运行php artisan vendor:publish --provider="LaravelSanctumSanctumServiceProvider" - 对 Yii2：需在
common/config/main-local.php或frontend/config/main-local.php中启用模块，例如'modules' => ['debug' => 'yiidebugModule'] - 对 Symfony：多数组件需在
config/bundles.php中显式注册，如SymfonyBundleFrameworkBundleFrameworkBundle::class => ['all' => true]
开发专用模块（如调试、测试工具）务必加 --dev：
composer require --dev laravel/sail
composer require --dev phpunit/phpunit
否则上线执行 composer install --no-dev 时会被剔除，导致本地能跑、线上报错。
autoload 失效？dump-autoload 不是万能解药
引入新包后类仍报 Class not found，常见原因不是没加载，而是映射路径错位：
- 检查该包是否声明了
autoload字段（看其composer.json），有些老包只支持classmap，而你的项目用的是 PSR-4 —— 此时需手动补"classmap": ["vendor/vendorname/package/src/"] - 若包含
psr-4映射但命名空间不匹配（如包声明"MyLib\": "src/"，你却new AppLibSomething()），composer dump-autoload也救不了 - 旧项目若已有
include_path或require_once混用，Composer 自动加载可能被绕过；建议统一用require vendor/autoload.php开头，并删掉所有手动require
验证是否真生效：运行 composer show vendorname/package 看版本，再用 composer dump-autoload -p（加 -p 输出映射详情）确认类路径是否出现在生成的 vendor/composer/autoload_psr4.php 里。
require 后别直接跑框架命令
这是最容易踩的坑：以为 composer require laravel/framework 就等于“装好了 Laravel”，结果 php artisan tinker 报错 Command "tinker" is not defined。
-
laravel/framework只是核心类库，不含artisan入口、app/Providers/初始化逻辑、config/配置模板 —— 这些全靠create-project时的脚本生成 - 同理，
composer require yiisoft/yii2只拉内核，没有init工具、web/index.php、environments/目录，./yii migrate必然失败 - 如果真想把旧项目“升级成某框架”，正确路径是：用
create-project新建标准骨架 → 将旧业务代码逐步迁入app/或src/→ 用require补充缺失组件，而非反向操作
框架模块不是 npm 的 lodash，它强耦合于项目结构和生命周期。require 命令能做的，仅限于“拼图的一小块”，而不是“换掉整张画布”。
