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%appDataRoamingComposervendorbin(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,而是修复目录权限:
立即学习“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 配置,配好一次,后续所有全局工具都能直接用。