Ubuntu如何配置Composer环境

Ubuntu 配置 Composer 环境

一 准备环境

• 更新索引并安装依赖：sudo apt update && sudo apt install -y curl php-cli php-mbstring git unzip。这些组件分别用于下载安装器、运行 PHP、处理多字节字符串、拉取依赖包与解压归档。完成后可用 php -v 检查 CLI 是否可用。

二 安装 Composer

• 方式一 官方安装脚本（推荐，便于获取最新版本）
  1. 下载并校验安装脚本： curl -sS https://getcomposer.org/installer -o composer-setup.php php -r “if (hash_file(‘SHA384’, ‘composer-setup.php’) === ‘669656bab3166a7aff8a7506b8cb2d1c292f042046c5a994c43155c0be6190fa0355160742ab2e1c88d40d5be660b410’) { echo ‘Installer verified’; } else { echo ‘Installer corrupt’; unlink(‘composer-setup.php’); } echo PHP_EOL;”
  2. 全局安装到可执行路径：sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
  3. 验证：composer --version
• 方式二 系统包管理器安装（版本可能滞后）
  • 安装：sudo apt install -y composer
  • 验证：composer --version
• 安全提示：安装脚本校验使用的 SHA-384 值会随版本更新而变化，若校验失败请重新下载安装脚本并核对最新签名。

三 基本使用

• 初始化项目：composer init（交互式生成 composer.json）
• 添加依赖：composer require 包名[:版本]，如：composer require monolog/monolog
• 安装依赖：composer install（依据 composer.json 与 composer.lock）
• 更新依赖：composer update（升级到允许范围内的最新版本）
• 移除依赖：composer remove 包名
• 查看已安装包：composer show
• 自动加载：在入口文件引入 vendor/autoload.php，即可使用已安装依赖。

四 常用配置与优化

• 升级 Composer：composer self-update
• 全局配置：编辑 ~/.composer/config.json 设置仓库、缓存目录等；或在项目内使用 composer config 进行项目级配置
• 国内镜像（可选，提升下载速度）：composer config -g repo.packagist composer https://packagist.phpcomposer.com
• 最小可用环境建议：PHP 版本 ≥7.2，并启用常用扩展（如 php-mbstring 等）以避免常见依赖安装失败。

五 常见问题排查

• 命令未找到：确认 /usr/local/bin 在 $PATH，或使用 which composer 检查可执行文件路径
• 权限错误：避免使用 root 直接运行 Composer，必要时用普通用户并在需要时加 sudo
• SSL/证书问题：确保系统时间正确，必要时更新 CA 证书包
• 内存不足：在 php.ini 中适当调高 memory_limit，或使用 --prefer-dist 减少依赖编译开销