本文件是PHP通用性框架小組(PHP-FIG :PHP Framework Interoperability Group)制定的PHP程式碼書寫規範(PSR:Proposing a Standards Recommendation)中譯版。
翻譯過程中參照了 莫希爾(Mosil)手札 的繁體中文版,以及 Corrie Zhao 組織翻譯的簡體中文版, 譯文中為了讓語句通順,便於理解,沒有對原文逐字翻譯,個別語句與原文原意可能略有偏差,希望告知指正。
- 2014/04/25 增加
PSR-2補充
檔案以及修改之前版本中的翻譯不當與錯誤。 - 2014/07/31 增加
PSR-4
。
以下是原版的導讀指南:
組建本小組的目的是,通過在各項目的代表之間討論他們共同的編碼規範,以制定一個協作標準。本規範的主要面向對象是本小組的各個組成成員,當然,同時也歡迎追蹤本規範的其它PHP社區採用本規範。
可以通過以下方式給本規範送出建議:
-
fork PSR代碼庫,建立並檢出一個分支,在
proposed/
下增加 規範建議,然後 push 分支到 Github,最後給我們發送一個 pull request;又或者 -
在 Github 下新建一個討論 ticket;又或者
-
在 信件列表 中送出建議。
注意,你 不需要 成為投票成員才能在 信件列表 中發表**。
想要成為投票成員,你必須發送一封信件到 信件列表 中。
-
信件主題格式如下:
Membership Request: {你的名字} ({參與的項目名稱})
-
信件內容應包括你的名字、你參與的項目名稱、項目的地址以及其它相關內容。
目前的成員會對你的加入請求進行投票。
請不要在一份申請中送出多個加入請求,每份申請只能送出一份請求。
-
Nate Abele: Lithium
-
Nils Adermann: phpBB
-
Brett Bieber: PEAR, PEAR2
-
Guilherme Blanco: Doctrine, Doctrine2, et al.
-
Jordi Boggiano: Composer, Packagist
-
Padraic Brady: Zend Framework
-
Karma Dordrak: Zikula
-
Paul Dragoonis: PPI, PPI2
-
William Durand: Propel, Propel 2
-
Don Gilbert: Joomla
-
Cal Evans: the community at large
-
Larry Garfield: Drupal
-
Ivan Habunek: Apache log4php
-
Paul M. Jones: Solar Framework, Aura Project
-
Karsten Dambekalns: TYPO3 Flow, TYPO3 Neos
-
Larry Masters: CakePHP, CakePHP 2
-
John Mertic: SugarCRM
-
Taylor Otwell: Laravel
-
Ryan Parman: Amazon Web Services SDK
-
Evert Pot: SabreDAV
-
Fabien Potencier: Symfony, Symfony2
-
Mike van Riel: phpDocumentor
-
Andre Romcke: eZ Publish
-
Phil Sturgeon: PyroCMS
-
Lukas Smith: Jackalope
-
Kris Wallsmith: Assetic, Buzz
-
David Zulke: Agavi