良好的代码规范可以提高代码可读性，团队沟通维护成本。最推荐大家遵守的是 php-fig（PHP Framework Interop Group）组织定义的 PSR-1 、 PSR-2 两个。不了解的同学可以先通过连接点击过去阅读下。

这篇文章主要介绍下两个工具让你的代码符合规范。

PHP-CS-Fixer

项目地址： https://github.com/FriendsOfPHP/PHP-CS-Fixer
使用效果可见今天 PHPHub 的一次 commit

通过安装 Composer 安装

composer.phar global require friendsofphp/php-cs-fixer

然后，确保~/.composer/vendor/bin目录在你的PATH中。

export PATH="$PATH:$HOME/.composer/vendor/bin"

其他安装方法参考官方的 Installation

使用

使用 fix 指令修复文件夹或文件的代码风格

php php-cs-fixer.phar fix /path/to/dir
php php-cs-fixer.phar fix /path/to/file

--verbose 选项用于展示应用了的规则，默认是文本（txt）格式。

使用 --level 选项设置修复至的「规范」。

php php-cs-fixer.phar fix /path/to/project --level=psr0
php php-cs-fixer.phar fix /path/to/project --level=psr1
php php-cs-fixer.phar fix /path/to/project --level=psr2
php php-cs-fixer.phar fix /path/to/project --level=symfony

默认情况下执行的是 PSR-2 的所有选项以及一些附加选项（主要是 symfony 相关的）。还有一些属于『贡献级别』的选项，你可以通过 --fixers 选择性的添加，--fixers 的多个条件要用逗号分开：

php-cs-fixer fix /path/dir --fixers=linefeed,short_tag,indentation

如果有需要的话也可以使用 -name_of_fixer 采取黑名单的方式设定禁用哪些选项。如果同时设定了 --fixers 和 -name_of_fixer，前者的优先级更高。

同时使用 --dry-run 和 --diff 命令可以显示出需要修改的汇总，但是并不实际修改。

通过以下方式也可以查看有哪些内容是会修改的，但是并不实际改动文件：

cat foo.php | php-cs-fixer fix --diff -

自定义配置

--config 选项可以用来设置选取目录以及文件进行分析并格式化，但是这个选项只能设置一些常见的已知的项目，比如 symfony：

# For the Symfony 2.3+ branch
php-cs-fixer fix /path/to/sf23 --config=sf23

已有选项：

default 默认配置
magento magento 项目
sf23 symfony 的项目

更多时候，我们可以通过配置文件来自定义格式化选项以及搜索的目录和文件。自定义配置通过在项目根目录添加一个.php_cs 文件的方式实现。

设置本身就是 PHP 代码，最后返回一个 Symfony\CS\ConfigInterface 的实例即可。你可以设置格式化的选项、级别、文件以及目录。

下面是一个简单的例子：

<?php

$finder = Symfony\CS\Finder\DefaultFinder::create()
    ->exclude('somedir') // 忽略 somedir
    ->in(__DIR__) // 当前目录
;

return Symfony\CS\Config\Config::create()
    ->fixers(['strict_param', 'short_array_syntax']) // 添加两个选项
    ->finder($finder)
;

如果你想完全自定义格式化选项，就需要将格式化级别清空，并指定好所有需要的选项：

<?php

$finder = Symfony\CS\Finder\DefaultFinder::create()
    ->in(__DIR__)
;

return Symfony\CS\Config\Config::create()
    ->level(Symfony\CS\FixerInterface::NONE_LEVEL)
    ->fixers(['trailing_spaces', 'encoding'])
    ->finder($finder)
;

你也可以通过在选项前面添加 - 的方式来禁用某些选项，比如下面这个例子不采用 PSR-0：

<?php

$finder = Symfony\CS\Finder\DefaultFinder::create()
    ->exclude('somedir')
    ->in(__DIR__)
;

return Symfony\CS\Config\Config::create()
    ->fixers(['-psr0'])
    ->finder($finder)
;

默认条件下的格式化级别是 symfony (最严格)，你可以修改这个级别：

<?php

