Composer无法安装Swoole扩展，因其是PHP C扩展，必须通过pecl install swoole（Linux/macOS）或下载php_swoole.dll配置php.ini（Windows）系统级安装，中文镜像仅加速纯PHP库下载，对C扩展无效。
Composer 不能安装 Swoole 扩展本身，中文镜像只加速 PHP 库下载，对 C 扩展毫无作用——装完 composer require swoole/http-server 后仍报 Class 'Swoole\Http\Server' not found，99% 是因为根本没装好 swoole.so。
为什么中文镜像对 Swoole 安装“无效”
Composer 镜像（如阿里云、腾讯云）只代理 Packagist 上的纯 PHP 包，而 Swoole 是 PHP 的 C 扩展，必须编译进 PHP 运行时。你看到的 swoole/swoole 或 swoole/ide-helper 这类包，只是空壳或辅助工具：
-
swoole/swoole：Packagist 上已废弃的占位包，装了也没 extension -
swoole/ide-helper：仅提供 PhpStorm/VS Code 的代码提示，不解决php --ri swoole报错 -
swooletw/laravel-swoole或hyperf/framework：这些是封装库，启动前必须确保ext-swoole已加载且版本匹配
中文镜像真正该用在哪几个环节
虽然装不了扩展，但中文镜像能显著加快以下步骤：
- 拉取框架骨架：
composer create-project hyperf/hyperf-skeleton（Hyperf 官方 skeleton 体积大，镜像提速明显） - 安装封装库：
composer require swooletw/laravel-swoole、composer require hyperf/redis - 更新依赖时避免超时：
composer update在国内网络下更稳定 - 配置方式（全局）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：composer config 只影响后续命令，已执行失败的 create-project 需重试，不是“配完就自动重下”。
装 Swoole 扩展的实操路径（PHP 8.2 环境）
别再搜“Composer 安装 Swoole”，直接按环境走：
- Linux（推荐）：
pecl install swoole，前提是已装php-dev（Ubuntu/Debian）或php-devel（CentOS/RHEL），且php-config指向 PHP 8.2 - 宝塔面板：软件商店 → PHP 8.2 → 安装扩展 → 勾选 Swoole（路径固定为
/www/server/php/82/bin/phpize） - Docker：Dockerfile 中写
RUN pecl install swoole && docker-php-ext-enable swoole，别漏docker-php-ext-enable - Windows：去 windows.php.net/pecl 下载匹配 TS/NTS + VC 版本的
php_swoole.dll，手动加到php.ini
验证是否真生效，只认这一条命令：php --ri swoole。输出里必须有 enabled 和 Version => 5.1.x，且 Directive 行存在。
容易被忽略的协程 Hook 和配置断点
Swoole 5.x 在 PHP 8.2 上默认不开启协程 Hook，file_get_contents()、curl_exec() 仍是同步阻塞——这不是 Composer 或镜像的问题，而是运行时缺失调用：
- 必须在服务启动早期（如
server.php开头）加：Swoole\Runtime::enableCoroutine(); - Laravel 使用
swooletw/laravel-swoole时，需确认config/swoole_http.php中'server' => ['mode' => SWOOLE_PROCESS]，否则协程调度异常 - Hyperf 启动失败报
SWOOLE_VERSION mismatch，先看php --ri swoole版本，再查composer.lock里 Hyperf 锁定的 Swoole 兼容范围（如"swoole/swoole": "^4.8"）
真正的坑不在 Composer 配置，而在 PHP CLI 和 FPM 加载了不同 php.ini——改完 extension=swoole.so，记得分别验证 php --ini 和 php-fpm -i | grep "Loaded Configuration File"。
