Composer根本不安装C扩展，它只做存在性检查：永远不编译、下载或启用swoole等C扩展，仅在install/update时用extension_loaded()校验是否已加载；未加载则报错中断，且“ext-swoole”: ">=5.0"仅判有无、不验版本。
Composer根本不安装C扩展，它只做存在性检查
直接说结论：composer install 或 composer require 永远不会编译、下载或启用任何 C 扩展（比如 swoole、redis、gd）。它唯一能做的，是在 composer install 或 composer update 时调用 extension_loaded() 检查这些扩展是否已加载。没加载？立刻报错中断，不生成 vendor/autoload.php，也不下载任何包。
-
ext-swoole、ext-redis这类声明，只是告诉 Composer：“我代码里要用这个扩展，请你确认它现在就可用” - 报错信息如
Root composer.json requires ext-swoole *, but it is not installed，不是 Composer 没找到包，而是 PHP 根本没加载该模块 - 你在
composer.json里写"ext-swoole": ">=5.0"是无效的——Composer 不解析 Swoole 扩展自身的版本号，只认“有 or 无”
装 C 扩展必须手动，且路径/配置必须匹配当前 PHP
PHP 的 C 扩展是二进制模块，必须与当前 PHP 的 ABI（应用二进制接口）严格匹配。哪怕 PHP 小版本差一个补丁（如 8.2.10 → 8.2.11），重装扩展也常是必须的。
- Linux/macOS：优先用
pecl install swoole（自动匹配当前php-config），或从 swoole-src 源码编译（需phpize+./configure --with-php-config=$(which php-config)） - Windows：仅支持线程安全（TS）版 PHP 7.4–8.2；必须下载对应 PHP 版本的
php_swoole.dll，放进ext/目录，并在php.ini中写extension=php_swoole.dll - 验证是否成功：
php -m | grep swoole（CLI 环境）或phpinfo()（Web 环境）；注意 CLI 和 Web SAPI 可能加载不同php.ini，要分别检查
为什么 composer require swoole/swoole 一定失败？
因为根本不存在这个包。Swoole 官方从未发布过 swoole/swoole 这个 Composer 包。你搜到的所谓“安装教程”基本都混淆了两个东西：
-
核心 C 扩展：必须用
pecl或源码安装，提供Swoole\Http\Server等类的底层能力 -
PHP 绑定层（
swoole/library）：纯 PHP 包，仅含类型提示、兼容性封装、文档注释，不提供任何运行时功能；可composer require swoole/library，但装完照样报Class 'Swoole\Http\Server' not found，除非 C 扩展已启用
同理，redis/redis、mongodb/mongodb（驱动）和 ext-redis、ext-mongodb（扩展）也必须区分清楚：前者是客户端 SDK，后者才是底层模块。
立即学习“PHP免费学习笔记（深入）”；
ext- 声明在 CI/CD 和 Docker 中最容易出问题
本地 php -m 看着全，线上跑起来却报缺扩展，90% 出在环境不一致。尤其要注意：
- Docker 构建时用了
php:8.2-cli镜像，但没装php-gd包（Debian 系）或php82-gd（Alpine），composer install就会挂 - CI 流水线用
--ignore-platform-reqs强行跳过检查，结果部署后第一请求就Fatal error: Class 'PDO' not found -
platform配置（如"platform": {"ext-gd": "0"}）只影响依赖解析阶段，不解决运行时缺失；它适合交叉构建，但不能代替真实环境验证
真正可靠的流程是：在 CI 脚本开头就执行 php -m 并 grep -q gd，失败立即退出——把环境检查从 Composer 的被动报错，变成主动防御。
