写点什么

如何提高 PHP 代码的质量?第一部分 自动化工具

  • 2019-11-21
  • 本文字数:2854 字

    阅读完需:约 9 分钟

如何提高PHP代码的质量?第一部分 自动化工具

说实话,在代码质量方面,PHP 的压力非常大。通过阅读本系列文章,您将了解如何提高 PHP 代码的质量。


说实话,在代码质量方面,PHP 的压力非常大。通过阅读本系列文章,您将了解如何提高 PHP 代码的质量。


我们可以将此归咎于许多原因,但这肯定不仅仅是因为 PHP 生态系统缺乏适当的测试工具。在本文中,我想向您展示一个简单的设置,用于项目的基本质量测试。 我不会详述任何特定的工具,而是专注于设定测试环境。


本文中有一个演示代码可以在 GitHub 上找到:https://github.com/mkosiedowski/php-testing-demo 如果你对这篇文章中的例子有任何问题,可以参考。

1 必备条件

我假设您熟悉 PHP 7.1 语法,您可以使用 Composer 和 PSR-4 来进行自动加载和 PSR-1&PSR-2 的编码标准。在我的示例中,vendor 的二进制文件被安装到 ./bin 目录。

2 构建工具

我们将使用一些不同的测试工具,所以最好有一些能用一个脚本来运行它们的东西。 PHING 为我们提供了解决此问题的绝佳解决方案。 PHing 与 Apache Ant 相似,可以使用 XML 配置轻松自动执行任务。 我们可以通过运行以下命令来安装它:


$ php composer.phar require --dev phing/phing
复制代码


然后,在项目的根目录中创建一些基本的 build.xml 文件。


<?xml version="1.0" encoding="UTF-8"?><project name="MyProject" default="run"></project>
复制代码


在接下来的步骤中,我们将添加一些由 PHing 运行的目标。

3 静态代码分析

我为了提高代码质量,您可以做的第一件事就是设置静态代码分析器。他们会在没有真正运行的情况下阅读你的错误代码。这就像在几秒钟内由一个机器人完成了一个代码审查一样。很酷,不是吗?

4 代码风格

当使用正确的样式编写时,您的代码更容易维护。每个人都知道(如果你不这样做,你至少应该开始阅读 Robert C. Martin 的“Clean Code”),但仍然有很多团队在遵守他们达成的标准方面存在问题。我们可以用 phpcs - PHP 代码嗅探来自动化这个任务,有没有很神奇。


我们可以通过运行以下命令来安装:


$ php composer.phar require --dev squizlabs/php_codesniffer
复制代码


然后添加一个在 build.xml 中运行它的目标。你的 build.xml 现在应该是这样的:


<?xml version="1.0" encoding="UTF-8"?><project name="MyProject" default="run">    <target name="phpcs" description="Check code style with PHP_CodeSniffer">        <exec executable="bin/phpcs" passthru="true" checkreturn="true">            <arg line="--standard=PSR1,PSR2 -extensions=php src"/>        </exec>    </target>    <target name="run" depends="phpcs"/></project>
复制代码


现在您可以运行 ./bin/phing 了,phpc 将自动检查您是否在 PSR-1 和 PSR-2 编码标准上有任何错误。


许多框架,比如 Symfony,定义了它们自己的代码风格规则,我们也可以自动检查这些规则。比如:如果您使用的是 Symfony 框架,请检查https://github.com/leaphub/phpcs-symfony2标准,以了解如何使用 phpcs 检查 Symfony 的标准。


错误格式的文件的示例输出:


MyProject > phpcs:

FILE: /home/maciej/workspace/php-testing/src/Domain/Price.php-------------------------------------------------------------------------FOUND 1 ERROR AFFECTING 1 LINE-------------------------------------------------------------------------28 | ERROR | Method name "Price::get_value" is not in camel caps format-------------------------------------------------------------------------Time: 67ms; Memory: 6Mb
复制代码


在代码评审期间,不再浪费时间检查编码标准,从现在开始,它将自动实现!

5 复制/粘贴检测器

重复的代码是不好的,每个人都知道。有时我们错误地创建了这样的代码,我们从来没有注意到它。有时我们这样做是因为我们懒惰。最好是配备一个工具,它可以在构建时提示这个问题。PHPCPD - PHP 复制/粘贴检测器。


通过运行以下命令来安装它:


$ php composer.phar require --dev sebastian/phpcpd
复制代码


然后将目标添加到 build.xml:


<target name="phpcpd" description="Generate pmd-cpd.xml using PHPCPD">    <exec executable="bin/phpcpd" passthru="true">        <arg line="src"/>    </exec></target>...<target name="run" depends="phpcs,phpcpd"/>
复制代码


在 vendor 目录上运行的重复代码检查的示例输出:


phpcpd 4.0.0 by Sebastian Bergmann.
Found 74 clones with 2929 duplicated lines in 97 files:
- /home/maciej/workspace/php-testing/vendor/phpspec/phpspec/src/PhpSpec/Matcher/TriggerMatcher.php:81-102 /home/maciej/workspace/php-testing/vendor/phpspec/phpspec/src/PhpSpec/Matcher/TriggerMatcher.php:114-135
- /home/maciej/workspace/php-testing/vendor/squizlabs/php_codesniffer/src/Reports/Full.php:81-114 /home/maciej/workspace/php-testing/vendor/squizlabs/php_codesniffer/src/Reports/Code.php:162-195
(...)
复制代码

