概述

我們可以將此歸咎于許多原因，但這肯定不僅僅是因?yàn)?PHP 生態(tài)系統(tǒng)缺乏適當(dāng)?shù)臏y試工具。在本文中，我想向您展示一個簡單的設(shè)置，用于項(xiàng)目的基本質(zhì)量測試。 我不會詳述任何特定的工具，而是專注于設(shè)定測試環(huán)境。

本文中有一個演示代碼可以在 GitHub 上找到：https://github.com/mkosiedowski/php-testing-demo如果你對這篇文章中的例子有任何問題，可以參考。

1 必備條件

我假設(shè)您熟悉 PHP 7.1 語法，您可以使用 Composer 和 PSR-4 來進(jìn)行自動加載和 PSR-1PSR-2 的編碼標(biāo)準(zhǔn)。在我的示例中，vendor 的二進(jìn)制文件被安裝到 ./bin 目錄。

2 構(gòu)建工具

我們將使用一些不同的測試工具，所以最好有一些能用一個腳本來運(yùn)行它們的東西。 PHING 為我們提供了解決此問題的絕佳解決方案。 PHing 與 Apache Ant 相似，可以使用 XML 配置輕松自動執(zhí)行任務(wù)。 我們可以通過運(yùn)行以下命令來安裝它：

$ php composer.phar require --dev phing/phing

然后，在項(xiàng)目的根目錄中創(chuàng)建一些基本的 build.xml 文件。

?xml version="1.0" encoding="UTF-8"?>project name="MyProject" default="run">/project>

在接下來的步驟中，我們將添加一些由 PHing 運(yùn)行的目標(biāo)。

3 靜態(tài)代碼分析

我為了提高代碼質(zhì)量，您可以做的第一件事就是設(shè)置靜態(tài)代碼分析器。他們會在沒有真正運(yùn)行的情況下閱讀你的錯誤代碼。這就像在幾秒鐘內(nèi)由一個機(jī)器人完成了一個代碼審查一樣。很酷，不是嗎?

4 代碼風(fēng)格

當(dāng)使用正確的樣式編寫時，您的代碼更容易維護(hù)。每個人都知道（如果你不這樣做，你至少應(yīng)該開始閱讀 Robert C. Martin 的“Clean Code”），但仍然有很多團(tuán)隊(duì)在遵守他們達(dá)成的標(biāo)準(zhǔn)方面存在問題。我們可以用 phpcs - PHP 代碼嗅探來自動化這個任務(wù)，有沒有很神奇。

我們可以通過運(yùn)行以下命令來安裝：

$ php composer.phar require --dev squizlabs/php_codesniffer

然后添加一個在 build.xml 中運(yùn)行它的目標(biāo)。你的 build.xml 現(xiàn)在應(yīng)該是這樣的：

?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>

現(xiàn)在您可以運(yùn)行 ./bin/phing 了，phpc 將自動檢查您是否在 PSR-1 和 PSR-2 編碼標(biāo)準(zhǔn)上有任何錯誤。

許多框架，比如 Symfony，定義了它們自己的代碼風(fēng)格規(guī)則，我們也可以自動檢查這些規(guī)則。比如：如果您使用的是 Symfony 框架，請檢查https://github.com/leaphub/phpcs-symfony2標(biāo)準(zhǔn)，以了解如何使用 phpcs 檢查 Symfony 的標(biāo)準(zhǔn)。

錯誤格式的文件的示例輸出：

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

在代碼評審期間，不再浪費(fèi)時間檢查編碼標(biāo)準(zhǔn)，從現(xiàn)在開始，它將自動實(shí)現(xiàn)！

5 復(fù)制 / 粘貼檢測器

重復(fù)的代碼是不好的，每個人都知道。有時我們錯誤地創(chuàng)建了這樣的代碼，我們從來沒有注意到它。有時我們這樣做是因?yàn)槲覀儜卸琛Ｗ詈檬桥鋫湟粋€工具，它可以在構(gòu)建時提示這個問題。PHPCPD - PHP 復(fù)制 / 粘貼檢測器。

通過運(yùn)行以下命令來安裝它：

$ php composer.phar require --dev sebastian/phpcpd

然后將目標(biāo)添加到 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 目錄上運(yùn)行的重復(fù)代碼檢查的示例輸出：

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 想要真正深入的代碼分析？

如果你從頭開始你的項(xiàng)目，你應(yīng)該看看 Phan - 它是一個非常強(qiáng)大的代碼分析器，它會讓你的代碼變得漂亮。在https://github.com/phan/phan上查看。安裝非常簡單 - 只需安裝 php-ast 擴(kuò)展（在 Ubuntu 中，您可以嘗試運(yùn)行 sudo apt-get install php-ast）并運(yùn)行：

$ php composer.phar require --dev phan/phan

然后創(chuàng)建一個配置文件 .phan/config.php 內(nèi)容為：

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

在 build.xml 文件中也創(chuàng)建 phan 目標(biāo)：

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

現(xiàn)在，您可以運(yùn)行您的代碼分析，如果您犯了錯誤（例如……為類屬性聲明錯誤的 phpdoc 類型），您應(yīng)該看到這樣的消息：

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 很神奇 - 它讀取你的整個代碼并對它執(zhí)行多次檢查，包括將 phpdoc 聲明與實(shí)際使用變量、方法、類等進(jìn)行比較，你可以查看https://github.com/phan/phan#features的所有特征列表。

現(xiàn)在，您的項(xiàng)目中有三個完全自動化的工具，可以保護(hù)您的代碼的質(zhì)量。您所需要做的就是手動運(yùn)行 ./bin/phing，或者將其附加到您的 git-hook 或持續(xù)集成中。您的代碼將被檢查編碼標(biāo)準(zhǔn)、重復(fù)和正式錯誤。這些檢查應(yīng)該會導(dǎo)致更可靠的運(yùn)行時，并且花費(fèi)在代碼審查上的時間更少。

以上就是淺談如何提高PHP代碼的質(zhì)量的詳細(xì)內(nèi)容，更多關(guān)于如何提高PHP代碼的質(zhì)量的資料請關(guān)注腳本之家其它相關(guān)文章！