Composer全局安装PHP工具需先将~/.composer/vendor/bin(Linux/macOS)或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin(Windows)加入PATH,再执行composer global require vendor/package-name,如laravel/installer;安装后可直接调用命令,维护可用composer global update/remove。

使用 composer global require 可以把 PHP 工具包安装到 Composer 的全局目录,让命令行在任何路径下都能直接调用。前提是已正确配置 Composer 的全局 bin 目录到系统 PATH 环境变量中。
确认全局 bin 目录已加入 PATH
Composer 全局安装的可执行文件默认放在 ~/.composer/vendor/bin(Linux/macOS)或 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin(Windows)。必须确保这个路径已添加进系统 PATH,否则终端无法识别命令。
- Linux/macOS:检查
echo $PATH是否包含~/.composer/vendor/bin;若没有,将export PATH="$HOME/.composer/vendor/bin:$PATH"加入~/.bashrc或~/.zshrc,然后运行source ~/.zshrc - Windows:在「系统属性 → 高级 → 环境变量」中,编辑用户变量
Path,新增对应路径 - 验证是否生效:运行
which xxx(macOS/Linux)或where xxx(Windows),或直接输入一个已装工具名(如laravel)看是否提示 command not found
执行全局安装命令
语法很简单:
composer global require vendor/package-name
- 例如安装 Laravel 安装器:
composer global require laravel/installer - 安装 PHP CS Fixer:
composer global require friendsofphp/php-cs-fixer - 安装 Deployer:
composer global require deployer/deployer - 安装后,直接在终端输入对应命令(如
laravel new myapp)即可使用
常见问题与处理
安装失败或命令不可用,多数源于环境配置或权限问题:
- “command not found”:90% 是因为 bin 目录没进 PATH,按上一步检查并重载 shell
-
权限错误(如 “Permission denied”):避免用
sudo composer global require;应确保~/.composer所属用户正确(chown -R $USER ~/.composer) -
版本冲突或安装失败:先运行
composer global update清理旧依赖;也可加--no-interaction减少交互干扰 -
想查看已全局安装的包:运行
composer global list或composer global show
升级和卸载全局包
全局包不是一劳永逸的,需定期维护:
- 升级所有全局包:
composer global update - 只升级某个包:
composer global update vendor/package-name - 卸载包:
composer global remove vendor/package-name - 注意:卸载不会自动清理 PATH,但删的是可执行文件本身,命令自然失效
基本上就这些。不复杂但容易忽略 PATH 配置,只要这一步到位,后续安装、使用都很顺。










