Web端PHP代碼函數覆蓋率測試解決方案，php覆蓋率_PHP教程

Web端PHP代碼函數覆蓋率測試解決方案，php覆蓋率

1. 關於程式碼涵蓋範圍

衡量程式碼涵蓋範圍有很多種層次，比如行覆蓋率，函數/方法覆蓋率，類覆蓋率，分支覆蓋率等等。程式碼涵蓋範圍也是衡量測試品質的一個重要標準，對於黑箱測試來說，如果你不確定自己的測試案例是否真正跑過了系統裡面的每一行代碼，在測試的完整性上總要打些折扣。因此，業界幾乎對各種程式設計語言都有自己的一套程式碼涵蓋範圍解決方案。世界上最美的語言PHP當然也不例外。PHPUnit和Spike PHPCoverage提供了一套基於xdebug的程式碼涵蓋範圍測試方案。在本文中，我將針對自己碰到的特定業務情境，講述一下自己進行PHP代碼函數覆蓋率測試的解決方案。

2. 業務背景

假設我們線上開發了一個網站，交給業務測試的同事去進行功能測試。那他們是怎麼測試的呢？通常情況下，無非是開發人員把網站部署好了，然後測試人員把網上所有功能都試用一遍，包括一些異常使用方式。對於業務測試來說，只要我把所有的功能點都測了，把所有異常使用方式也測到了，那就完成了。但是對於開發來說，我比較好奇的是，你是否把我寫的所有代碼都跑到了？會不會存在一些代碼，只有在很特殊的情況下才能觸發，而你從來沒有測到過這些情況？這時，可能就需要程式碼涵蓋範圍來出馬了。

其實我首先想到了xdebug來測試覆蓋率，只需要兩三個函數即可，如下：

xdebug_start_code_coverage(); //開始收集程式碼覆蓋情況xdebug_get_code_coverage(); //擷取截至目前所跑過的代碼檔案名稱和行號xdebug_stop_code_coverage(); //停止收集程式碼覆蓋情況

xdebug提供的介面可以用於測試行覆蓋率，這是否能滿足要求呢？其實，行覆蓋率顆粒度有點細，實際項目中，開發人員可能會對代碼進行微調。比如，這次測試，你跑過了A.php檔案的第10行，但是我有一天對A.php進行了微調，在A.php第9行和第10行之間又加了兩行代碼。於是，原來的第10行變為了第12行，而xdebug的行覆蓋資訊只記錄了行號……這樣之前的資料豈不是不準確了麼。。。考慮再三，我覺得函數覆蓋是個不錯的顆粒度。在相對成熟的項目中，很少有大規模函數變動的情況。不過問題是，xdebug並沒有提供函數覆蓋的介面。

於是，我們現在碰到的情境是：

【1】希望測到某次測試中所覆蓋的所有函數列表，知道這個項目總共有多少個函數，計算一下覆蓋率是否足夠高。

【2】測試完成之後，要產生一份覆蓋率報告，將代碼的覆蓋情況可視化。

【3】完整測試的流程如下：

其中插樁的意思是在測試執行之前的一些準備工作。

3. 函數覆蓋率解決方案

（1）原理

xdebug天生提供了對行覆蓋率的支援，我們要自己計算出函數覆蓋率。函數覆蓋率需要兩點資料，一個是哪些函數被執行，一個是檔案中總共有多少個函數。

檔案中總共的函數量，由於我們不可能把所有函數都執行一遍，因此這部分只能通過代碼靜態掃描來實現。如果是在C++或者Java中，可能就需要詞法分析工具了，然而在最美的語言PHP面前，我們完全不需要那麼複雜。從PHP4.3開始，PHP Zend Engine中內建了tokenizer功能，協助開發人員做源碼詞法分析。我們只需要找到PHP中定義函數時所對應的詞法規律，就可以輕鬆得到指定PHP檔案中的全部函數了。

tokenizer定義的介面也十分簡單：

array token_get_all (string $source)

該函數進行檔案解析，將php原始碼拆成由token組成的數組。

string token_name (int $token)

將整數形式的token轉變為字串形式。類似於C語言中的strerror函數。有了tokenizer，自己再根據php函數定義的規律和格式設計一個有限狀態機器，即可完成全量函數的解析。這部分代碼，本人寫了個比較簡陋的，把它單獨拿出來，僅供大家參考：PHPFunctionParser

求函數覆蓋率的另外一個痛點在於擷取被執行的函數列表。這地方讓我們走了一些彎路。一開始一個最簡單的辦法，我們既然通過xdebug拿到被執的行，可以通過行號來反推此行屬於哪一個函數。然而每一次的請求擷取的行號資訊量是非常大的，如果一個求情執行了1000行，那就要進行1000次判斷，效率上會比較差。調研了一番之後，發現xdebug提供了function trace的功能，可以把一次請求中的函數調用關係擷取到，只不過拿到了函數名字，卻沒辦法得到它所在的檔案。於是，再次調研一番，發現了Reflection，給定方法名和類名，可以反推出來它在哪個檔案中定義。於是我們使用function trace把函數調用關係暫存在一個臨時檔案中，然後通過檔案解析，拿到執行的函數名（如果是類方法，則是“類名::函數名”的形式），再通過reflection機制反推出定義這個函數的檔案即可。再次體會到了世界上最美語言的強大之處。

