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/:依赖包目录与自动加载文件