普通 require 安装依赖到项目 vendor 目录，仅限当前项目使用；global require 将工具安装到用户全局目录，可在任意位置调用命令行工具。

在使用 composer 管理 php 项目依赖时，require 和 global require 是两个常用但用途完全不同的命令。它们的核心区别在于安装位置和作用范围。

1. 普通 require：项目本地依赖

当你在一个具体的 PHP 项目目录中运行：

composer require vendor/package

Composer 会把指定的包安装到当前项目的 vendor/ 目录下，并更新项目根目录中的 composer.json 和 composer.lock 文件。

这类依赖只对当前项目生效，不会影响系统其他项目或全局环境。

常见用途包括：

• 安装框架（如 laravel、symfony）
• 引入工具库（如 Guzzle、Monolog）
• 添加项目运行所需的第三方组件

2. global require：全局安装工具

当你运行：

composer global require vendor/package

Composer 会把包安装到用户主目录下的一个全局 vendor 目录中。这个路径通常是：

• macos/linux: ~/.composer/vendor/bin
• windows: %appDATA%Composervendorbin

这些包一旦安装，就可以在系统的任意位置通过命令行调用（前提是将全局 vendor/bin 添加到 PATH 环境变量）。

适合全局安装的通常是开发工具类包，例如：

• PHP-CS-Fixer（代码格式化）
• PHPStan（静态分析）
• Laravel Installer（创建新 Laravel 项目）
• Robo（任务运行器）

3. 关键区别总结

作用范围不同：普通 require 针对当前项目；global require 影响整个用户环境。

Studio Global

Studio Global AI 是一个内容生成工具，帮助用户客制化生成风格和内容，以合理价格提供无限生成，希望将 AI 带给全世界所有人。

103

查看详情

安装路径不同：本地依赖装在项目内的 vendor 目录；全局依赖装在用户主目录的 Composer 全局目录。

可执行命令访问方式不同：全局安装后，其提供的 CLI 命令可以直接运行；本地安装的命令需通过 php vendor/bin/command 或 composer exec 调用。

版本管理粒度不同：全局只有一个版本；每个项目可独立使用不同版本的同一包。

4. 使用建议

优先使用 普通 require 来管理项目依赖，保证项目独立性和可移植性。

只将命令行工具类包用 global require 安装，并确保全局 bin 目录已加入系统 PATH。

可通过以下命令查看全局安装路径：

composer config –global home

检查是否能直接运行全局命令，如不行，记得配置环境变量。

基本上就这些。理解清楚两者的使用场景，能避免依赖混乱和命令无法执行的问题。

以上就是composer global require和require的区别_讲解global require与普通require的区别的详细内容，更多请关注php中文网其它相关文章！