PHP编码规范(中文版)导读
本文档是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互操作性框架制定小组
组建本小组的目的是,通过在各项目的代表之间讨论他们共同的编码规范,以制定一个协作标准。本规范的主要面向对象是本小组的各个组成成员,当然,同时也欢迎关注本规范的其它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
Pádraic 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 Zülke: Agavi