PSR PHP业界规范

http://psr.phphub.org/

https://blog.csdn.net/u013933858/article/details/79780179

0x0 大型项目的问题

随着项目越来越大，参与的人数越来越多，代码变得越来越不可维护了。
每个人都给项目带来自己的风格，所以这时就需要大家采用一个统一的标准。

0x1 解决办法

于是顶尖的PHPer们讨论确定了PHP的一些常用规范，并成立了FIG组织。

目标在于制定一个协作标准，各个框架遵循统一的编码规范，避免各家自行发展的风格阻碍了 PHP 的发展，解决这个程序设计师由来已久的困扰。

这些标准包括代码层面的如代码格式，代码风格；代码加载；还有各种实用的
接口。已经通过的规范有：

PSR1 基础编码规范
PSR2 编码风格规范
PSR3 日志接口规范
PSR4 自动加载规范
PSR6 缓存接口规范
PSR7 HTTP 消息接口规范
（注：PSR 指PHP Standard Recommendations PHP推荐标准，FIG指 Framework Interoperability Group 框架可互用性小组）

0X3 好处

虽然FIG是民间组织，然而由于众多的框架作者都参与其中，而且官方也有人参加，PSR实际上
已经成为了业界事实上的标准。如果某个框架遵循这些标准，那么各个框架间的代码就可以通用，比如slim框架遵循了PSR7，那么你就可以用其它
遵循PSR7的组件来替换自带的。
另外对于使用者来说，学习和迁移成本也降低了。

PSR 不是PHP官方标准，而是从如Zend、Symfony2等知名PHP项目中提炼出来的一系列标准，目前有越来越多的社区项目加入并遵循该标准。

PSR-0 自动加载 X已废弃
PSR-1 基本代码规范
PSR-2 代码样式
PSR-3 日志接口
PSR-4 如何指定文件路径从而自动加载类定义

PSR-1基本代码规范
本篇规范制定了代码基本元素的相关标准，以确保共享的PHP代码间具有较高程度的技术互通性。

文件

· PHP代码文件必须以 <?php 或 <?= 标签开始；

· PHP代码文件必须以不带 BOM 的 UTF-8 编码；

· PHP代码中应该只定义类、函数、常量等声明，或其他会产生副作用的操作（如：生成文件输出以及修改 .ini 配置文件等），二者只能选其一；

命名空间与类

· 类命名必须遵循 StudlyCaps 大写开头的驼峰命名规范；

· 每个类都独立为一个文件，且命名空间至少有一个层次：顶级的组织名称（vendorname）

类属性：小写开头驼峰 $studlyCaps
类方法：小写开头驼峰

常量

· 类中的常量所有字母都必须大写，单词间用下划线分隔；

方法名称必须符合 camelCase 式的小写开头驼峰命名规范。

PSR-2编码风格规范
缩进

· 代码必须使用4个空格符而不是「Tab 键」进行缩进。

行

每行的字符数应该软性保持在 80 个之内，一定不可多于 120 个，但一定不可有硬性限制。
所有PHP文件必须以一个空白行作为结束。
每行一定不可存在多于一条语句
每个 namespace 命名空间声明语句和 use 声明语句块后面，必须插入一个空白行。
类的开始花括号（{）必须写在函数声明后自成一行，结束花括号（}）也必须写在函数主体后自成一行。
方法的开始花括号（{）必须写在函数声明后自成一行，结束花括号（}）也必须写在函数主体后自成一行。
控制结构的开始花括号（{）必须写在声明的同一行，而结束花括号（}）必须写在主体后自成一行。

修饰符

类的属性和方法必须添加访问修饰符（private、protected 以及 public），abstract 以及final 必须声明在访问修饰符之前，而 static 必须声明在访问修饰符之后。

空格

类方法参数每个逗号后面必须要有一个空格，而逗号前面一定不可有空格
控制结构的开始左括号后和结束右括号前，都一定不可有空格符。
关键字

· 控制结构的关键字后必须要有一个空格符，而调用方法或函数时则一定不可有。

PHP所有关键字必须全部小写，常量 true 、false 和 null 也必须全部小写。

PSR-3日志接口规范
LoggerInterface 接口对外定义了八个方法，分别用来记录 RFC 5424 中定义的八个等级的日志：debug、 info、 notice、 warning、 error、 critical、 alert 以及 emergency 。

第九个方法 —— log，其第一个参数为记录的等级。可使用一个预先定义的等级常量作为参数来调用此方法，必须与直接调用以上八个方法具有相同的效果。如果传入的等级常量参数没有预先定义，则必须抛出Psr\Log\InvalidArgumentException 类型的异常。在不确定的情况下，使用者不该使用未支持的等级常量来调用此方法。

