如何使用 composer require 命令添加一个新的依赖包？

composer require 命令用于安装依赖包，支持指定版本约束、开发依赖标记及多种选项控制安装行为。

直接在项目根目录下运行 composer require 命令，Composer 会自动下载包、写入 composer.json 并安装到 vendor 目录。

基本用法：指定包名和版本

最常用的方式是输入包的完整名称，例如：

• composer require monolog/monolog —— 安装最新稳定版
• composer require monolog/monolog:^2.0 —— 安装符合 ^2.0 约束的版本（如 2.10.0）
• composer require phpunit/phpunit:9.6.* —— 安装 9.6 分支的任意小版本

安装开发依赖（dev-only）

有些包只在开发或测试时需要，比如 PHPUnit 或 PHPStan，加 --dev 参数即可：

• composer require --dev phpunit/phpunit:^9.6
• 这会把包写入 composer.json 的 require-dev 字段，而非 require

跳过自动执行脚本或更新策略

默认情况下，require 会触发自动加载重生成和脚本执行。如需控制行为，可用这些选项：

PicLumen

专业的AI图像生成和图像处理工具

348

查看详情

• --no-scripts —— 不运行 post-install-cmd 等脚本
• --no-autoloader —— 暂不重建自动加载文件（之后可手动运行 composer dump-autoload）
• --update-with-dependencies —— 同时升级该包所依赖的其他包（默认只装新包）

确认安装结果

命令成功后，你会看到：

• composer.json 和 composer.lock 文件被更新
• 新包出现在 vendor/ 目录中
• 自动加载映射已生效（除非用了 --no-autoloader）

基本上就这些。不复杂但容易忽略版本约束和 dev 标记的区别。

以上就是如何使用 composer require 命令添加一个新的依赖包？的详细内容，更多请关注php中文网其它相关文章！