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環境變量,方可直接運行。