/**

* 日志等级常量定义

class LogLevel

{

constEMERGENCY='emergency';

constALERT ='alert';

constCRITICAL ='critical';

constERROR ='error';

constWARNING ='warning';

constNOTICE ='notice';

constINFO ='info';

constDEBUG ='debug';

}

PSR-4自动加载规范
类似如下范例：<NamespaceName>(<SubNamespaceNames>)*<ClassName>

1. 完全合规类名必须有一个顶级命名空间（Vendor Name）

2. 完全合规类名可以有多个子命名空间

3. 完全合规类名应该有一个终止类名

4. 下划线在完全合规类名中是没有特殊含义的

5. 字母在完全合规类名中可以是任何大小写的组合

6. 所有类名必须以大小写敏感的方式引用

7. 终止类名对应一个以 .php 结尾的文件。文件名必须和终止类名大小写匹配

一些常用的自定义规范
控制层
1. 不出现sql语句(sql封装到模型层然后作为方法调用)

2. sql语句、3行以上逻辑代码空行

3. 上下文关系函数或方法间不空行

4. bool使用if(true === $name)的形式

5. 使用双引号链接变量

6. 注意隐式转换

7. 使用全局变量需要注释其含义，取值范围

/**
* 全局变量总体说明
* Global STATUS_CODE
* 0 － SUCCESS
* 2 － ERROR
*/
STATUS_CODE

8. 函数头部如下注释：

/*************************************************
Function:       // 函数中文名称
Description:    // 函数功能、性能等的描述
Calls:          // 被本函数调用的函数清单
Called By:      // 调用本函数的函数清单
Table Accessed: // 被访问的表（此项仅对于牵扯到数据库操作的程序）
Table Updated:  // 被修改的表（此项仅对于牵扯到数据库操作的程序）
Input:          // 输入参数说明，包括每个参数的作用、取值说明及参数间关系。
Output:         // 对输出参数的说明。
Return:         // 函数返回值的说明
Others:         // 其它说明
*************************************************/

9. 注释间空行

// code one comments
program code one

// code two comments
program code two

10. 文件头部注释

/************************************************************
Copyright (C), 1988-1999, Huawei Tech. Co., Ltd. // 版权
FileName: test.cpp                               // 文件名
Author:                                         // 作者
Version :                                       // 版本
Date:                                           // 日期
Description:                                    // 模块描述
Function List:                                  // 主要函数及其功能
History:                                        // 历史修改记录
<author>    <time>    <version >    <desc>
Lizhijian   17/10/11   1.0          init
***********************************************************/

11. switch语句的case跳转需要注释

12. 标记变量的命名：

temp 可缩写为 tmp  ;
flag 可缩写为  flg  ;
statistic 可缩写为  stat ;
increment 可缩写为  inc  ;
message 可缩写为  msg  ;

13.接口的命名前缀

add / remove       begin / end        create / destroy
insert /delete       first / last         get / release
increment /decrement                 put / get
add /delete         lock / unlock      open / close
min /max          old / new         start / stop
next /previous      source / target     show / hide
send /receive       source / destination
cut /paste          up / down

14.状态码尽量使用常量，而不是难以理解的数字

应改为如下形式。
#defineTRUNK_IDLE 0
#define TRUNK_BUSY 1

if (Trunk[index].trunk_state == TRUNK_IDLE)
{
Trunk[index].trunk_state = TRUNK_BUSY;
... //program code
}

15. 类文件名使用首大写驼峰方式，普通文件名使用下划线方式

16. 配置里的变量名使用下划线方式

1. 变量自增自减写到表达式前面： --e >= $name
2. 程序顺序应该遵循：参数定义代码->判断逻辑代码->业务逻辑代码
3. 大的数据使用引用
4. 为逻辑代码里每个复杂度高/重复度高的代码添加注释
5. 尽量不为简短代码引入新的变量，减少变量污染
1、如果能将类的方法定义成static，就尽量定义成static，它的速度会提升将近4倍。

2、$row[’id’] 的速度是$row[id]的7倍。

3、echo 比 print 快，并且使用echo的多重参数(译注：指用逗号而不是句点)代替字符串连接，比如echo $str1,$str2。

4、在执行for循环之前确定最大循环数，不要每循环一次都计算最大值，最好运用foreach代替。

5、注销那些不用的变量尤其是大数组，以便释放内存。

6、尽量避免使用__get，__set，__autoload。

7、require_once()代价昂贵。

8、include文件时尽量使用绝对路径，因为它避免了PHP去include_path里查找文件的速度，解析操作系统路径所需的时间会更少。

9、如果你想知道脚本开始执行(译注：即服务器端收到客户端请求)的时刻，使用$_SERVER[‘REQUEST_TIME’]要好于time()。

10、函数代替正则表达式完成相同功能。

11、str_replace函数比preg_replace函数快，str函数的效率是str_replace函数的四倍。

12、如果一个字符串替换函数，可接受数组或字符作为参数，并且参数长度不太长，那么可以考虑额外写一段替换代码，使得每次传递参数是一个字符，而不是只写一行代码接受数组作为查询和替换的参数。

13、使用选择分支语句(译注：即switch case)好于使用多个if，else if语句。

14、用@屏蔽错误消息的做法非常低效，极其低效。

15、打开apache的mod_deflate模块，可以提高网页的浏览速度。

16、数据库连接当使用完毕时应关掉，不要用长连接。

17、错误消息代价昂贵。

18、避免递增全局变量
原文链接：https://blog.csdn.net/u013933858/article/details/79780179