PHP的PSR系列規範都有啥內容

PSR

是PHP Standard Recommendation的簡寫，它其實應該叫PSRs，即系列推薦標準：目前通過的規範有PSR-0(Autoloading Standard)、PSR-1(Basic Coding Standard)、PSR-2(Coding Style Guide)、PSR-3(Logger Interface)、PSR-4(Improved Autoloading)。它不是PHP官方標準，而是從如Zend、Symfony2等知名PHP項目中提煉出來的一系列標準，目前有越來有多的社區項目加入成員並遵循該標準。

PHP-FIG — PHP Framework Interoperability Group， 是制定PSRs開發規範的組織，它的成員由很多知名PHP社區項目組成，在其官網首頁下方可以看到成員清單。這些成員制定規範，並且落實在自己的項目中。

其實各個PSR規範的內容都很簡潔明了，比起那些動則幾十頁的規範，真是好太多了。

PSR-0(Autoloading Standard)

PSR-0即類自動載入規範（原文：官網、GitHub）。從2014-10-21日起，該規範被標記為Deprecated，由PSR-4替代。它的內容十分簡潔。

內容：

1. 一個完全合格的命名空間和類名必須有以下的結構“\<Vendor Name>\(<Namespace>\)*<Class Name>”
2. 每個命名空間必須有頂級的命名空間（“Vendor Name”）
3. 每個命名空間可以有任意多個子命名空間
4. 每個命名空間在被從檔案系統載入時必須被轉換為“作業系統路徑分隔字元”（DIRECTORY_SEPARATOR ）
5. 每個“_”字元在“類名”中被轉換為DIRECTORY_SEPARATOR 。“_”符號在命名空間中沒有明確含義
6. 符合命名標準的命名空間和類名必須以“.php”結尾來負載檔案
7. Vendor Name，命名空間，類名可以由大小寫字母組成，其中命名空間和類名是大小寫敏感的以保證多系統相容性

PSR-1(Basic Coding Standard)

PSR-1即基礎編碼通訊協定（原文：官網、GitHub）。內容也是否簡潔，包含了類檔案、類名、類方法名的命名方法。

內容：

1. 源檔案必須只使用

2. 源檔案中php代碼的編碼格式必須只使用不帶BOM的UTF-8

3. 一個源檔案建議只用來做聲明（類，函數，常量等）或者只用來做一些引起副作用的操作（例如：輸出資訊，修改.ini設定檔等）,但不應該同時做這兩件事

4. 命名空間和類必須遵守PSR-0標準

5. 類名必須使用StudlyCaps寫法

6. 類中的常量必須只由大寫字母和底線(_)組成

7. 方法名必須使用cameCase寫法

PSR-2(Coding Style Guide)

PSR-2即編碼風格標準（原文：官網、GitHub）。內容就稍多，但還是比較簡潔，它以PSR-1為基礎，包含了縮排、每行代碼長度、換行、方法可見度聲明、空格和方法體大括弧換行的相關規定。

標準內容：

1. 代碼必須遵守 PSR-1

2. 代碼必須使用4個空格來進行縮排，而不是用定位字元

3. 一行代碼的長度不應有硬限制；軟式節流必須為120個字元，建議每行代碼80個字元或者更少

4. 在命名空間的聲明下面必須有一行空行，並且在use的聲明下面也必須有一行空行

5. 類的左花括弧必須放到其聲明下面自成一行，右花括弧則必須放到類主體下面自成一行

6. 方法的左花括弧必須放到其聲明下面自成一行，右花括弧則必須放到方法主體的下一行

7. 所有的屬性和方法必須有可見度聲明；abstract和final聲明必須在可見度聲明之前；而static聲明必須在可見度聲明之後

8. 在結構控制關鍵字的後面必須有一個空格；而方法和函數調用時後面不可有空格

9. 結構控制的左花括弧必須跟其放在同一行，右花括弧必須放在該結構控制碼主體的下一行

10. 控制結構的左括弧之後不可有空格，右括弧之前也不可有空格

PSR-3(Logger Interface)

PSR-3是對應用日誌類的通過介面的定義（原文：官網、GitHub）。內容很簡單，就是一個介面，官方範例程式碼引用一下就好了。當然，在具體的應用中，只要遵循該介面，肯定可以定製相應的實現。

基礎內容：

1. LoggerInterface暴露八個介面用來記錄八個等級(debug, info, notice, warning, error, critical, alert, emergency)的日誌。

2. 第 九個方法是log，接受日誌等級作為第一個參數。用一個日誌等級常量來調用這個方法必須和直接調用指定等級方法的結果一致。用一個本規範中未定義且不為具 體實現所知的日誌等級來調用該方法必須拋出一個Psr\Log\InvalidArgumentException。不推薦使用自訂的日誌等級，除非你 非常確定當前類庫對其有所支援。

PSR-4(Improved Autoloading)

PSR-4即改進版的自動載入規範（原文：官網、GitHub）。它是PSR-0規範的接替者。它可以與任何其它的自動載入規範相容，包括PSR-0。

內容：

1. 術語「類」是一個泛稱；它包含類，介面，traits 以及其他類似的結構；
2. 完全限定類名應該類似如下範例：()*

   1. 完全限定類名必須有一個頂級命名空間（Vendor Name）

   2. 完全限定類名可以有多個子命名空間

   3. 完全限定類名應該有一個終止類名

   4. 底線在完全限定類名中是沒有特殊含義的

   5. 字母在完全限定類名中可以是任何大小寫組合

   6. 所有類名必須以大小寫敏感的方式引用

3. 當從完全限定類名載入檔案時：

   1. 在完全限定類名中，連續的一個或幾個子命名空間構成的命名空間首碼（不包括頂級命名空間的分隔字元），至少對應著至少一個基礎目錄

   2. 在「命名空間首碼」後的連續子命名空間名稱對應一個「基礎目錄」下的子目錄，其中的命名 空間分隔字元表示目錄分隔字元。子目錄名稱必須和子命名空間名大小寫匹配

   3. 終止類名對應一個以 .php 結尾的檔案。檔案名稱必須和終止類名大小寫匹配

4. 自動載入器的實現不可拋出任何異常，不可引發任何等級的錯誤；也不應傳回值

註：具體規範內容參考了其他中文翻譯版本整理。

以上就介紹了PHP的PSR系列規範都有啥內容，包括了方面的內容，希望對PHP教程有興趣的朋友有所協助。

