Ubuntu Composer如何进行全局安装

Ubuntu 上 Composer 全局安装指南

方法一 官方安装脚本 推荐

• 更新索引并安装依赖：sudo apt update && sudo apt install -y php-cli php-mbstring git unzip curl
• 下载并验证安装脚本（SHA-384）：
  • curl -sS https://getcomposer.org/installer -o /tmp/composer-setup.php
  • HASH=$(curl -sS https://composer.github.io/installer.sig)
  • php -r “if (hash_file(‘SHA384’, ‘/tmp/composer-setup.php’) === ‘$HASH’) { echo ‘Installer verified’; } else { echo ‘Installer corrupt’; unlink(‘/tmp/composer-setup.php’); } echo PHP_EOL;”
• 全局安装到可执行路径：sudo php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer
• 验证：composer --version（应输出版本号，如 Composer 2.x）

方法二 使用系统包管理器安装

• 一条命令安装：sudo apt install -y composer
• 验证：composer --version
• 说明：部分系统仓库版本可能较旧；如需最新特性，优先使用官方脚本安装。

全局 Composer 插件与 PATH 配置

• 全局安装可执行工具（如 Laravel 安装器）：composer global require laravel/installer
• 将全局 bin 目录加入 PATH（写入 shell 配置文件，如 ~/.bashrc 或 ~/.zshrc）：export PATH=“$HOME/.composer/vendor/bin:$PATH”
• 使配置生效：source ~/.bashrc 或 source ~/.zshrc
• 验证：laravel --version。

常用维护与故障排查

• 更新 Composer：composer self-update（或 composer self-update --2 指定主版本）
• 权限问题：涉及系统目录时使用 sudo；避免使用 sudo 执行普通项目命令
• 网络加速（可选，中国大陆）：composer config -g repo.packagist composer https://packagist.phpcomposer.com
• 安装依赖时报错缺少 mbstring 等扩展：sudo apt install -y php-mbstring 后重试。