Composer在Windows上需先确保PHP环境正确:运行php -v有版本号、php.ini启用openssl和zlib扩展、PHP≥7.4;推荐用官方Setup.exe以管理员身份安装并手动指定php.exe路径;装完需重启终端并验证composer --version;国内应配置阿里云镜像源。

Composer 在 Windows 上不是“安装”而是“配置生效”,直接下载 exe 安装包并完成 PATH 和 PHP 环境校验,才是关键。
怎么判断你的 Windows 能不能用 Composer
Composer 本质是 PHP 脚本,必须依赖本地已安装且能被命令行调用的 php.exe。常见失败不是因为 Composer 没装好,而是 php 命令根本不存在或版本太低。
- 打开 CMD 或 PowerShell,运行
php -v—— 必须返回版本号(如PHP 8.2.12),否则 Composer 启动就报Could not open input file: composer.phar或更隐蔽的proc_open(): fork failed - 确认
php.ini中开启openssl和zlib扩展(extension=openssl、extension=zlib),缺一不可,否则composer install会卡在“Resolving packages…”或报file_get_contents(): SSL operation failed - PHP 版本建议 ≥ 7.4;低于 7.2.5 的版本无法运行新版 Composer(会提示
Your PHP version is too old)
用官方 Installer.exe 还是手动放 composer.phar
Windows 下推荐用 Composer-Setup.exe,它自动处理三件事:下载最新 composer.phar、注册全局 composer 命令、检查 PHP 路径。手动放 composer.phar 到系统路径容易漏掉关联和权限问题。
- 从 getcomposer.org/Composer-Setup.exe 下载安装器,**右键 → “以管理员身份运行”**(否则可能写不进
C:\ProgramData\ComposerSetup\bin) - 安装时若提示 “PHP executable not found”,点 “Browse” 手动选到你 PHP 安装目录下的
php.exe(例如C:\php\php.exe),别信自动探测 - 装完后重启终端,运行
composer --version验证;如果仍报“不是内部或外部命令”,说明 PATH 没刷进去,手动把C:\ProgramData\ComposerSetup\bin加进系统环境变量
为什么 composer create-project 总卡住或超时
国内默认走 packagist.org,DNS 和连接不稳定是主因,不是网络差,而是没切镜像源。
- 执行
composer config -g repo.packagist composer https://packagist.phpcomposer.com已失效,该镜像 2022 年起停服 - 目前稳定可用的是阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果项目里已有
composer.json且含repositories字段,全局镜像会被覆盖,得改项目级配置 - 偶尔遇到
curl error 56或SSL certificate problem,不是证书问题,是 OpenSSL 版本旧或 CA 包缺失,临时加-vvv看详细错误,再决定是否升级 PHP 或换镜像
真正麻烦的从来不是点几下安装,而是 PHP 环境是否干净、PATH 是否生效、镜像源是否及时更新——这三个点任何一个没对上,composer 就会表现得像“装了但不能用”。










