Composer卡在downloading主因是直连Packagist官方源超时，应切换阿里云等有效镜像并清缓存；若仍失败，需验证镜像是否生效、是否弃用、PHP版本匹配，并优先用create-project替代require。
为什么 composer require easyswoole/easyswoole 卡在 downloading 阶段
国内直连 Packagist 官方源（https://packagist.org）经常超时或限速，尤其下载 swoole 扩展依赖或大体积 vendor 包时，composer require 会长时间卡在 Downloading... 或报 Connection timed out。这不是 EasySwoole 本身的问题，而是网络策略导致的源访问失败。
设置全局中文镜像后仍无法安装 easyswoole/easwoole 的常见原因
即使已配置镜像，composer require easyswoole/easyswoole=3.5.x 仍失败，大概率是以下任一情况：
- 镜像未生效：执行
composer config -g repo.packagist确认输出为https://packagist.phpcomposer.com或https://mirrors.aliyun.com/composer/，而非https://packagist.org - 镜像源已弃用：如
phpcomposer.com自 2024 年起已停服，继续使用会导致 404 或重定向失败 - PHP 版本不匹配：EasySwoole 3.x 要求 PHP ≥ 7.2，但部分镜像会缓存旧版元数据，若本地 PHP 是 8.2，而镜像返回了仅兼容 7.4 的包列表，
composer可能静默跳过或报could not find a version - 未清理缓存：执行过失败安装后，
composer会缓存错误响应，需手动清空：composer clear-cache
composer create-project 比 require 更可靠的原因
对 EasySwoole 这类需要初始化骨架结构（App/、Router.php、Index.php）的框架，composer create-project 是更稳妥的选择 —— 它绕过依赖解析阶段的镜像元数据歧义，直接克隆预构建项目模板。
实操命令（推荐阿里云镜像）：
composer create-project easyswoole/easyswoole=3.7.x myapp --repository=https://mirrors.aliyun.com/composer/
注意点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须显式指定
--repository，否则仍走默认源 - 不要用
=dev-master，EasySwoole 3.x 的dev-master已指向 4.x 分支，与 PHP 8+ 兼容性不稳定 - 创建完成后，进入目录再执行
php vendor/bin/easyswoole install，这步仍需联网，但只拉取少量脚本，成功率高
宝塔面板中启用镜像却无效的典型配置错误
宝塔用户常在「软件商店 → PHP → 设置 → Composer 镜像」里勾选“启用镜像”，但该开关仅影响宝塔内部调用，不影响你 SSH 终端里手动执行的 composer 命令。
真正生效的方式只有两种：
- 全局配置（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级配置（适合多版本共存）：在项目根目录运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/，生成composer.json中的repositories字段
验证是否生效：运行 composer show easyswoole/easyswoole | head -n 3，若第一行显示 name : easyswoole/easyswoole 且无超时，则镜像已就位。
最后提醒：EasySwoole 的 vendor/easyswoole/easyswoole/bin/easyswoole 是入口脚本，它不走 Composer 自动加载逻辑，所以即使镜像配置正确，php vendor/bin/easyswoole install 执行时仍可能因 Swoole 扩展缺失而失败 —— 这和镜像无关，得先确保 php --ri swoole 有输出。
