composer install 是锁版本还原操作，必须基于现有 composer.lock 执行，严格按其记录安装依赖以保障协程环境一致性；若 lock 缺失则报错，需先用 composer update 生成；执行前须确认 Swoole 扩展已启用且版本匹配。
composer install 在 Swoole 协程项目里不是安装命令，是“锁版本还原”操作
它只该用在已有 composer.lock 的项目中，比如你 clone 了一个用 Swoole 的 Laravel Octane 或 Hyperf 项目，或者 CI/CD 构建阶段。此时 composer install 会严格按 lock 文件装包，不升级、不变更依赖树——这对协程环境极其关键：Swoole 生态对底层扩展（如 ext-swoole）、PHP 版本、甚至某些库的协程兼容性非常敏感，随意升级可能直接导致 Co::sleep() 失效或 Swoole\Coroutine\Mysql 连接阻塞。
常见误用场景：
- 本地新项目，没
composer.lock就跑composer install→ 报错 “No composer.lock file present” - 想装新包却执行
composer install→ 什么都不会加，vendor/ 里还是旧状态 - 线上部署时用
composer update替代composer install --no-dev→ 可能引入不兼容版本，服务启动失败
执行前必须验证 Swoole 扩展已真正启用，否则 install 会卡死或报错
composer install 不负责装 Swoole，但它会检查 composer.json 中声明的 "ext-swoole": "*" 等扩展依赖。如果 PHP 环境里 php --ri swoole 没输出或显示 disabled，install 会直接中断并报类似 Your requirements could not be resolved 的错误，而不是告诉你“Swoole 没装好”。
确认三件事再运行：
-
php -m | grep swoole有输出（说明扩展已编译） -
php --ri swoole输出含enabled和Version => 5.1.x（说明 php.ini 已加载且版本匹配） -
php -i | grep "Loaded Configuration File"指向你刚改过的 php.ini，且该文件里有extension=swoole.so（Linux/macOS）或extension=php_swoole.dll（Windows）
协程项目特有的 lock 文件陷阱
很多 Swoole 封装库（如 swooletw/laravel-swoole、hyperf/framework）在 lock 文件里绑定了特定版本的 ext-swoole 兼容层或协程适配器。如果你本地 PHP 是 8.2，但 lock 文件生成于 PHP 8.1 + Swoole 4.8 环境，composer install 可能因平台约束失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
检查点：
- 运行
composer install -v，看日志里是否出现ext-swoole [required version]和当前 PHP 实际支持的版本冲突 - 若报
ext-swoole: * is not satisfied by your platform，不是 Composer 问题，是 PHP+Swoole 环境没对齐 - 别删 lock 文件后硬跑
composer install—— 它会拒绝执行；应先composer update --lock（仅更新 lock，不动 vendor），再 install
install 后类找不到？大概率是 autoload 或协程 Runtime 没初始化
装完依赖不代表能用。Swoole 协程项目常要求手动触发协程 Hook，否则 file_get_contents、curl_exec 这些函数仍是同步的，哪怕 php --ri swoole 显示正常。
典型补救步骤：
- 在入口文件（如
bin/hyperf.php或server.php）顶部加：Swoole\Runtime::enableCoroutine(true); - 确认
composer dump-autoload已执行，尤其当你修改了autoload配置或加了自定义命名空间 - Laravel +
swooletw/laravel-swoole需检查config/swoole_http.php中'auto_reload'是否关掉（开发时可开，生产必须关）
最易被忽略的是：Swoole 5.x 默认不启用协程 Hook，即使扩展装好了、lock 文件对了、autoload 也刷了，漏掉 Swoole\Runtime::enableCoroutine() 就等于没开协程。
