Composer在Windows上安装成功的关键是PHP环境可用且PATH配置正确。需确保php -v可执行、openssl/curl扩展启用,使用官方Composer-Setup.exe安装并勾选“Add to PATH”,安装后新开终端验证composer --version,并建议配置国内镜像源及定期更新。

composer 在 Windows 上能装好,关键就两点:PHP 环境必须可用,PATH 必须写对。其他都是顺带的事。
确认 PHP 已就位且可全局调用
Composer 是 PHP 工具,不是独立程序——没 php.exe,它根本启动不了。
- 打开命令提示符(cmd),运行
php -v;如果报“不是内部或外部命令”,说明 PHP 没进 PATH,得先处理 - PHP 安装路径(比如
C:\php或D:\xampp\php)必须添加到系统环境变量Path中 - 别忘了检查
php.ini里是否启用了extension=php_openssl.dll和extension=php_curl.dll——缺一个,安装时就卡在 SSL 错误或连接超时
用官方安装器一键装好,别手搓
虽然有手动下载 composer.phar + 写 composer.bat 的方式,但 Windows 下真没必要。官方 Composer-Setup.exe 已经把路径、权限、扩展检测全包了。
- 去 https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114 下载
Composer-Setup.exe - 双击运行,安装向导会自动扫描
php.exe;如果扫不到,就手动选(例如C:\php\php.exe) - 务必勾选 “Add to PATH” —— 这一步省掉后续所有手动配环境变量的麻烦
- 安装路径默认是
C:\ProgramData\ComposerSetup\bin,这个目录会被自动加进系统Path
验证是否真能用,而不是“以为能用”
很多人输完 composer --version 没反应,第一反应是“装坏了”,其实只是终端没重载环境变量。
- 安装完必须新开一个 cmd 或 PowerShell 窗口再试——旧窗口不会自动读新 PATH
- 运行
composer --version,看到类似Composer version 2.7.6才算成功 - 如果仍报“不是内部或外部命令”,检查:
–C:\ProgramData\ComposerSetup\bin是否确实在系统Path里(注意C:\ProgramData是隐藏文件夹)
– 是否以管理员身份运行过安装器(尤其选了 “Install for all users” 时)
换国内源,不然第一次 require 能等三分钟
默认源 https://packagist.org 在境外,Windows 下 DNS + TLS 握手慢,经常卡在 “Loading composer repositories…”
- 执行这行命令切阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 想换回去?删掉配置就行:
composer config -g --unset repos.packagist
- 注意:有些老教程推
packagist.phpcomposer.com,该域名已停用,别再用
php.exe 路径是否还被 Composer 认出;还有,composer self-update 建议定期跑一次,2.x 小版本更新常带安全修复和兼容性补丁。










