Ubuntu 上使用 Composer 的完整指南
一 安装与验证
- 准备环境（安装常用依赖）：
- sudo apt update
- sudo apt install -y curl php-cli php-curl php-mbstring php-zip unzip git
- 方式 A（推荐）系统包管理器安装：
- sudo apt install -y composer
- 验证：composer --version
- 方式 B 官方安装脚本全局安装（可获取最新版）：
- curl -sS https://getcomposer.org/installer -o composer-setup.php
- 校验安装脚本（将 HASH 替换为官网最新 SHA-384）：
- php -r “if (hash_file(‘sha384’, ‘composer-setup.php’) === ‘HASH’) { echo ‘Installer verified’; } else { echo ‘Installer corrupt’; unlink(‘composer-setup.php’); } echo PHP_EOL;”
- 全局安装到 PATH：
- sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
- 验证：composer -v
- 说明：Composer 2 要求 PHP ≥ 7.3；如需在系统存在多版本 PHP 时指定版本，可使用 php8.1、php8.2 等命令配合或直接用 /usr/bin/php8.2 运行安装脚本。
二 常用配置
- 全局配置目录：~/.composer/config.json（也可设置环境变量 COMPOSER_HOME 自定义位置）。
- 使用国内镜像（提升下载速度，任选其一）：
- 全局：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 或写入配置：
- {
“repositories”: {
“packagist”: { “type”: “composer”, “url”: “https://mirrors.aliyun.com/composer/” }
}
}
- 常用全局设置：
- composer config -g cache-dir /opt/composer/cache
- composer config -g data-dir /opt/composer/data
- 若使用系统包管理器安装，也可通过修改全局配置文件进行镜像与路径调整。
三 项目管理常用命令
- 创建新项目（示例：Laravel）：
- composer create-project --prefer-dist laravel/laravel my-project
- 初始化或添加依赖：
- 初始化交互：composer init
- 添加包：composer require vendor/package
- 安装与更新：
- 安装锁文件依赖：composer install
- 更新依赖：composer update
- 仅更新某个包：composer update vendor/package
- 移除包：composer remove vendor/package
- 自动加载：项目中引入 vendor/autoload.php 即可使用已安装依赖。
四 升级与卸载
- 升级 Composer：
- 系统包管理器安装：sudo apt update && sudo apt upgrade composer
- 官方脚本安装：composer self-update
- 卸载：
- 系统包管理器：sudo apt remove --purge composer
- 官方脚本安装：sudo rm -f /usr/local/bin/composer
- 清理缓存与配置（可选）：rm -rf ~/.composer
五 快速示例
- 创建目录并安装依赖：
- mkdir ~/brickMath && cd ~/brickMath
- composer require brick/math
- 运行示例脚本（brickmath.php）：
-
plus($n2) . "\n";
?>
- 执行：php brickmath.php
- 常用文件说明：
- composer.json：项目依赖与元数据
- composer.lock：锁定已安装包的具体版本
- vendor/：依赖包目录与自动加载文件