使用 composer 的 global require 可将 php 工具安装到全局环境，需将 ~/.composer/vendor/bin（linux/macOS）或 %appDATA%Composervendorbin（windows）加入 PATH 以直接调用命令。

使用 Composer 的 global require 命令可以将 PHP 工具安装到系统的全局环境中，这样你就可以在任意目录下通过命令行直接运行这些工具。比如常用的 laravel 安装器、PHP-CS-Fixer、PHPStan 等都是通过这种方式安装的。

1. 理解 global require 的作用

Composer 默认安装包是针对当前项目的（本地安装），而加上 global 关键字后，包会被安装到 Composer 的全局目录中，通常位于：

• Linux/macOS: ~/.composer/vendor/bin
• windows: C:Users用户名AppDataRoamingComposervendorbin

要让这些工具在终端中直接可用，必须确保该目录已添加到系统的 PATH 环境变量中。

2. 安装全局 PHP 工具的步骤

以安装 Laravel 安装器为例，演示完整流程：

立即学习“PHP免费学习笔记（深入）”；

1. 打开终端或命令行工具
2. 执行以下命令：

composer global require laravel/installer

安装完成后，Laravel 安装器就放在了全局 vendor 目录中。你可以通过下面命令创建新项目：

laravel new my-project

如果提示“命令未找到”，说明 ~/.composer/vendor/bin 没有加入 PATH。

3. 配置环境变量 PATH（关键步骤）

为了让系统识别全局安装的命令，需要将 Composer 的全局 bin 目录加入 PATH。

Linux/macos 用户：

编辑 shell 配置文件（如 ~/.bashrc、~/.zshrc 或 ~/.profile），添加一行：

黑点工具

在线工具导航网站，免费使用无需注册，快速使用无门槛。

18

查看详情

export PATH="$HOME/.composer/vendor/bin:$PATH"

保存后执行：

source ~/.zshrc

（根据你使用的 shell 替换对应配置文件）

Windows 用户：

进入“系统属性 → 高级 → 环境变量”，在用户或系统变量的 PATH 中添加：

%APPDATA%Composervendorbin

然后重启命令行即可生效。

4. 常见全局工具示例

你可以用相同方式安装其他常用工具：

composer global require phpunit/phpunit

composer global require phpstan/phpstan

composer global require friendsofphp/php-cs-fixer

安装后，直接运行 phpunit、phpstan、php-cs-fixer 即可使用。

基本上就这些。只要 PATH 设置正确，global require 就能让你像使用系统命令一样调用 PHP 工具。不复杂但容易忽略的是环境变量配置这一步。

以上就是如何使用