php质量检查工具 phpmd的使用

PHPMD简介

团队在使用php-cs-fixer 代码格式自动式化工具之后,在格式,代码错误等方面带来了很大便利,不过在命名,代码质量,代码复杂度,缺少一些检查,在网上搜索后,发现PHPMD 一个PHP代码静态分析工具.

安装

官方网站 github
你可以直接到下载页面封装好的 phar 包：phpmd.phar

unix:

1. wget http://static.phpmd.org/php/latest/phpmd.phar -O phpmd.phar

2. chmod a+x phpmd.phar

3. mv phpmd.phar /usr/local/bin/phpmd.phar

windows

1. 下载phpmd.phar

2. 把phpmd.phar 放入php目录,然后把php安装目录加入系统PATH变量

composer

composer global require phpmd/phpmd

使用

1. /usr/local/bin/phpmd.phar

3. Mandatory arguments:

4. 1) A php source code filename or directory. Can be a comma-separated string

5. 2) A report format

6. 3) A ruleset filename or a comma-separated string of rulesetfilenames

8. Available formats: xml, text, html.

9. Available rulesets: cleancode, codesize, controversial, design, naming, unusedcode.

11. Optional arguments that may be put after the mandatory arguments:

12. --minimumpriority: rule priority threshold; rules with lower priority than this will not be used

13. --reportfile: send report output to a file; default to STDOUT

14. --suffixes: comma-separated string of valid source code filename extensions, e.g. php,phtml

15. --exclude: comma-separated string of patterns that are used to ignore directories

16. --strict: also report those nodes with a @SuppressWarnings annotation

17. --ignore-violations-on-exit: will exit with a zero code, even if any violations are found

发现命令行有三个参数

1. # phpmd 源代码路径 报告的格式 规则列表

2. # 源代码路径 支持

3. 一个文件 /path/to/file

4. 一个目录 /path/to/source

5. # 报告的格式 支持

6. xml:以XML格式输出；

7. text:简单的文本格式；

8. html:输出到单个的html；

9. # 规则列表 支持

10. phpmd_ruleset.xml 文件格式

11. codesize,unusedcode,naming 单个命令集合

12. # 附加参数

13. --exclude - 忽略的目录，以逗号分隔多个目录。

14. # 例子

15. phpmd /path/to/source html ./phpmd_ruleset.xml

规则集合列表：rules

1. Clean Code Rules: 强化代码整洁度的规则集。

2. Code Size Rules: 代码尺寸规则集.

3. Controversial Rules: 有争议的代码规则.

4. Design Rules: 软件设计的相关问题规则集.

5. Naming Rules: 名称太长，规则太短，等等规则集.

6. Unused Code Rules: 找到未使用的代码的规则集.

更多规则 中文参考手册

具体实例

一般在团队开发项目中,需要根据团队规范制定不同的规则文件,所以在项目根目录添加一个 phpmd.xml 规则文件后,之后自动部署的时候会运行脚本检查项目中的php代码。 下面是phpmd.xml一个例子

3. xmlns="http://pmd.sf.net/ruleset/1.0.0"

4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

5. xsi:schemaLocation="http://pmd.sf.net/ruleset/1.0.0 http://pmd.sf.net/ruleset_xml_schema.xsd"

6. xsi:noNamespaceSchemaLocation="http://pmd.sf.net/ruleset_xml_schema.xsd"

7. >

phpmd.phar ./application html ./phpmd.xml --exclude application/cache,vendor > phpmd.html