淺談如何提高PHP代碼的質(zhì)量
我們可以將此歸咎于許多原因,但這肯定不僅僅是因?yàn)?PHP 生態(tài)系統(tǒng)缺乏適當(dāng)?shù)臏y(cè)試工具。在本文中,我想向您展示一個(gè)簡(jiǎn)單的設(shè)置,用于項(xiàng)目的基本質(zhì)量測(cè)試。 我不會(huì)詳述任何特定的工具,而是專注于設(shè)定測(cè)試環(huán)境。
本文中有一個(gè)演示代碼可以在 GitHub 上找到:https://github.com/mkosiedowski/php-testing-demo如果你對(duì)這篇文章中的例子有任何問(wèn)題,可以參考。
1 必備條件我假設(shè)您熟悉 PHP 7.1 語(yǔ)法,您可以使用 Composer 和 PSR-4 來(lái)進(jìn)行自動(dòng)加載和 PSR-1&PSR-2 的編碼標(biāo)準(zhǔn)。在我的示例中,vendor 的二進(jìn)制文件被安裝到 ./bin 目錄。
2 構(gòu)建工具我們將使用一些不同的測(cè)試工具,所以最好有一些能用一個(gè)腳本來(lái)運(yùn)行它們的東西。 PHING 為我們提供了解決此問(wèn)題的絕佳解決方案。 PHing 與 Apache Ant 相似,可以使用 XML 配置輕松自動(dòng)執(zhí)行任務(wù)。 我們可以通過(guò)運(yùn)行以下命令來(lái)安裝它:
$ 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>
在接下來(lái)的步驟中,我們將添加一些由 PHing 運(yùn)行的目標(biāo)。
3 靜態(tài)代碼分析我為了提高代碼質(zhì)量,您可以做的第一件事就是設(shè)置靜態(tài)代碼分析器。他們會(huì)在沒(méi)有真正運(yùn)行的情況下閱讀你的錯(cuò)誤代碼。這就像在幾秒鐘內(nèi)由一個(gè)機(jī)器人完成了一個(gè)代碼審查一樣。很酷,不是嗎?
4 代碼風(fēng)格當(dāng)使用正確的樣式編寫時(shí),您的代碼更容易維護(hù)。每個(gè)人都知道(如果你不這樣做,你至少應(yīng)該開(kāi)始閱讀 Robert C. Martin 的“Clean Code”),但仍然有很多團(tuán)隊(duì)在遵守他們達(dá)成的標(biāo)準(zhǔn)方面存在問(wèn)題。我們可以用 phpcs - PHP 代碼嗅探來(lái)自動(dòng)化這個(gè)任務(wù),有沒(méi)有很神奇。
我們可以通過(guò)運(yùn)行以下命令來(lái)安裝:
$ php composer.phar require --dev squizlabs/php_codesniffer
然后添加一個(gè)在 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 將自動(dòng)檢查您是否在 PSR-1 和 PSR-2 編碼標(biāo)準(zhǔn)上有任何錯(cuò)誤。
許多框架,比如 Symfony,定義了它們自己的代碼風(fēng)格規(guī)則,我們也可以自動(dòng)檢查這些規(guī)則。比如:如果您使用的是 Symfony 框架,請(qǐng)檢查https://github.com/leaphub/phpcs-symfony2標(biāo)準(zhǔn),以了解如何使用 phpcs 檢查 Symfony 的標(biāo)準(zhǔn)。
錯(cuò)誤格式的文件的示例輸出:
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
在代碼評(píng)審期間,不再浪費(fèi)時(shí)間檢查編碼標(biāo)準(zhǔn),從現(xiàn)在開(kāi)始,它將自動(dòng)實(shí)現(xiàn)!
5 復(fù)制 / 粘貼檢測(cè)器重復(fù)的代碼是不好的,每個(gè)人都知道。有時(shí)我們錯(cuò)誤地創(chuàng)建了這樣的代碼,我們從來(lái)沒(méi)有注意到它。有時(shí)我們這樣做是因?yàn)槲覀儜卸?。最好是配備一個(gè)工具,它可以在構(gòu)建時(shí)提示這個(gè)問(wèn)題。PHPCPD - PHP 復(fù)制 / 粘貼檢測(cè)器。
通過(guò)運(yùn)行以下命令來(lái)安裝它:
$ 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 想要真正深入的代碼分析?如果你從頭開(kāi)始你的項(xiàng)目,你應(yīng)該看看 Phan - 它是一個(gè)非常強(qiáng)大的代碼分析器,它會(huì)讓你的代碼變得漂亮。在https://github.com/phan/phan上查看。安裝非常簡(jiǎn)單 - 只需安裝 php-ast 擴(kuò)展(在 Ubuntu 中,您可以嘗試運(yùn)行 sudo apt-get install php-ast)并運(yùn)行:
$ php composer.phar require --dev phan/phan
然后創(chuàng)建一個(gè)配置文件 .phan/config.php 內(nèi)容為:
<?phpreturn [’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)行您的代碼分析,如果您犯了錯(cuò)誤(例如……為類屬性聲明錯(cuò)誤的 phpdoc 類型),您應(yīng)該看到這樣的消息:
MyProject > phan: src/Domain/PriceComparator.php:17 PhanTypeMismatchProperty Assigning DomainPriceConverter to property but DomainPriceComparator::priceConverter is intsrc/Domain/PriceComparator.php:35 PhanNonClassMethodCall Call to method convert on non-class type int
Phan 很神奇 - 它讀取你的整個(gè)代碼并對(duì)它執(zhí)行多次檢查,包括將 phpdoc 聲明與實(shí)際使用變量、方法、類等進(jìn)行比較,你可以查看https://github.com/phan/phan#features的所有特征列表。
現(xiàn)在,您的項(xiàng)目中有三個(gè)完全自動(dòng)化的工具,可以保護(hù)您的代碼的質(zhì)量。您所需要做的就是手動(dòng)運(yùn)行 ./bin/phing,或者將其附加到您的 git-hook 或持續(xù)集成中。您的代碼將被檢查編碼標(biāo)準(zhǔn)、重復(fù)和正式錯(cuò)誤。這些檢查應(yīng)該會(huì)導(dǎo)致更可靠的運(yùn)行時(shí),并且花費(fèi)在代碼審查上的時(shí)間更少。
以上就是淺談如何提高PHP代碼的質(zhì)量的詳細(xì)內(nèi)容,更多關(guān)于如何提高PHP代碼的質(zhì)量的資料請(qǐng)關(guān)注好吧啦網(wǎng)其它相關(guān)文章!
相關(guān)文章:
1. jsp文件下載功能實(shí)現(xiàn)代碼2. phpstudy apache開(kāi)啟ssi使用詳解3. jsp實(shí)現(xiàn)登錄驗(yàn)證的過(guò)濾器4. Xml簡(jiǎn)介_(kāi)動(dòng)力節(jié)點(diǎn)Java學(xué)院整理5. 詳解瀏覽器的緩存機(jī)制6. .Net加密神器Eazfuscator.NET?2023.2?最新版使用教程7. 如何在jsp界面中插入圖片8. JSP之表單提交get和post的區(qū)別詳解及實(shí)例9. ASP動(dòng)態(tài)網(wǎng)頁(yè)制作技術(shù)經(jīng)驗(yàn)分享10. .Net Core和RabbitMQ限制循環(huán)消費(fèi)的方法
