composer不能安装swoole扩展，因swoole是php c扩展，须通过pecl install swoole（linux/macos）或下载php_swoole.dll配置php.ini（windows）系统级安装，并验证php --ri swoole输出enabled且版本匹配。
Composer 不能安装 Swoole 扩展组件。
Swoole 是一个 PHP **C 扩展**，必须以二进制模块（swoole.so 或 php_swoole.dll）形式编译并加载到 PHP 运行时中。而 Composer 只管理纯 PHP 的**库（library）**，比如 swoole/http-server、swoole/ide-helper 这类辅助包，它们不提供底层协程、TCP Server、异步 IO 等能力。
你执行 composer require swoole/http-server，装进去的只是一个封装了 Swoole\Http\Server 使用方式的 PHP 类库，它**完全依赖已安装的 Swoole C 扩展**。没装好 swoole.so，这些 Composer 包运行时会直接报错：Class 'Swoole\Http\Server' not found。
为什么有人误以为 Composer 能装 Swoole？
因为部分文档或脚手架项目把「引入 Swoole 相关 PHP 封装库」和「安装 Swoole 扩展」混为一谈。例如：
-
composer create-project hyperf/hyperf-skeleton—— 它只是拉取 Hyperf 框架代码，不自动装扩展 -
composer require swoole/ide-helper—— 仅提供 PhpStorm 的代码提示，不解决php --ri swoole报错问题
PHP 8.2 下真正有效的安装路径只有两条
必须先确认你的 PHP 8.2 是怎么装的（系统包管理器 / 源码编译 / 宝塔 / Docker），再选对应方式：
- Linux（推荐）：
pecl install swoole，前提是已装php-dev（Ubuntu/Debian）或php-devel（CentOS/RHEL/AlmaLinux） - Linux（需指定版本或启用特性）：源码编译，用
/path/to/php8.2/bin/phpize和--with-php-config=/path/to/php8.2/bin/php-config - Windows：下载匹配 TS/NTS + VC 版本 + x64/x86 的预编译
.dll，手动写入php.ini - 宝塔面板：软件商店点“安装扩展”，或进 SSH 手动编译（路径固定在
/www/server/php/82/）
验证是否真装好了，别被 Composer 假象骗了
装完后只认一个命令：
php --ri swoole
输出里必须含：
-
Version => 5.1.x（或 4.8.13 / 6.x，取决于你装的版本） -
enabled（不是 disabled） -
Directive => Local Value行存在（说明 ini 已生效）
如果只看到 php -m | grep swoole 有输出，但 php --ri swoole 报错或无内容，说明扩展没加载成功——此时装再多 Composer 包也没用。
php --ri swoole 显示正常，file_get_contents() 仍是同步的，必须显式调用 Swoole\Runtime::enableCoroutine() 或配置 swoole.enable_coroutine=1。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
