PHP PSR 标准规范
PSR 是 PHP Standard Recommendations 的简写,由 PHP FIG 组织制定的 PHP 规范,是 PHP 开发的实践标准
PHP FIG 是 PHP Framework Interoperability Group ( 框架可互用性小组 ) 的缩写
PST 项目的目的在于:通过框架作者或者框架的代表之间讨论,以最低程度的限制,制定一个协作标准,各个框架遵循统一的编码规范,避免各家自行发展的风格阻碍了 PHP 的发展,解决这个程序设计师由来已久的困扰
谁适合阅读本规范
- 如果你已经非常熟悉 PHP ,想进一步提升 PHP 理解能力,那么你适合阅读本规范
- 如果你对自己的代码风格感到一丝丝担忧,那么你也适合阅读本规范
- 如果你是团队管理者,想要指定一套 PHP 编码规范,那么你也适合阅读本规范
如果你是 PHP 初学者,那么,我们建议,你可以过一段时间再读
作者推荐语
虽然,这有点浮亏,但,也确实是这样
PSR 的存在让 PHP 社区更具活力和凝聚力,之前的 PHP 社区都是只管语言本身是什么样的,不管 PHP 是如何使用的,因此也诞生了很多很轰动全球的框架和系统,比如 Zend 和 CI 还有 Wordpress。
毫无夸张的说,所有目前最新诞生的的新框架新类库都在朝着兼容 PSR 的方向努力靠近,不是说 PSR 规范有多牛逼,而是目前的各种语言的框架本身都在朝着这个方向前进,一如 Nodejs 中的 express 和 koa
相比于我们的实际情况,大多数的 PHP 开发人员都已经失去了看英文文档的意愿,尤其是 PSR 这种专业的规范的文档,语言生涩难懂,使用 Google 翻译都不一定能彻底读懂,哪怕是把每个单词都拆开来翻译,也不一定就懂它们的意思
所以,其实我的英文能力也有限,尤其是翻译的时候并不是一片一片的按照顺序的从头到尾的翻译,而是一段一段的跳跃性的翻译,有时候会发现之前的某个词翻译的太生硬,但,还是懒得回去更改。因为,那样太费时间。
从另一个方面说,也是我的私心
- 首先,这份 PSR 我不会出版,无论是任何时间点
- 其次,我更注重我读和翻译此文档的心得和体会,也就是说,对某段的翻译,是发自内心的去理解它的意思,如果理解的不透彻就开始更改,那我还不如等理解差不多了再改,反正,已经有一个版本了
- 可能,此文档一经发布就被 mirror 了,但我无所谓,我只有一个要求,就是版权互换法则,也就是说,如果任何网站 mirror 了此内容中的全部或者部分,那么等同于我也可以任意拷贝你网站的内容。既然 mirror 无法避免,那我么我就放开 mirror
版权
此文档大家可以随意 mirror。 我只有三个要求:
-
未经允许,不得已自己的名义联系出版社出版此书籍,很简单,我不是要那几个钱,而是怕出版的书籍因为文字固定不得更改,而误导了好多初学者。
我本来想消除纸质出版这个东西,结果你还出版了...存心气死我...
-
mirror 的过程,相当于同意专利和版权互换,也就是说,你可以 mirror 我的,我也可以 mirror 你的而不会有任何法律纠纷
-
任何出版的书籍,可以引用此文中的一段或者整个篇幅,甚至可以不用注明出处,因为,我懒得去看,你也可能不会注明。
如果整篇,我只有一个要求,就是必须有明确的示例,因为,这是这份翻译中缺少的,也是我翻译这篇文章时最大的内疚