（2）插樁

為了降低使用門檻，我們儘可能少地改變PHP原始碼為好。xdebug收集資訊的原理是分別調用xdebug_start_code_coverage和xdebug_stop_code_coverage來控制覆蓋率資訊收集的開始和結束，因此不可避免地要改變原始碼。此處我們的解決辦法是，將xdebug_stop_code_coverage通過register_shutdown_function註冊為php程式結束前必須要跑的一段程式（類似C語言的atexit函數），將其封裝到一個檔案中，然後在原始碼第一行require這個檔案即可。如果你的PHP架構是CodeIgniter這種所有請求都有一個統一入口index.php的架構，那就只需要改變這一個檔案即可，對原始碼只有一行的改動！實際上，目前基本上所有的PHP架構，都是以一個index.php檔案作為所有請求的入口。

我們對原始碼的改動只有入口檔案index.php的第一行加入了一句話：

require_once "/file/path/to/phpcoverage.php"; ?>

而phpcoverage.php核心代碼邏輯大致如下：

php ……function xdebugPhpcoverageBeforeShutdown(){ …… $lineCovData = xdebug_get_code_coverage(); xdebug_stop_code_coverage(); …… xdebug_stop_trace(); ……}register_shutdown_function(‘xdebugPhpcoverageBeforeShutdown’);……xdebug_start_trace(……);xdebug_start_code_coverage();
//備忘：上面省略符號表示非關鍵代碼，這裡就不展示了

（3）資訊儲存

我們的函數覆蓋率測試有了思路，使用xdebug的function trace擷取一次請求中所有函數的調用關係，得到執行過的所有函數，輸出到檔案中，通過檔案解析和reflection獲得被執行的函數名和該函數所在檔案。將這些資訊存入資料庫或檔案即可。

之前試用Spike的時候，我們發現這些資訊以xml格式存入檔案，資料冗餘度很高，導致幾個測試下來，檔案已經非常大了。這顯然不是我們想看到的。因此在資料存放區的時候，我們直接將資料做json格式的序列化，字串形式存在檔案中，大大減少了檔案大小。與此同時，我們再通過請求來源的IP和日期作為分隔，分別儲存不同的檔案。這樣，來自每個機器每天的請求資料都能一目瞭然，向著“精準”的方向又邁進了一步，可以對測試人員的每個請求做精確的監控。是我們在業務實踐中搜集的部分資料檔案：

這樣，來自任何一個IP的每一次Web請求，它所覆蓋的行和函數資訊，都會被記錄到檔案中。對於一般的項目測試中，也就只有幾個測試人員在使用，所以不需要考慮一些效能問題。

4. 報告產生

上面講了產生覆蓋率資料的原理，不過我們至此獲得的只是一份份的資料檔案，如何匯總成一份完整的報告呢？這就需要我們自己來寫一段指令碼解析剛才產生的資料檔案了。我們的做法是借鑒了開源工具spike phpcoverage的模版，並加入自己的代碼邏輯，特別是加入了該工具所不具有的函數覆蓋率統計資料。我們自己測試的web頁面產生的報告如下：

圖中可以看到每個檔案的行覆蓋率，函數覆蓋率，還有總的覆蓋率統計資料。如果需要更精確的資料，可以點進檔案串連，查看到底覆蓋的是哪些程式碼（藍色為覆蓋，紅色為未覆蓋）：

5. 總結

業務測試中做Web測試時，對代碼的覆蓋率是衡量測試品質的重要指標。我們希望通過此方法做到盡量地“精準”，測試執行完後可以精確看到哪一行代碼被執行過，哪一行沒被執行過。分析沒被執行過的原因，從而改進測試案例。使用工具的流程也很簡單，插樁=>測試=>搜集資料=>出報告。並且此解決方案最大化地減少了對業務代碼的影響，只需要改一行代碼即可。即便中間出現了問題，也可以快速將代碼恢複為原來的樣子。讓測試放心，讓開發也放心。

不過，最後還需要強調的一點是，並不是說覆蓋了所有的代碼，就證明測試已經完整了。只不過沒被覆蓋的話，一定是不完整的。所以這個方案最大的意義在於能夠發現測試中一些遺漏的代碼，找到一部分問題。其實，它也可以協助新來的員工理解整個項目代碼結構，我們可以清晰的知道，自己的每一次瀏覽器請求，到底在運行伺服器上的哪些代碼。

http://www.bkjia.com/PHPjc/1068247.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/1068247.htmlTechArticleWeb端PHP代碼函數覆蓋率測試解決方案，php覆蓋率 1. 關於程式碼涵蓋範圍 衡量程式碼涵蓋範圍有很多種層次，比如行覆蓋率，函數/方法覆蓋率，類覆...