return Symfony\CS\Config\Config::create()
    ->level(Symfony\CS\FixerInterface::PSR2_LEVEL)
;

通过这些设置选项的组合，可以很轻易的定制出自己想要的效果。

你也可以通过 --config-file 选项指定 .php_cs 文件的位置。

启用缓存可以在后续的执行中加快速度，通过以下方法设置：

<?php

return Symfony\CS\Config\Config::create()
    ->setUsingCache(true)
;

编辑器插件

下面这些编辑器/IDE 的插件可以帮你简化格式化的工作：

更多使用方式参见 Usage

格式化选项

psr0 [PSR-0]
PSR-0 的路径和命名空间标准
encoding [PSR-1]
文件必须是不带 BOM 的 UTF-8 编码；
short_tag [PSR-1]
只能使用和两种 PHP 代码标签；
braces [PSR-2]
所有语句块都必须包含在花括号内，且位置以及缩进是符合标准的；
class_definition [PSR-2]
class、trait、interfaces 关键字和名称之间只能有一个空格；
elseif [PSR-2]
使用 elseif 替代 else if；
eof_ending [PSR-2]
文件必须以空白行结尾；
function_call_space [PSR-2]
调用函数和方法时，函数名和方法名与参数扩展之间不能有空格；
function_declaration [PSR-2]
函数声明时空格的使用需要符合 PSR-2；
indentation [PSR-2]
代码必须使用四个空格缩进而不是制表符；
line_after_namespace [PSR-2]
命名空间的声明后必须有一个空白行；
linefeed [PSR-2]
所有 PHP 文件都只能使用 LF(Unix) 结尾；
lowercase_constants [PSR-2]
PHP 常量 true、false 和 null 必须使用小写；
lowercase_keywords [PSR-2]
PHP 关键字必须都是小写；
method_argument_space [PSR-2]
方法声明及调用时，参数之间的逗号前不能有空格，逗号后必须有一个空格；
multiple_use [PSR-2]
每个 use 只能声明一个元素；
parenthesis [PSR-2]
圆括号内两侧不能有空格；
php_closing_tag [PSR-2]
纯 PHP 文件必须省略 ?> 标签；
single_line_after_imports [PSR-2]
每个 use 声明独立一行，且 use 语句块之后要有一个空白行；
trailing_spaces [PSR-2]
删除非空行之后多余的空格；
visibility [PSR-2]
每个属性和方法都必须指定作用域是 public、protected 还是 private，abstract 和 final 必须位于作用域关键字之前，static 必须位于作用域之后；
array_element_no_space_before_comma [symfony]
数组声明中，逗号之前不能有空格；
array_element_white_space_after_comma [symfony]
数组声明中，逗号之后必须有一个人空格；
blankline_after_open_tag [symfony]
PHP 开始标签的同一行不能有代码，且下面必须有一个空白行；
concat_without_spaces [symfony]
点连接符左右两边不能有多余的空格；
double_arrow_multiline_whitespaces [symfony]
=> 操作符两端不能有多个空白行；
duplicate_semicolon [symfony]
删除重复的分号；
empty_return [symfony]
return 语句如果没有任何返回的话直接写 return 即可（不用 return null）；
extra_empty_lines [symfony]
删除多余的空白行；
function_typehint_space [symfony]
修正函数参数和类型提示之间的缺失的空格问题；
include [symfony]
include 和文件路径之间需要有一个空格，文件路径不需要用括号括起来；
join_function [symfony]
使用 join 替换 implode 函数；
list_commas [symfony]
删除 list 语句中多余的逗号；
method_argument_default_value [symfony]
函数参数中有默认值的参数不能位于无默认值的参数之前；
multiline_array_trailing_comma [symfony]
多行数组最后一个元素应该也有一个逗号；
namespace_no_leading_whitespace [symfony]
命名空间前面不应该有空格；
new_with_braces [symfony]
使用 new 新建实例时后面都应该带上括号；
no_blank_lines_after_class_opening [symfony]
类开始标签后不应该有空白行；
no_empty_lines_after_phpdocs [symfony]
PHP 文档块开始开始元素下面不应该有空白行；
object_operator [symfony]
T_OBJECT_OPERATOR (->) 两端不应有空格；
operators_spaces [symfony]
二进制操作符两端至少有一个空格；
phpdoc_indent [symfony]
phpdoc 应该保持缩进；
phpdoc_inline_tag [symfony]
修正 phpdoc 内联标签格式，使标签与后续内容始终位于一行；
phpdoc_no_access [symfony]
@access 不应该出现在 phpdoc 中；
phpdoc_no_empty_return [symfony]
@return void 和 @return null 不应该出现在 phpdoc 中；
phpdoc_no_package [symfony]
@package 和 @subpackage 不应该出现在 phpdoc 中；
phpdoc_params [symfony]
@param, @throws, @return, @var, 和 @type 等 phpdoc 标签都要垂直对齐；
phpdoc_scalar [symfony]
phpdoc 标量类型声明时应该使用 int 而不是 integer，bool 而不是 boolean，float 而不是 real 或者 double；
phpdoc_separation [symfony]
phpdoc 中注释相同的属性应该放在一起，不同的属性之间应该有一个空白行分割；
phpdoc_short_description [symfony]
phpdoc 的简要描述应该以 .、! 或 ? 结尾；
phpdoc_to_comment [symfony]
文档块应该都是结构化的元素；
phpdoc_trim [symfony]
除了文档块最开始的部分和最后的部分，phpdoc 开始和结束都应该是有内容的；
phpdoc_type_to_var [symfony]
@type 需要使用 @var 代替；
phpdoc_types [symfony]
phpdoc 中应该正确使用大小写；
phpdoc_var_without_name [symfony]
@var 和 @type 注释中不应该包含变量名；
pre_increment [symfony]
不应该使用 ++i 或 --i 的用法；
print_to_echo [symfony]
如果可能的话，使用 echo 代替 print 语句；
remove_leading_slash_use [symfony]
删除 use 前的空行；
remove_lines_between_uses [symfony]
删除 use 语句块中的空行；
return [symfony]
return 之前应该有一个空行；
self_accessor [symfony]
在当前类中使用 self 代替类名；
short_bool_cast [symfony]
bool 类型数据前不应该试用两个感叹号；
single_array_no_trailing_comma [symfony]
PHP 单行数组最后一个元素后面不应该有空格；
single_blank_line_before_namespace [symfony]
命名空间声明前应该有一个空白行；
single_quote [symfony]
简单字符串应该使用单引号代替双引号；
spaces_after_semicolon [symfony]
修复分号后面的空格；
spaces_before_semicolon [symfony]
禁止只有单行空格和分号的写法；
spaces_cast [symfony]
变量和修饰符之间应该有一个空格；
standardize_not_equal [symfony]
使用 <> 代替 !=；
ternary_spaces [symfony]
三元运算符之间的空格标准化；
trim_array_spaces [symfony]
数组需要格式化成和函数/方法参数类似，上下没有空白行；
unalign_double_arrow [symfony]
不对其 =>；
unalign_equals [symfony]
不对其等号；
unary_operators_spaces [symfony]
一元运算符和运算数需要相邻；
unneeded_control_parentheses [symfony]
删除控制结构语句中多余的括号；
unused_use [symfony]
删除没有用到的 use 语句；
whitespacy_lines [symfony]
删除空白行中多余的空格；

当我们使用 PHP-CS-Fixer 让我们现有的代码规范化之后，我们怎么确保以后开发的代码，以及别人 pr 的代码都能正确的符合代码风格规范呢？

StyleCI

项目地址：https://github.com/StyleCI/StyleCI

官方网站：https://styleci.io/

StyleCI 是一个 Laravel5 项目，功能实现也是由 PHP-CS-Fixer 驱动。

它可以自己分析你项目的 pull request，并且在你 merge 前显示出分析的结果。

这两个都是好工具，对于规范项目代码风格很有帮助，推荐给大家。写得不是很详细，勿怪 😄

修心修己

使用PHP-CS-Fixer自动规范化你的PHP代码