Composer是PHP领域主流的依赖管理工具，能够自动处理项目所需的第三方库下载、版本匹配和加载工作，大幅降低PHP项目的依赖管理成本。无论是开发小型个人项目还是企业级应用，掌握Composer的安装配置都是必备技能。
安装前的准备
安装Composer前需要确保系统已经安装PHP环境，并且PHP版本不低于5.3.2，同时需要开启openssl扩展。可以通过下面的命令检查PHP环境是否符合要求：
<?php
// 检查PHP版本
echo PHP_VERSION . PHP_EOL;
// 检查openssl扩展是否开启
if (extension_loaded('openssl')) {
echo 'openssl扩展已开启' . PHP_EOL;
} else {
echo '请先开启openssl扩展' . PHP_EOL;
}
?>
不同系统的安装步骤
Windows系统安装
Windows系统推荐使用官方提供的安装包进行安装，操作步骤如下：
- 访问Composer官方下载页面，获取Windows安装程序
- 双击安装包，按照引导完成安装，安装过程中会自动检测系统PHP路径，如果没有检测到需要手动指定php.exe的路径
- 安装完成后打开命令提示符，输入
composer --version验证是否安装成功
macOS和Linux系统安装
这两个系统可以通过命令行直接安装，执行下面的命令即可：
# 下载Composer安装脚本
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
# 执行安装脚本，将Composer安装到全局目录
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
# 删除安装脚本
php -r "unlink('composer-setup.php');"
安装完成后同样可以通过composer --version命令验证安装结果。
基础配置说明
配置国内镜像
默认情况下Composer会从国外源下载依赖包，速度较慢，建议配置国内镜像提升下载速度，执行下面的命令即可：
# 配置阿里云镜像 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ # 如果需要取消镜像配置，执行下面的命令 composer config -g --unset repos.packagist
常用配置项
可以通过composer config命令修改配置，常用的配置项如下：
| 配置项 | 说明 | 示例命令 |
|---|---|---|
| repo.packagist | 设置包源地址 | composer config repo.packagist composer 镜像地址 |
| vendor-dir | 设置依赖包存放目录 | composer config vendor-dir libs |
| cache-dir | 设置缓存目录 | composer config cache-dir /tmp/composer_cache |
验证安装配置结果
完成安装和配置后，可以创建一个测试项目验证Composer是否正常工作：
# 创建测试目录 mkdir test_composer && cd test_composer # 初始化Composer项目 composer init --name=test/project --description=测试项目 --require=monolog/monolog:^2.0 -n # 安装依赖 composer install
如果依赖包能够正常下载，并且项目目录下生成了vendor目录和composer.json、composer.lock文件，说明Composer安装配置成功。
常见问题解决
- 如果执行
composer命令提示找不到命令，需要检查PHP路径是否添加到系统环境变量中 - 如果安装依赖时提示权限不足，Linux和macOS系统可以在命令前添加
sudo，或者修改Composer安装目录的权限 - 如果镜像配置后下载速度仍然很慢，可以尝试更换其他国内镜像源
ComposerPHP依赖管理composer_install修改时间：2026-07-12 13:06:28