萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

現代 PHP 開發必知:PSR 規範、Composer 依賴管理、php-cs-fixer 程式碼風格自動修正

若你仍在用 PHP 5.3 以下版本,請立即升級。現代 PHP 開發已形成成熟生態:**PSR 規範統一標準、Composer 管理依賴、php-cs-fixer 自動修正風格**。本文梳理這三大支柱,助你快速對齊主流框架 (Laravel、Symfony、Yii 等) 的開發慣例。

1. PSR:PHP 標準建議 (PHP Standard Recommendation)

由 PHP-FIG (Framework Interop Group) 起草投票,成員包含主流框架作者。目的非強制規範,而是**框架間互操作的共識基礎**。

已通過的核心 PSR

編號主題核心內容狀態
PSR-0自動載入 (舊)類名對應目錄結構 (PEAR 風格),PHP 5.3 命名空間前已棄用,併入 PSR-4
PSR-1基本編碼規範檔案編碼 UTF-8 無 BOM、類名 StudlyCaps、方法 camelCase、常數大寫推薦遵循
PSR-2編碼風格指南縮排 4 空格、大括號換行、關鍵字空格、每行 ≤ 120 字元推薦遵循
PSR-3Logger 介面Psr\Log\LoggerInterface 統一日誌介面,框架/套件可互換廣泛採用
PSR-4自動載入 (現行)命名空間前綴對應目錄,支援子命名空間,composer.json autoload.psr-4標準
PSR-7HTTP 訊息介面Request/Response/Uri/Stream/UploadedFile 介面,中介軟體互操作基石標準

草案中 (Draft)

  • PSR-5:PHPDoc 標準
  • PSR-6:Cache 介面
  • PSR-14:Event Dispatcher
  • PSR-15:HTTP Middleware
  • PSR-16:Simple Cache
  • PSR-17:HTTP Factories
  • PSR-18:HTTP Client

2. Composer:現代 PHP 依賴管理神器

非單純套件安裝器 (如 Pear/Pecl),而是**定義專案依賴圖、解析版本衝突、產生自動載入對應表**的完整工具鏈。

核心優勢

  • packagist.org 中心化套件庫,數萬套件一鍵引入
  • composer.json 宣告式依賴:"require": {"monolog/monolog": "^2.0"}
  • 自動載入優化:實作 PSR-4,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             # 檢查可更新套件

3. php-cs-fixer:一鍵修正程式碼風格

依據 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}'

整合到 IDE / Git Hooks

  • PHPStorm/VsCode 安裝 PHP CS Fixer 擴充,存檔自動修正
  • pre-commit hook:php vendor/bin/php-cs-fixer fix --diff 阻止風格不合規程式碼提交
  • CI 階段:php vendor/bin/php-cs-fixer fix --dry-run --diff 失敗即阻擋合併

實務建議:漸進式對齊

  1. 專案引入 composer.json、composer.lock、vendor/ 加入 .gitignore
  2. 2. 依賴套件全面改用 Composer 管理,移除手動 include/require 3. 遵循 PSR-4 重組目錄結構:src/ 對應 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,讓程式碼說話更標準。

copyright © 萬盛學電腦網 all rights reserved