全局安装 Composer 工具需使用 composer global require 命令,并将全局 bin 目录添加到系统 PATH 中,否则会导致命令无法识别;默认路径为 ~/.composer/vendor/bin(Linux/macOS)或 %APPDATA%Composervendorbin(Windows),可通过 composer config -g bin-dir 修改;安装后如未生效,主因是 PATH 未正确配置。

使用 Composer 全局安装工具,意味着将 PHP 工具安装到系统的全局目录中,这样你可以在任意目录下直接运行这些命令行工具。常见的如 Laravel 安装器、PHP-CS-Fixer、PHPStan 等都可以通过全局方式安装。
Composer 默认会将全局包安装到用户目录下的 ~/.composer/vendor/bin(macOS/Linux)或 C:Users用户名AppDataRoamingComposervendorbin(Windows)。你可以通过以下命令查看当前全局路径:
composer config -g bin-dir
如果你想更改全局 bin 目录,例如指定为 ~/bin,可以运行:
composer config -g bin-dir /path/to/your/bin
使用 composer global require 命令来安装工具。语法如下:
composer global require 包名
例如,安装 Laravel 安装器:
composer global require laravel/installer
安装完成后,就可以在终端中运行:
laravel new my-project
再比如安装 PHP-CS-Fixer 代码格式化工具:
composer global require friendsofphp/php-cs-fixer
为了让系统识别你全局安装的命令,必须将 Composer 的全局 bin 目录添加到系统的环境变量 PATH 中。
- Linux/macOS:编辑 ~/.bashrc 或 ~/.zshrc,加入一行:
- 保存后运行 source ~/.bashrc(或对应 shell 配置文件)使更改生效。
- Windows:在“环境变量”设置中,将 %APPDATA%Composervendorbin 添加到 PATH 中。
export PATH="$HOME/.composer/vendor/bin:$PATH"
更新所有全局安装的包:
composer global update
只更新某个包:
composer global update 包名
卸载某个全局工具:
composer global remove 包名
基本上就这些。只要路径配置正确,全局工具就能像普通命令一样使用。不复杂但容易忽略的是 PATH 设置,这是很多初学者遇到“命令未找到”的主要原因。
以上就是Composer如何全局安装工具的详细内容,更多请关注php中文网其它相关文章!