1. 安装Composer
在Debian系统上使用Composer前,需先安装其运行环境(PHP)及Composer本身。
sudo apt update
sudo apt install php-cli php-json php-common php-mbstring php-xml php-zip unzip
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version
2. 创建项目目录
在目标位置(如用户主目录)创建新项目文件夹,并进入该目录:
mkdir my_project
cd my_project
3. 初始化Composer项目
通过composer init
命令交互式生成composer.json
文件(项目依赖配置文件),按提示输入项目名称、描述、作者等信息,或直接按回车键使用默认值:
composer init
执行后,项目根目录会生成composer.json
文件,记录项目基本信息和依赖列表。
4. 安装项目依赖
composer require
命令添加项目所需依赖(如monolog/monolog
日志库),Composer会自动下载依赖包及其关联文件,并更新composer.json
(记录依赖版本)和composer.lock
(锁定具体版本,确保环境一致性):composer require monolog/monolog
composer.json
添加依赖:手动编辑composer.json
文件的require
字段,添加依赖项后运行composer install
命令安装:{
"require": {
"monolog/monolog": "^2.0"
}
}
composer install
5. 使用自动加载功能
Composer会自动生成vendor/autoload.php
文件,用于自动加载项目及依赖的类。在PHP代码中引入该文件,即可直接使用依赖库的类(无需手动require
每个文件):
// 示例:使用Monolog库记录日志
require __DIR__ . '/vendor/autoload.php';
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
$log = new Logger('app');
$log->pushHandler(new StreamHandler(__DIR__ . '/logs/app.log', Logger::INFO));
$log->info('项目启动成功!');
6. 管理项目依赖
composer update
命令,检查composer.json
中的依赖版本约束,更新所有依赖至最新兼容版本,并重新生成composer.lock
:composer update
composer prune
命令清理vendor
目录中未使用的包,保持项目整洁:composer prune
注意事项
composer.json
和composer.lock
文件纳入版本控制(如Git),避免不同环境安装不同版本的依赖。~/.config/composer/vendor/bin
)至系统PATH
环境变量,方可直接运行。