
Linux上安装Composer不是“装软件”,而是放一个可执行文件到PATH里
Composer在Linux上没有传统安装包,它就是一个叫composer.phar的PHP归档文件。所谓“安装”,就是把它放到系统能自动找到的地方(比如/usr/local/bin),再加个执行权限——之后你敲composer --version能出结果,才算真正可用。
- 先确认PHP就绪:
php -v(需≥7.2,推荐8.0+),再检查扩展:php -m | grep -E "openssl|zlib|json|mbstring",缺哪个就装哪个(如CentOS:yum install php-opcache php-mbstring) - 下载并校验(防中间人攻击):
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1f824b77632032483a598d3172322237347d2635724679a03772e753') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"校验通过后再运行php composer-setup.php - 移动并设权:
sudo mv composer.phar /usr/local/bin/composer,然后sudo chmod +x /usr/local/bin/composer - 验证:
composer --version;若提示command not found,检查echo $PATH是否含/usr/local/bin(默认一般都有)
“Permission denied”八成是因为你或别人用过sudo,得把所有权还回来
报Permission denied时,别急着chmod -R 777,那只是掩盖问题。真正原因通常是某次误用了sudo composer install,导致vendor/、composer.lock或~/.composer/cache/被设为root属主,现在普通用户自然写不进去。
- 先定位问题目录:
ls -ld vendor/ composer.lock $(composer config --global cache-dir),看输出第一列是不是你的用户名(比如drwxr-xr-x 5 alex alex) - 修复项目内权限:
sudo chown -R $USER:$USER vendor/ composer.lock - 修复全局缓存:
sudo chown -R $USER:$USER $(composer config --global cache-dir) - 如果整个
~/.composer都变root了:sudo chown -R $USER:$USER ~/.composer
别用sudo跑Composer,这是所有权限问题的起点
几乎所有后续报错,源头都是某次sudo composer。它会让文件归属混乱,Git提交异常,CI构建失败,甚至让composer update反复卡在“Writing cache file”。Composer设计上就不该提权运行。
- 永远用普通用户执行:
composer install、composer require、composer global require - 如果
composer global require报权限错,说明~/.composer/vendor/bin不在$PATH,或该目录属主不对——优先查chown -R $USER:$USER ~/.composer,而不是加sudo - 部署脚本或Docker中,确保运行用户UID与宿主机一致,或挂载卷时显式指定
user:
想彻底避开权限坑?把Composer装进自己家目录
如果你没权限改/usr/local/bin,或者团队多人共用服务器怕冲突,最稳妥的方式是把composer放在$HOME/bin下,再加进PATH。这样全程不用sudo,也避免污染系统路径。
- 创建本地bin目录:
mkdir -p $HOME/bin - 重装到用户目录:
php composer-setup.php --install-dir=$HOME/bin --filename=composer - 加入PATH(Bash):
echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc && source ~/.bashrc;Zsh则写入~/.zshrc - 验证:
which composer应返回/home/xxx/bin/composer,composer --version正常输出
复杂点在于:一旦开始混用sudo和普通用户命令,权限状态就会像打结的耳机线——表面修好了,下次一拉又乱。所以从第一次composer create-project起,就别碰sudo。