6 想要真正深入的代码分析?

如果你从头开始你的项目,你应该看看 Phan - 它是一个非常强大的代码分析器,它会让你的代码变得漂亮。在https://github.com/phan/phan上查看。安装非常简单 - 只需安装 php-ast 扩展(在 Ubuntu 中,您可以尝试运行 sudo apt-get install php-ast)并运行:


$ php composer.phar require --dev phan/phan
复制代码


然后创建一个配置文件 .phan/config.php 内容为:


<?phpreturn [    'target_php_version' => '7.1',    'directory_list' => [        'src',        'vendor/symfony/console',    ],    "exclude_analysis_directory_list" => [        'vendor/'    ],];

复制代码


在 build.xml 文件中也创建 phan 目标:


<target name="phan" description="Check code with phan">   <exec executable="bin/phan" passthru="true" checkreturn="true"/></target>...<target name="run" depends="phpcs,phpcpd,phan"/>
复制代码


现在,您可以运行您的代码分析,如果您犯了错误(例如……为类属性声明错误的 phpdoc 类型),您应该看到这样的消息:


MyProject > phan:
src/Domain/PriceComparator.php:17 PhanTypeMismatchProperty Assigning \Domain\PriceConverter to property but \Domain\PriceComparator::priceConverter is intsrc/Domain/PriceComparator.php:35 PhanNonClassMethodCall Call to method convert on non-class type int
复制代码


Phan 很神奇 - 它读取你的整个代码并对它执行多次检查,包括将 phpdoc 声明与实际使用变量、方法、类等进行比较,你可以查看https://github.com/phan/phan#features的所有特征列表。

总结

现在,您的项目中有三个完全自动化的工具,可以保护您的代码的质量。您所需要做的就是手动运行 ./bin/phing,或者将其附加到您的 git-hook 或持续集成中。您的代码将被检查编码标准、重复和正式错误。这些检查应该会导致更可靠的运行时,并且花费在代码审查上的时间更少。


本文转载自公众号 360 云计算(ID:hulktalk)。


原文链接:


https://mp.weixin.qq.com/s/59U18gElkJPax3_hJSTuTA


2019-11-21 23:462399

评论

发布
暂无评论
发现更多内容

YashanDB数据库数据迁移及兼容性解决方案

数据库砖家

switchresx mac 屏幕分辨率修改工具 附switchresx注册安装教程

Rose

Music Tag Editor Mac 批量的处理音乐的标签

Rose

YashanDB数据库数据导入导出实操指南

数据库砖家

YashanDB数据库数据加密与访问控制实用指南

数据库砖家

YashanDB数据库数据迁移的步骤与注意事项

数据库砖家

YashanDB数据库数据迁移实用方案及操作步骤

数据库砖家

YashanDB数据库数据压缩与存储优化方法

数据库砖家

YashanDB数据库未来发展趋势及技术展望

数据库砖家

如何安装SideFX Houdini?3D影视特效渲染SideFX Houdini Mac详细图文教程分享

Rose

白噪音Noizio for Mac,舒缓你的心情,提升工作效率!

Rose

鸿蒙开发实战之XEngine Kit构建教育智能推理引擎

bianchengyishu

HarmonyOS NEXT

YashanDB数据库日志清理与存储空间管理实操教程

数据库砖家

鸿蒙开发实战之Graphics Accelerate Kit打造教育图形加速引擎

bianchengyishu

HarmonyOS NEXT

YashanDB数据库数据一致性保障机制详解

数据库砖家

YashanDB数据库数据安全策略详解

数据库砖家

YashanDB数据库数据迁移与同步实操教程

数据库砖家

mac电脑上U盘启动盘制作工具 balenaEtcher免费版

Rose

YashanDB数据库日志文件管理与安全策略讲解

数据库砖家

Mac 虚拟机工具 VMware Fusion Pro 13中文版 含激活码 附详细安装教程

Rose

Cinema 4D 2024 for mac(c4d 2024激活补丁)中文详细图文教程

Rose

YashanDB数据库数据迁移全流程实操指南

数据库砖家

YashanDB数据库数据同步与异地容灾解决方案

数据库砖家

YashanDB数据库数据压缩技术及应用场景

数据库砖家

YashanDB数据库日志管理与故障排查操作手册

数据库砖家

YashanDB数据库日志管理与故障排查实用技巧

数据库砖家

adobe pr 2025 Mac中文激活补丁及安装教程 兼容M/intel

Rose

3D灯光贴图渲染HDR Light Studio Xenon 破解补丁版 兼容Mac26系统及M芯片

Rose

YashanDB数据库数据加密实践及应用场景

数据库砖家

RustRover 2025 for Mac详细图文安装教程 附RustRover 2025破解补丁

Rose

YashanDB数据库数据导入导出最佳实践详解

数据库砖家

如何提高PHP代码的质量?第一部分 自动化工具_文化 & 方法_360云计算_InfoQ精选文章