PHP中PSR-[0-4]标准代码规范

PHP-FIG

PHP-FIG

FIG

Framework Interoperability Group

PSR

PSR

Proposing a Standards Recommendation

1. PSR-0 (Autoloading Standard) 自动加载标准
2. PSR-1 (Basic Coding Standard) 基础编码标准
3. PSR-2 (Coding Style Guide) 编码风格向导
4. PSR-3 (Logger Interface) 日志接口
5. PSR-4 (Improved Autoloading) 自动加载的增强版，可以替换掉PSR-0了。

PSR-0 规范

Deprecated - As of 2014-10-21 PSR-0 has been marked as deprecated. PSR-4 is now recommended as an alternative.

声明：namespace  \Doctrine\Common\
调用：\Doctrine\Common\IsolatedClassLoader

声明：namespace \Symfony\Core
调用：\Symfony\Core\Request

namespace \Zend\Acl => /path/to/project/lib/vendor/Zend/Acl.php
namespace \Zend\Mail\Message => /path/to/project/lib/vendor/Zend/Mail/Message.php

new \Symfony\Core\Request

_

\namespace\package\Class_Name => /path/to/project/lib/vendor/namespace/package/Class/Name.php

\namespace\package_name\Class_Name => /path/to/project/lib/vendor/namespace/package_name/Class/Name.php

<IfModule dir_module>
DirectoryIndex index.php index.php3 index.html index.htm
</IfModule>

namespace  \Doctrine\Common\IsolatedClassLoader
```[这里写链接内容](http://www.php-fig.org/psr/psr-0/)
在Linux下就去严格按照大小写去找目录和文件了。但是如果你在windows下开发，全是小写也不会报错，但是当你一发布到Linux上就悲剧了，提示找不到文件，我曾经就犯过这个错误。所以，大小写太重要了，按照Linux要求来严格要求自己。

<div class="se-preview-section-delimiter"></div>

PSR-1 规范
--------

1. PHP源文件必须只使用 `<?php ?>` 和 `<?= ?>` 这两种标签。
2. 源文件中php代码的编码格式必须是不带字节顺序标记(BOM)的UTF-8。
3. 一个源文件建议只用来做声明（类(class)，函数(function)，常量(constant)等）或者只用来做一些引起副作用的操作（例如：输出信息，修改.ini配置等），但不建议同时做这两件事。
4. 命名空间(namespace)和类(class) 必须遵守PSR-0标准。
5. 类名(class name) 必须使用骆驼式(StudlyCaps)写法 (注：驼峰式(cameCase)的一种变种，后文将直接用StudlyCaps表示)。
6. 类(class)中的常量必须只由大写字母和下划线(_)组成。
7. 方法名(method name) 必须使用驼峰式(cameCase)写法。

上面的基本7大点，有些很简单，就不过多说明，第3点需要仔细说下。

**第1条**

这个基本都是大家都懂得的，PHP代码必须只使用长标签(`<?php ?>`)或者短输出式标签(`<?= ?>`)；而不要使用其他标签。
之所以说这个，是因为我们在学习PHP的时候，一般的教材都告诉我们说，php有4种标记风格： 所以，很多人就乱来了。

**第2条**

这个不多说，保存的时候格式必须是无BOM的UTF-8格式，否则会出现很多无法解释的千奇百怪的问题。千万别用Windows下的text文本编辑器保存文件。

**第3条**

这个通俗的说呢。就是别把一些输出和修改的操作(副作用) 和 类文件混合在一起，专注一点，这个文件专门来声明Class, 那个文件专门来修改配置文件，别混在一起写：
所以，以下的这个文件是有问题的，最好不要这样：

<div class="se-preview-section-delimiter"></div>

上面看起来很乱。最好全部分开来写:

<div class="se-preview-section-delimiter"></div>

public static function test()
{
echo __NAMESPACE__ . ' static function test <br>';
}

修改ini:

<div class="se-preview-section-delimiter"></div>

require 文件：

<div class="se-preview-section-delimiter"></div>

现在应该看起来整齐多了吧。当然这个是很难约束的，自己仔细划分。

**第4条**

约束namespace，前面已经说过。值得说的是名字要是驼峰方式。

**第5条**

class name必须要用驼峰方式写，驼峰又分小驼峰和大驼峰（小驼峰是第一个字母是小写）这样写看着舒服也比较规范，不做要求，反正是驼峰就可以了。

**第6条**

规定类中的常量名(const)声明必须要全部大写，如果有多个单词，就用_分开：

<div class="se-preview-section-delimiter"></div>

// 用_隔开
const HOUSE_INFO = '已经深圳买房';

public function getUserName()
{
//
}

**第7条**

method name必须要用驼峰方式写，大小驼峰都可以，不做要求：

<div class="se-preview-section-delimiter"></div>

PSR-2 规范
---------

PSR-2 规范的官网链接在此：[http://www.php-fig.org/psr/psr-2](http://www.php-fig.org/psr/psr-2/)，PSR-2 这一规范主要是约束代码风格的，可以说是所有里面最关键最重要的，也是需要好好规范和共同遵守的。
本文件中的"必须","不得","要求","应该","不应该","应该","不应该","推荐","可能"按[RFC 2119](http://www.ietf.org/rfc/rfc2119.txt)中的描述进行解释。

概括：

1. 代码必须遵循“编码风格指南”PSR [ PSR-1 ]。
2. 代码必须使用4个空格来缩进，而不是制表符。
3. 在线长度上一定不能是硬性限制。软限制必须是120个字符; 线应该是80个字符或更少。
4. namespace声明之后必须有一个空白行，并且在声明块之后必须有一个空白行use。
5. 类的开放括号必须在下一行，并且在花括号后面的括号必须在下一行。
6. 方法的花括号必须在下一行，并且括号必须在主体后面的下一行。
7. 可视性必须在所有属性和方法上声明; abstract并且 final必须在能见度之前声明; static必须在知名度后宣布。
8. 控制结构关键字之后必须有一个空格; 方法和函数调用禁止。
9. 控制结构的花括号必须在同一行上，并且花括号必​​须在主体后面的下一行上。
10. 控制结构的开括号不能在后面有空格，关闭控制结构的括号之前不能有空格。

**例**
这个例子包含下面的一些规则作为一个快速的概述：

<div class="se-preview-section-delimiter"></div>

PSR-4 规范