1. 程式人生 > >PHP工程規範——PSR-1

PHP工程規範——PSR-1

統一的程式碼規範,有助於培養良好的編碼習慣,團隊成員間的程式碼交流更加簡單。而對於PHP來說,PSR無疑是目前最好的選擇。

PSR,即PHP Standard Recommendations,是目前最流行的PHP相關規範集合。

截止目前,PSR官方給出了19中規範,在閱讀規範時需要注意規範的狀態。現有的狀態分為:

  • Deprecated
    不在推薦了,因為在後續版本中可能被廢棄。
  • Accepted
    被PSR組織接受,並且正在使用的規範,這部分正式我們應該花時間去學習的規範。
  • Abandoned
    很明顯,這部分規範已經被廢棄。
  • Review
    我的理解是這部分的規範正在被評審。
  • Draft
    很明顯,這部分規範正處於起草階段。

那麼從這篇文章起,就會逐一簡述每個規範的主要內容,以便在工作中儘快的上手這些規範,融入PHP大的標準之中。

PSR-1

這是最基礎的一部分編碼規範,它的主要內容簡述為:
1. 檔案編碼統一使用無BOM的UTF-8;
2. 檔案以<?php 或者<? 開頭;
3. 必須使用一種自動載入策略(PSR-0或者PSR-4);
4. 一個檔案中應該包含宣告行程式碼或者具有邊際效應的程式碼;
5. 類名應採用首字母大寫的方式,例如StudlyCaps;
6. 類的常量應該全部大寫,並且以_分隔;
7. 類的變數原則上不做要求,但是在一定範圍(例如專案/包)內應該保持一致;
8. 方法名應該使用駝峰法命名;