Composer是PHP依赖管理工具，用于安装Laravel/Lumen/Slim等API框架及JWT、CORS等扩展，需正确配置autoload、避免版本冲突与类加载失败。
Composer 本身不是 API 框架，也不能“集成”进框架——它是 PHP 的依赖管理工具，所有现代 PHP API 框架（如 Laravel、Lumen、Slim、Symfony）都靠它安装和更新自身及扩展包。 你真正要做的，是用 Composer 正确引入框架、配置自动加载、管理 API 相关扩展（如 JWT、CORS、API 文档生成器），并避免因 autoload 或版本冲突导致路由不生效、类找不到等典型问题。
如何用 Composer 安装主流 API 框架（Laravel/Lumen/Slim）
别从零写 composer.json ——直接用官方推荐的创建命令，确保骨架结构和 autoload 配置正确：
-
composer create-project laravel/lumen api-server（Lumen 轻量级 API 框架，开箱支持 JSON 响应） -
composer create-project laravel/laravel api-server --prefer-dist（完整 Laravel，适合需 Eloquent + Auth + 中间件的复杂 API） -
composer create-project slim/slim-skeleton api-server（Slim，极简，依赖少，适合微服务边界网关）
注意：create-project 会自动执行 composer install 并生成 vendor/autoload.php，这是所有框架能运行的前提。手动 require 这个文件失败，90% 是路径写错或没执行 install。
添加 API 必备扩展时的常见坑（JWT/CORS/OpenAPI）
用 composer require 安装扩展时，必须核对框架兼容性，否则类存在但中间件注册失败、或方法签名不匹配：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Laravel/Lumen：用
tymon/jwt-auth（v1.x 对应 Laravel 5.8–6.x；v2.x 起只支持 Laravel 9+，改用laravel/jetstream或spatie/laravel-jwt） - Slim：
slim/jwt-auth需配合firebase/php-jwtv6.x（v7+ 不兼容 Slim 4 的 PSR-7 实现） - CORS：Laravel 用
fruitcake/laravel-cors（v3+ 要求 Laravel 9+）；Slim 用tuupola/cors-middleware - OpenAPI 文档：Laravel 推荐
darkaonline/swagger-lume（适配 Lumen）或knuckleswtf/scribe（自动生成，支持 Laravel 8+）
关键点：扩展包的 composer.json 里 "autoload" 部分是否包含 "psr-4" 映射？没有的话，php artisan vendor:publish 或 ./vendor/bin/scribe 可能静默失败。
为什么 Class not found 错误总在 API 路由里爆发？
不是代码写错，而是 Composer 的 autoloader 没覆盖到你的 API 控制器或 DTO 类——尤其当你把 API 相关类放在非标准目录（比如 app/Api/V1/Controllers）时：
- 检查
composer.json的"autoload"→"psr-4"是否包含该命名空间映射，例如："autoload": { "psr-4": { "App\": "app/", "App\Api\V1\": "app/Api/V1/" } } - 改完后必须运行
composer dump-autoload（开发中可加-o优化，但调试阶段先不用） - Lumen 默认关闭自动发现（
APP_DEBUG=false时composer.json的"autoload-dev"不生效），确保bootstrap/app.php中$app->withFacades();和$app->withEloquent();按需开启
一个典型现象：Postman 调用返回 Class 'AppApiV1ControllersUserController' not found，但文件明明存在——八成是 autoload 配置漏了 App\Api\V1\ 这一行。
最易被忽略的其实是 composer.lock 文件的提交与部署一致性：本地 composer install 成功，线上却报错，往往因为线上没拉最新 lock 文件，或用了 composer update 覆盖了锁定版本。API 服务对依赖版本敏感，jwt-auth 升一个小版本就可能让 token 解析逻辑变更。
