Windows 安装 Composer 需先启用 PHP 的 openssl 扩展,再运行官方 Composer-Setup.exe 安装器(自动配置环境变量),最后通过 composer --version 验证;安装后可执行 composer init 和 composer require 测试依赖管理功能。

在 Windows 上安装 Composer 很简单,关键是确保 PHP 环境就绪、openssl 扩展已启用,并正确完成安装流程。2025 年底仍推荐使用官方 Composer-Setup.exe 图形化安装器,稳定且兼容主流 PHP 版本(如 PHP 8.2/8.3)。
确认 PHP 已安装并启用 openssl
Composer 依赖 PHP 运行,且必须开启 php_openssl.dll 扩展,否则安装或联网操作会失败:
- 打开你的 php.ini 文件(通常在 XAMPP/WAMP/MAMP 的 php 目录下,或通过
php --ini命令定位) - 找到
;extension=openssl或;extension=php_openssl.dll,去掉前面的分号;,保存文件 - 重启 Web 服务器(Apache/Nginx)或命令行终端,执行
php -m | findstr openssl,若输出openssl即表示已启用
下载并运行官方安装程序
直接使用 Composer 官方维护的 Windows 安装器,无需手动配置 .phar 或环境变量(默认自动处理):
- 访问 https://www.php.cn/link/61e93e57223c88f7e75d968443eb49b5 下载最新版安装包(截至 2025 年 12 月仍为有效链接)
- 双击运行 Composer-Setup.exe
- 点击 Next → 勾选 Install for all users(推荐,避免权限问题)→ Next
- 安装程序会自动检测 PHP 路径;若未识别,请点击 Browse 手动选择
php.exe(例如:D:\xampp\php\php.exe) - 继续 Next → Install → Finish 完成安装
验证安装是否成功
安装后无需重启系统,直接打开新打开的 CMD 或 PowerShell:
- 输入
composer --version,回车后显示类似Composer version 2.7.7即成功 - 若提示
'composer' 不是内部或外部命令,说明环境变量未生效:检查系统环境变量Path是否包含C:\ProgramData\ComposerSetup\bin(安装器默认路径),添加后重启终端即可 - 也可运行
composer -V或composer list查看基础命令列表
简单试用:初始化一个项目
装好后马上可以测试依赖管理功能:
- 新建文件夹,例如
D:\myproject,进入该目录:cd /d D:\myproject - 运行
composer init,按提示交互式创建composer.json(或手动建一个空 JSON 文件) - 比如安装日志库:
composer require monolog/monolog - 成功后会生成
vendor/目录和autoload.php,可在 PHP 脚本中直接引入使用










