Composer能否装上取决于PHP CLI是否可用、必需扩展（openssl、mbstring、json、zlib）是否启用、PHP版本是否匹配（如PHP 8.0+需Composer 2.5+），且须校验安装脚本SHA384、配置国内镜像源并确保PATH正确。
Composer 能不能装上，90% 取决于 PHP 环境是否真正就绪——不是“有 PHP”，而是“PHP CLI 可用 + 扩展启用 + 版本匹配”。
php -v 能跑不代表环境合格
很多用户执行 php -v 有输出就以为万事大吉，结果 composer --version 报错或卡死。真实问题常藏在细节里：
- Windows 用户常见：XAMPP/WAMP 安装时没勾选 “Add PHP to PATH”，或 php.ini 中
extension=openssl、extension=mbstring仍被注释 - Linux/macOS 用户常见：系统自带 PHP（如 CentOS 的
php -v显示 7.2）和 Web 服务用的 PHP（如宝塔里的 8.2）不是同一个；composer走的是 CLI 版本，但扩展只在 php-fpm 里启了 - Mac M1/M2 用户常见：Homebrew 安装的 PHP 默认不启用
zlib或curl，需手动改php.ini并确认extension_dir指向正确路径
必须启用的四个 PHP 扩展
缺任何一个，composer install 都可能在不同阶段失败，错误信息五花八门（比如 file_get_contents(): SSL operation failed 其实是 openssl 没开）：
-
openssl：HTTPS 请求、证书校验必需 -
mbstring：包名解析、UTF-8 字符串处理必需（ThinkPHP/Laravel 等框架强依赖） -
json：读取composer.json和composer.lock必需 -
zlib：解压 zip 包（如从 packagist 下载 dist 文件）必需
验证方式：php -m | grep -E 'openssl|mbstring|json|zlib'（Linux/macOS），Windows 可运行 php -m 后人工扫一眼。别信 phpinfo() 页面——CLI 和 Web SAPI 的配置文件可能不同。
PHP 版本与 Composer 版本必须对齐
Composer 不是向下兼容的工具。2026 年主流情况是：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PHP 8.0+ → 推荐 Composer 2.5+（官方最低要求）
- PHP 7.4 → 最高只能用 Composer 2.4.x；用 2.5+ 会直接报
ParseError或跳过 platform-check 导致依赖装错 - PHP 7.2 已彻底不支持，强行安装会失败或产生不可控行为
查当前 Composer 兼容性，别看首页文档，去官网底部链接：https://getcomposer.org/doc/00-intro.md#installation-linux-unix-macos 查小字版本说明。装之前先跑 php -v，再决定下哪个版本的 installer 或 composer.phar。
网络和证书问题不是“网不好”，是配置缺失
国内用户最常卡在 Loading composer repositories with package information 十几分钟不动，或报 SSL certificate problem：
- CentOS/RHEL：默认
ca-certificates过期，必须运行sudo yum update ca-certificates -y && sudo update-ca-trust force-enable - Windows：某些企业网络拦截 TLS 1.3，可临时加环境变量
COMPOSER_DISABLE_TLS=1（仅调试，禁用 HTTPS 不安全） - 所有平台：不配镜像源 = 基本不可用。阿里云源地址是
https://mirrors.aliyun.com/composer/，中科大是https://mirrors.ustc.edu.cn/composer/；用错已停服的旧地址（如 phpcomposer.com）也会失败
注意：composer config -g repo.packagist composer https://... 必须在 composer --version 成功之后再执行，否则命令本身都跑不起来。
真正麻烦的从来不是“怎么装 Composer”，而是弄清它背后调用的 PHP CLI 是哪个、启了哪些扩展、连的是哪套证书、走的是哪条网络路径——漏掉任意一环，都会表现为“装了却不能用”。
