Composer是PHP项目依赖管理工具,支持通过官方脚本、Homebrew(macOS)、Windows安装程序三种方式安装,并需验证PHP版本≥7.2.5及openssl等扩展启用,最后通过composer init和require初始化项目并安装依赖。

如果您在开发PHP项目时需要统一管理第三方库的版本和依赖关系,则Composer是PHP生态中广泛使用的依赖管理工具。以下是安装与使用Composer的具体操作步骤:
一、通过官方脚本安装Composer
该方法适用于Linux、macOS及Windows(WSL)环境,直接下载并执行官方安装脚本,可将Composer安装为全局命令。
1、打开终端,执行以下命令下载安装脚本:
curl -sS https://getcomposer.org/installer | php
2、将生成的composer.phar文件移动到系统可执行路径:
sudo mv composer.phar /usr/local/bin/composer
立即学习“PHP免费学习笔记(深入)”;
3、验证安装是否成功:
composer --version
若输出类似Composer version 2.7.7的信息,则表示安装完成。
二、使用包管理器安装(macOS Homebrew)
macOS用户可通过Homebrew快速安装Composer,避免手动处理权限与路径问题,适合偏好声明式安装流程的开发者。
1、确保已安装Homebrew,若未安装则先运行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、执行安装命令:
brew install composer
3、检查是否可用:
composer -V
成功时将显示Composer version及具体数字。
三、Windows平台安装Composer-Setup.exe
Windows用户可使用图形化安装程序,自动检测PHP环境并配置PATH,无需手动设置环境变量或验证PHP CLI路径。
1、访问官网https://getcomposer.org/download/,下载Composer-Setup.exe
2、双击运行安装程序,勾选“Add Composer to the system PATH”选项
3、点击“Next”,等待安装完成
4、打开新打开的CMD或PowerShell窗口,输入:
composer
若显示帮助信息而非“不是内部或外部命令”,即表示PATH配置生效。
四、验证PHP环境是否满足Composer要求
Composer依赖PHP CLI运行,且需启用特定扩展。安装前必须确认PHP版本不低于7.2.5,并已启用openssl、json、phar、filter、hash、zlib等扩展。
1、在终端中执行:
php -v
确认输出中PHP版本号不低于7.2.5
2、执行:
php -m | grep -E "openssl|json|phar|filter|hash|zlib"
若缺失任一模块,需编辑php.ini文件,取消对应extension行前的分号注释,例如:
extension=openssl
extension=json
3、重启Web服务器或CLI环境后再次检查,确保所有必需扩展状态为enabled。
五、初始化项目并安装依赖
Composer通过composer.json描述项目依赖,初始化后即可拉取指定版本的包及其嵌套依赖,实现可复现的构建环境。
1、进入您的PHP项目根目录:
cd /path/to/your/project
2、执行初始化命令:
composer init
3、按提示填写包名、描述、作者等信息,最后选择是否交互式定义依赖,或直接跳过
4、安装一个示例包(如monolog/monolog):
composer require monolog/monolog
执行完成后,当前目录将生成vendor/目录和composer.lock文件,vendor中包含已下载的代码,lock锁定精确版本。











