Composer怎么在Linux安装 Composer怎么设置运行权限【运维】

1次阅读

Composer怎么在Linux安装 Composer怎么设置运行权限【运维】

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",缺哪个就装哪个(如centosyum 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 installcomposer requirecomposer 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/composercomposer --version正常输出

复杂点在于:一旦开始混用sudo和普通用户命令,权限状态就会像打结的耳机线——表面修好了,下次一拉又乱。所以从第一次composer create-project起,就别碰sudo

text=ZqhQzanResources