若你仍在用 PHP 5.3 以下版本,請立即升級。現代 PHP 開發已形成成熟生態:**PSR 規範統一標準、Composer 管理依賴、php-cs-fixer 自動修正風格**。本文梳理這三大支柱,助你快速對齊主流框架 (Laravel、Symfony、Yii 等) 的開發慣例。
由 PHP-FIG (Framework Interop Group) 起草投票,成員包含主流框架作者。目的非強制規範,而是**框架間互操作的共識基礎**。
| 編號 | 主題 | 核心內容 | 狀態 |
|---|---|---|---|
| PSR-0 | 自動載入 (舊) | 類名對應目錄結構 (PEAR 風格),PHP 5.3 命名空間前 | 已棄用,併入 PSR-4 |
| PSR-1 | 基本編碼規範 | 檔案編碼 UTF-8 無 BOM、類名 StudlyCaps、方法 camelCase、常數大寫 | 推薦遵循 |
| PSR-2 | 編碼風格指南 | 縮排 4 空格、大括號換行、關鍵字空格、每行 ≤ 120 字元 | 推薦遵循 |
| PSR-3 | Logger 介面 | Psr\Log\LoggerInterface 統一日誌介面,框架/套件可互換 | 廣泛採用 |
| PSR-4 | 自動載入 (現行) | 命名空間前綴對應目錄,支援子命名空間,composer.json autoload.psr-4 | 標準 |
| PSR-7 | HTTP 訊息介面 | Request/Response/Uri/Stream/UploadedFile 介面,中介軟體互操作基石 | 標準 |
非單純套件安裝器 (如 Pear/Pecl),而是**定義專案依賴圖、解析版本衝突、產生自動載入對應表**的完整工具鏈。
composer.json 宣告式依賴:"require": {"monolog/monolog": "^2.0"}require 'vendor/autoload.php' 即享按需載入、延遲載入composer.lock 確保團隊/部署環境版本一致post-install-cmd、post-autoload-dump 自動化工作流composer init # 互動式建立 composer.json
composer require vendor/pkg # 新增依賴並更新 lock
composer install # 依 lock 安裝精確版本 (部署用)
composer update # 依 json 解析最新版本並更新 lock (開發用)
composer dump-autoload -o # 產生優化對應表 (Class Map)
composer show # 列出已安裝套件
composer outdated # 檢查可更新套件
依據 PSR-1/PSR-2 (或自訂規則) 自動修正排版、空白、命名、導入排序等問題,納入 CI/CD 流程即可強制風格一致。
# 全域安裝 (專案建議用 local)
composer global require friendsofphp/php-cs-fixer
# 或專案安裝
composer require --dev friendsofphp/php-cs-fixer
# 檢查 (不修改)
php vendor/bin/php-cs-fixer fix --dry-run --diff
# 自動修正
php vendor/bin/php-cs-fixer fix
# 指定規則集
php vendor/bin/php-cs-fixer fix --rules=@PSR2
php vendor/bin/php-cs-fixer fix --rules='{"php_tag":true,"strict_param":true}'
php vendor/bin/php-cs-fixer fix --diff 阻止風格不合規程式碼提交php vendor/bin/php-cs-fixer fix --dry-run --diff 失敗即阻擋合併composer.json、composer.lock、vendor/ 加入 .gitignoresrc/ 對應 App\\ 命名空間
4. 加入 php-cs-fixer 至 CI,規則集從 @PSR2 起步
5. 採用 PSR-3 Logger 介面,統一日誌輸出
6. 依專案需求逐步採用 PSR-7 (HTTP)、PSR-11 (Container)、PSR-14 (Event) 等介面
PSR 定標準、Composer 管依賴、php-cs-fixer 管風格——三者構成現代 PHP 專案的「鐵三角」。不用盲目追新,但**理解並選擇性採用**這些共識,能讓你的專案更易維護、團隊協作更順暢、生態整合更無縫。從今天開始,composer require 取代 include_once,讓程式碼說話更標準。