如何快速配置Ubuntu Composer环境，轻松管理PHP项目？
- 内容介绍
- 文章标签
- 相关推荐
为什么你需要快速配置 Composer 环境？其实，
在 Ubuntu 上开发 PHP 项目时常见的痛点包括：
- 手动到 GitHub 下载依赖包。速度慢且易错，
- 版本不兼容导致项目无法运行；
- 每次新建项目都要重复设置环境，浪费时间；
- 缓存目录默认位置可能占用程序盘空间，影响后续操作。
Composer 能够解决这些问题。只需一次性配置好环境，后续依赖安装、更新、锁定都变得“一键完成”。
一、准备基础环境
Composer 依赖 PHP CLI 和一些常用 先把它们装好可以避免后面报错。
sudo apt update
sudo apt install -y php-cli php-json php-xml php-zip php-mbstring php-curl
检查 PHP 版本是否符合要求：
php -v
二、官方脚本安装 Composer
Ubuntu 自带的 composer 包往往版本老旧，直接使用官方安装脚本能得到最新的 phar 包。
# 下载安装脚本
php -r "copy;"
# 验证脚本哈希
php -r "if === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'Installer verified';} else { echo 'Installer corrupt';unlink，} echo PHP_EOL;"
# 运行安装脚本
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
# 清理临时文件
rm composer-setup.php
再看验证安装成功。
composer --version
三、创建项目并编写 composer.json
进入你的项目根目录，初始化 composer.json。
mkdir -p ~/my-php-project && cd $_
composer init # 按提示填写名称、描述、作者等信息；也可直接使用下面的模板
手动创建 composer.json 模板：
四、常用 Composer 操作命令速查表
| 命令 | 作用 |
|---|---|
composer install | |
composer update | |
composer require vendor/package ^version | |
如果你发现从 packagist.org 下载依赖非常缓慢，可切换到阿里云完整镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
全局生效后所有项目都会走该镜像；若只想对单个项目生效，去掉 `-g` 参数即可。
为什么你需要快速配置 Composer 环境？其实，
在 Ubuntu 上开发 PHP 项目时常见的痛点包括：
- 手动到 GitHub 下载依赖包。速度慢且易错，
- 版本不兼容导致项目无法运行；
- 每次新建项目都要重复设置环境，浪费时间；
- 缓存目录默认位置可能占用程序盘空间，影响后续操作。
Composer 能够解决这些问题。只需一次性配置好环境，后续依赖安装、更新、锁定都变得“一键完成”。
一、准备基础环境
Composer 依赖 PHP CLI 和一些常用 先把它们装好可以避免后面报错。
sudo apt update
sudo apt install -y php-cli php-json php-xml php-zip php-mbstring php-curl
检查 PHP 版本是否符合要求：
php -v
二、官方脚本安装 Composer
Ubuntu 自带的 composer 包往往版本老旧，直接使用官方安装脚本能得到最新的 phar 包。
# 下载安装脚本
php -r "copy;"
# 验证脚本哈希
php -r "if === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'Installer verified';} else { echo 'Installer corrupt';unlink，} echo PHP_EOL;"
# 运行安装脚本
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
# 清理临时文件
rm composer-setup.php
再看验证安装成功。
composer --version
三、创建项目并编写 composer.json
进入你的项目根目录，初始化 composer.json。
mkdir -p ~/my-php-project && cd $_
composer init # 按提示填写名称、描述、作者等信息；也可直接使用下面的模板
手动创建 composer.json 模板：
四、常用 Composer 操作命令速查表
| 命令 | 作用 |
|---|---|
composer install | |
composer update | |
composer require vendor/package ^version | |
如果你发现从 packagist.org 下载依赖非常缓慢，可切换到阿里云完整镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
全局生效后所有项目都会走该镜像；若只想对单个项目生效，去掉 `-g` 参数即可。