Composer无法安装Swoole运行时扩展，因swoole/swoole仅为IDE补全用的stub包；必须通过PECL（Linux/macOS）或DLL（Windows）系统级安装swoole.so/dll，并在php.ini中启用，再验证extension_loaded('swoole')返回true。
Composer 不能安装 Swoole 增强库——因为根本不存在叫“Swoole 增强库”的独立 Composer 包。你真正需要的，是明确区分两类东西：Swoole 运行时扩展（必须系统级安装），和仅用于开发辅助的 PHP 封装包（如 IDE 补全、类型提示）。
为什么 composer require swoole/swoole 总失败
执行 composer require swoole/swoole 会报 Could not find a version of package swoole/swoole matching your minimum-stability 或直接 404，这不是网络或配置问题，而是这个包在 Packagist 上压根不提供运行时能力。它只是一个空壳 stub 包，只含 ext-swoole 声明和 PHPDoc 注释，连一个真实类定义都没有。
- 该包唯一作用是让 IDE（如 PhpStorm/VS Code）识别
Swoole\命名空间，补全函数签名 - 它不包含任何 C 扩展逻辑，也**不会**触发 PECL 安装或编译
- 如果你本地没装好
swoole.so，装完这个包照样报Class 'Swoole\Http\Server' not found - 版本必须对齐：Swoole 5.x 对应
swoole/ide-helper:^5.0，4.x 对应^4.12
怎么正确安装 Swoole 运行时扩展
这才是真正决定你能不能用协程、HTTP Server、异步 MySQL 的一步。Composer 不参与、也不接管这个过程。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS 推荐用
pecl install swoole，但注意默认不开启关键特性：要支持协程 Hook（比如让file_get_contents变成非阻塞），得重装并加参数：pecl install swoole-5.0.3 --configureoptions enable-coroutine=yes,enable-http=yes - Windows 用户需去 windows.php.net/pecl 下载对应 PHP 版本和线程安全标识（TS/NTS）的
php_swoole.dll，放进ext/目录，再在php.ini里写extension=php_swoole.dll - 验证是否生效，别只看
php -m | grep swoole：运行php --ri swoole，确认输出里有Version => 5.0.3和Directive => enabled - Docker 构建时顺序不能错：必须
RUN pecl install swoole在RUN composer install之前，且确保两者使用同一 PHP 环境（php-config路径一致）
composer.json 里 "ext-swoole": "*" 是干什么的
它不是安装指令，而是一个环境守门员：Composer 在 install 或 update 阶段会检查当前 PHP 是否已加载 Swoole 扩展。如果没加载，直接中止，不生成 autoloader。
- 适合强依赖 Swoole 的项目（如 Hyperf、Easyswoole），避免部署到没装扩展的机器上还假装成功
- 不适合“可选加速”场景（比如 CLI 命令用协程提速，但不用也能跑），这时应删掉该行，改用运行时判断：
extension_loaded('swoole') - CI/CD 中很关键：它能让构建镜像失败得更早，而不是等容器启动后才抛出
Class not found - 注意：这个字段对 PHP-FPM 和 CLI 是分别校验的，如果你只在 FPM 的
php.ini里启用了扩展，但composer install是在 CLI 下执行的，依然会失败
装完扩展后还是报错？重点查这三处
绝大多数“明明装了却用不了”的问题，都卡在这几个具体位置，而不是 Composer 或代码本身。
-
php --ini输出的Loaded Configuration File路径，是否真被你编辑了？多版本 PHP 下常改错文件（CLI 和 FPM 的php.ini通常不同） -
extension=swoole这行是否写在该php.ini文件里？注意 PHP 8.0+ 可省略.so后缀，但写成extension=swoole.so在旧版本会失败 - 修改后是否重启了对应服务？CLI 模式无需重启，但
php-fpm必须systemctl restart php-fpm，Apache 需systemctl restart apache2 - 最后验证：运行
php -r "var_dump(extension_loaded('swoole'));"，输出bool(true)才算真正就位
最容易被忽略的是：Swoole 扩展启用后，协程能力仍需显式开启。比如 php.ini 里没配 swoole.enable_coroutine = On 或 swoole.hook_flags = 131071，Swoole\Coroutine\run() 能执行，但 file_get_contents 还是阻塞的——这点不看文档几乎没人主动配。
