swoole扩展未启用导致composer install失败，需确认PHP环境已正确安装并加载swoole扩展，检查php.ini配置、PHP与Swoole版本兼容性，并确保编译时启用--enable-coroutine等必要参数。
composer install 时提示 swoole 扩展未启用
这通常不是 composer 自身的问题，而是 swoole 扩展没装好或 PHP 配置未加载。Composer 只检查 composer.json 中的 "ext-swoole": "*" 这类扩展依赖声明，不负责编译或启用扩展。
执行以下命令确认当前 PHP 环境是否真正支持 Swoole：
php -m | grep swoole php --ri swoole
如果报错 Extension 'swoole' not found 或无输出，说明扩展未安装成功或未写入 php.ini。此时 composer install 会直接失败（PHP Fatal error 或 “Your requirements could not be resolved”）。
- 检查
php.ini是否包含extension=swoole（Linux/macOS 通常是extension=swoole.so，Windows 是extension=php_swoole.dll） - 确认
php -i | grep "Loaded Configuration File"输出的配置文件路径正确，且修改的是该文件 - 重启 Web 服务器（如 Apache）或 PHP-FPM 进程，CLI 和 FPM 的
php.ini可能不同
编译 Swoole 时必须开启的 configure 参数
Swoole 默认编译不开启协程 Hook，而 Laravel Octane、Hyperf、Swoft 等主流框架强依赖 --enable-coroutine。漏掉这个参数会导致运行时报 Co::sleep() not available 或协程无法调度。
推荐基础编译命令（以 PHP 8.1+、Swoole v5.1.x 为例）：
cd swoole-src ./configure \ --enable-coroutine \ --enable-http \ --enable-mysqlnd \ --enable-openssl \ --enable-swoole-json \ --enable-swoole-curl \ --with-php-config=/usr/bin/php-config
-
--enable-coroutine是必须项，否则Swoole\Coroutine类不可用 -
--enable-http启用Swoole\Http\Server，Octane 依赖它 -
--enable-mysqlnd允许协程 MySQL 客户端（Swoole\Coroutine\Mysql），避免 PDO 阻塞 -
--with-php-config必须指向你实际使用的 PHP 版本的php-config，多版本共存时极易填错
PHP 版本与 Swoole 版本兼容性陷阱
新版 Swoole（如 v5.1+）已 放弃支持 PHP 7.4，但 Composer 不会主动校验 PHP 小版本兼容性，只看 php 字段的语义版本范围（如 "^8.0"）。结果就是：依赖能装上，扩展能编译，但运行时崩溃。
常见报错包括：
-
Segmentation fault (core dumped)（PHP 7.4 + Swoole 5.0+） -
PHP Warning: Module 'swoole' already loaded in Unknown on line 0（重复加载，常因旧版 .so 文件残留） -
Fatal error: Uncaught Error: Class 'Swoole\Http\Server' not found（扩展编译时未加--enable-http，但 composer 没报错）
查兼容表最直接的方式是访问 Swoole 官方 README 的 PHP 版本支持章节，不要依赖第三方博客的过期信息。
如何让 composer install 跳过 ext-swoole 检查
仅限开发调试阶段临时绕过，不建议在 CI/CD 或生产环境使用。两种方式：
- 加
--ignore-platform-req=ext-swoole参数：composer install --ignore-platform-req=ext-swoole
- 全局禁用平台约束（危险）：
composer install --ignore-platform-reqs
（会跳过所有扩展和 PHP 版本检查）
注意：跳过检查 ≠ 程序能跑。如果代码里写了 new Swoole\Http\Server，而扩展根本没加载，运行时照样报错。真正的解决路径永远是先确保 php --ri swoole 输出正常，再让 Composer 验证通过。
