PHPCS

安装

有以下方式安装 PHPCS:

使用 composer:
  1. composer global require "squizlabs/php_codesniffer=*"

注意,你可能需要将 ~/.composer/vendor/bin/ 添加到 PATH 环境变量中,否则会报命令找不到。

使用 PEAR:
  1. pear install PHP_CodeSniffer
下载安装:
  1. curl -OL https://squizlabs.github.io/PHP_CodeSniffer/phpcs.phar
  2. php phpcs.phar -h
  3. curl -OL https://squizlabs.github.io/PHP_CodeSniffer/phpcbf.phar
  4. php phpcbf.phar -h

然后移动到命令目录:

  1. mv phpcs.phar /usr/bin/phpcs
  2. mv phpcbf.phar /usr/bin/phpcbf
  3. // 也许上面需要 sudo
  4. chmod +x /usr/bin/phpcs
  5. chmod +x /usr/bin/phpcbf

这里的 phpcbf 是代码修复工具。

使用

查看帮助:
  1. phpcs --help
添加标准:
  1. phpcs --config-set installed_paths PATH_TO_SEARCH_STANDARDS

注意:假设标准为 Weibo, 目录为:

  1. /Users/overtrue/code_standards/Weibo

其中Weibo 里才是 ruleset.xml,那么对应上面的 PATH_TO_SEARCH_STANDARDS 应该为:

  1. phpcs --config-set installed_paths /Users/overtrue/code_standards
查看已经安装的标准:
  1. phpcs -i
查看配置:
  1. phpcs --config-show
检查代码规范:
  1. phpcs ./codes/Example.php
  2. // or
  3. phpcs ./codes/

指定标准:

  1. phpcs ./codes/Example.php --standard=PSR2

报告格式:

  1. phpcs --report=summary /path/to/code

可用的格式有(默认为: full):

  1. full, xml, checkstyle, csv
  2. json, emacs, source, summary, diff
  3. svnblame, gitblame, hgblame or notifysend
修复代码

第一种:使用 diff 形式打补丁:

  1. phpcs --report-diff=/path/to/changes.diff /path/to/code
  2. patch -p0 -ui /path/to/changes.diff
  3. # patching file /path/to/code/file.php

第二种:使用 PHP Code Beautifier 和 Fixer:

  1. phpcbf /path/to/code

以上命令会自动修复原文件,如果不想直接覆盖原文件,可以使用 --suffix 指定修复后的代码后缀:

  1. phpcs /path/to/code --suffix=.fixed

更多 PHPCS 的使用请参考:https://github.com/squizlabs/PHP_CodeSniffer/wiki

PHPMD

安装

同样有以下安装方式:

下载 phar 文件安装:
  1. wget -c http://static.phpmd.org/php/latest/phpmd.phar
  2. mv phpmd.phar /usr/bin/phpmd
  3. chmod +x /usr/bin/phpmd
使用 Composer 安装:
  1. composer global require phpmd/phpmd

使用

  • 检查代码质量:
  1. # phpmd 代码路径 报告格式
  2. phpmd /path/to/source text

或者指定要检查的规则:

  1. # phpmd 代码路径 报告格式 规则列表
  2. phpmd /path/to/source text codesize,unusedcode,naming

或者使用xml指定检查规则:

  1. # phpmd 代码路径 报告格式 规则xml文件
  2. phpmd /path/to/source text /phpmd_ruleset.xml
  • 报告格式有:
    • xml, 以 XML 格式输出;
    • text, 简单的文本格式;
    • html, 输出到单个的html;

这里有一个phpmd规则可参考:https://github.com/overtrue/phpmd-rulesets

更多关于 PHPMD 的使用请参考:http://phpmd.org/documentation/index.html