composer require 用于添加 PHP 依赖,如 composer require guzzlehttp/guzzle 安装 Guzzle,支持指定版本如 ^2.0 或使用 --dev 添加开发依赖。

使用 composer require 是在 PHP 项目中添加依赖最常用的方式。它会自动下载指定的包,并将其加入 composer.json 文件的依赖列表,同时更新 composer.lock 文件。
基本语法
命令格式如下:
composer require vendor/package-name例如,要安装 Guzzle HTTP 客户端:
composer require guzzlehttp/guzzle执行后,Composer 会:
- 查找最新稳定版本的 guzzlehttp/guzzle
- 下载并放入 vendor/ 目录
- 自动在 composer.json 中添加该依赖
- 生成或更新 composer.lock 记录确切版本
指定版本号
你可以在包名后加上版本约束,控制安装的具体版本:
composer require monolog/monolog ^2.0常见版本写法包括:
- ^2.0:兼容 2.x 的最新版本(不包含 3.0)
- ~1.10:从 1.10 开始,但不超过 2.0
- 1.18.1:精确安装这个版本
添加开发依赖
某些包只在开发时需要,比如测试工具。使用 --dev 参数将其加入 require-dev:
composer require phpunit/phpunit --dev这类依赖不会在生产环境安装(配合 composer install --no-dev 使用)。
注意事项
运行 composer require 前建议:
- 确认项目根目录有 composer.json,如果没有,先运行 composer init
- 确保网络可访问 packagist.org
- 执行完成后提交 composer.json 和 composer.lock 到版本控制
基本上就这些。只要记住包名和版本规则,添加依赖就很直接。










