如何使用composer global命令安装全局工具？（例如PHPUnit）

Composer全局安装工具需配置PATH：Linux/macOS将~/.composer/vendor/bin加入shell配置文件，Windows在环境变量中添加对应路径；安装命令为composer global require，验证用phpunit --version等。

直接用 composer global require 就能安装全局工具，但要注意 PHP 可执行文件路径和 Composer 全局 vendor 目录的配置，否则命令可能无法直接运行。

确保 Composer 全局 bin 目录已加入系统 PATH

Composer 会把全局安装的可执行文件（如 phpunit）放在 ~/.composer/vendor/bin（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows）。这个目录必须在系统环境变量 PATH 中，终端才能识别命令。

• Linux/macOS：在 ~/.bashrc 或 ~/.zshrc 末尾添加：
  export PATH="$HOME/.composer/vendor/bin:$PATH"，然后运行 source ~/.zshrc（或对应 shell 配置文件）
• Windows：在「系统属性 → 高级 → 环境变量」中，将该 bin 路径添加到用户或系统 PATH
• 验证是否生效：终端运行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），确认路径存在；再运行 which phpunit 或 where phpunit 查看是否可定位

使用 composer global require 安装工具

安装前建议先更新 Composer 自身：composer self-update。然后执行：

• 安装 PHPUnit：composer global require phpunit/phpunit
• 安装其他常用工具：
  • Laravel Valet：composer global require laravel/valet
  • Deployer：composer global require deployer/deployer
  • PHP CS Fixer：composer global require friendsofphp/php-cs-fixer
• 安装指定版本（推荐）：composer global require phpunit/phpunit:^9.6

注意权限与冲突问题

全局安装本质是写入用户目录下的 .composer，一般无需 sudo。若遇到权限错误，不要用 sudo composer global，而是修复目录权限：

文心智能体平台

百度推出的基于文心大模型的Agent智能体平台，已上架2000+AI智能体

393

查看详情

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

• Linux/macOS：运行 sudo chown -R $USER ~/.composer
• 避免多个全局版本冲突：Composer 不支持同一包多版本共存。卸载用 composer global remove phpunit/phpunit
• 如果项目里也用了 PHPUnit，优先以项目本地的为准（通过 ./vendor/bin/phpunit 调用），全局只是方便快速启动

验证安装是否成功

安装完成后，在任意目录运行工具命令即可测试：

• phpunit --version —— 应输出版本号
• php-cs-fixer --version —— 同理
• 如果提示“command not found”，说明 PATH 没生效，回到第一步检查

基本上就这些。不复杂但容易忽略 PATH 配置，配好一次，后续所有全局工具都能直接用。

以上就是如何使用composer global命令安装全局工具？（例如PHPUnit）的详细内容，更多请关注php中文网其它相关文章！