Composer

约 460 字大约 2 分钟

2025-06-19

本文整理 Composer 常用命令和国内镜像配置方法。

基础命令

项目初始化

# 初始化当前目录为 Composer 项目
composer init

# 安装依赖（根据 composer.lock）
composer install

# 更新依赖
composer update

包管理

# 安装包
composer require vendor/package
composer require vendor/package:^2.0

# 安装开发依赖
composer require --dev phpunit/phpunit

# 全局安装
composer global require laravel/installer

# 删除包
composer remove vendor/package

查看信息

# 列出已安装的包
composer show

# 查看依赖树
composer show -t

# 查看指定包详情
composer show vendor/package

# 查看包的实际安装路径
composer show -i

自动加载

# 优化自动加载（生产环境）
composer dump-autoload -o
composer dump-autoload -a  # 生成类映射缓存

镜像配置

查看镜像源列表

composer repo:list

切换镜像源

# 阿里云
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

# 华为云
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/

# 腾讯云
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/

# PHPComposer
composer config -g repo.packagist composer https://packagist.phpcomposer.com

取消镜像配置

# 取消全局镜像
composer config -g --unset repos.packagist

# 取消当前项目镜像
composer config --unset repos.packagist

常见问题

下载速度慢

切换到国内镜像源即可解决，推荐阿里云或华为云。

`composer install` 与 `composer update` 区别

命令	说明
`install`	根据 `composer.lock` 锁定版本安装，保证环境一致
`update`	检查最新版本并更新，会重写 `composer.lock`

生产环境始终使用 composer install。

依赖冲突

# 查看冲突原因
composer diagnose

# 尝试修复
composer update vendor/package --with-all-dependencies

内存不足错误

# 增加 PHP 内存限制
php -d memory_limit=-1 $(which composer) update

优化生产环境部署

# 1. 只安装生产依赖，优化自动加载
composer install --no-dev --optimize-autoloader

# 2. 忽略不需要的平台检查（CI 环境）
composer install --ignore-platform-reqs