由於我們項目涉及到php，因此需要對php代碼進行單元測試。經過一番了解，決定用PHPUnit來測試php。PHPUnit花了不少時間摸索如何配置PHPUnit，看官網的文檔也是一把淚。但知道怎么配置后，其實還是很簡單的。
系統：Windows 10 專業版
PHP版本：PHP 5.5.12
服務器工具：WAMPSERVER 2.5
PHPUnit版本：PHPUnit 4.8
一、配置PHPUnit
-
首先到PHPUnit官網（點此進入）下載相應的版本。我們使用的是php 5.5，於是選擇PHPUnit 4.8。得到
.phar文件，並把名字改為phpunit.phar。 -
把該文件放到任意位置。以我自己為例，我把它放到我們項目的目錄下，即
D:\repository\CourseManagement\mobile_api_test。 -
右鍵 我的電腦 ，選擇 屬性 。點擊左側的 高級系統設置 。此時彈出 系統屬性 ，選擇 高級 選項卡，點擊右下角的 環境變量 。 在用戶變量里面，雙擊 PATH ，在 變量值 后面添加
;D:\repository\CourseManagement\mobile_api_test（注意最前面的分號，路徑填存放phpunit.phar的路徑）。配置這個是為了在任意位置都能使用PHPUnit，不配置的話，需要在phpunit.phar的路徑下才能使用PHPUnit。
官方文檔里有一點沒有提到，就是php的環境變量也要設置。比如我的
php.exe在E:\software\wamp\bin\php\php5.5.12里，那么也要在 PATH 后面添加;E:\software\wamp\bin\php\php5.5.12。PS：可能是因為我沒有安裝PHP的IDE，所以一直沒有配置它，偶然之間才想到可能要添加這個環境變量。
- 按快捷鍵
Win + R，輸入cmd並回車。進入存放phpunit.phar的路徑。輸入echo @php "%~dp0phpunit.phar" %* > phpunit.cmd並回車。接着輸入phpunit --version並回車。如果得到輸出PHPUnit x.y.z by Sebastian Bergmann and contributors.則表示配置好了（如果有誤，輸入exit並回車，重新來一遍）。如下圖：
二、使用PHPUnit進行測試
-
使用PHPUnit，必須使用 類 。以login.php為例（位置在
D:\repository\CourseManagement\mobile_api），我們的初始版本是這樣的（歡迎吐槽本博客內的代碼）：<?php error_reporting(0); $workNumber = $_POST["login-user"]; $password = $_POST["login-password"]; $tableName = $_POST["ident"]; $con = mysqli_connect("localhost", "root", "", "teacher_class_system"); if (!$con) { die('Could not connect: ' . mysql_error()); } else { mysqli_query($con, "SET NAMES utf8"); $result = mysqli_query($con, "SELECT * FROM $tableName where workNumber = $workNumber and password = $password"); if (mysqli_num_rows($result) < 1) { echo "false"; } else { $result_arr = mysqli_fetch_assoc($result); echo json_encode($result_arr, JSON_UNESCAPED_UNICODE); } } ?>這樣沒法測試，於是進行一翻修改。首先在
login.php所在文件夾里建立一個文件夾classes，並在里面新建class_login.php，內容為login.php修改后的版本：<?php class Login { // 測試工具PHPUnit要求一定要在這里給變量默認值，於是默認為空。 public function login($workNumber = "",$password = "",$tableName = "") { $con = mysqli_connect("localhost", "root", "", "teacher_class_system"); if (!$con) { die('Could not connect: ' . mysqli_error()); } else { mysqli_query($con, "SET NAMES utf8"); $result = mysqli_query($con, "SELECT * FROM $tableName where workNumber = $workNumber and password = $password"); if (!$result || mysqli_num_rows($result) == 0) { return "false"; } else { $result_arr = mysqli_fetch_assoc($result); return json_encode($result_arr, JSON_UNESCAPED_UNICODE); } } } } ?>除此之外，也要修改原來那個
login.php的內容，修改后如下：<?php error_reporting(0); require_once './classes/class_login.php'; $workNumber = $_POST["login-user"]; $password = $_POST["login-password"]; $tableName = $_POST["ident"]; $log = new Login; $response = $log->login($workNumber,$password,$tableName); if($response != "false") { session_start(); $_SESSION['id']=$tableName; } echo $response; ?> -
開始寫測試文件
我把測試文件放在
D:\repository\CourseManagement\mobile_api_test這個文件夾內。新建一個文件 `login_test.php' ，並寫入以下代碼：<?php require_once dirname(__FILE__).'/../mobile_api/classes/class_login.php'; class LoginTest extends PHPUnit_Framework_TestCase { public function testLoginSuccess() { $expected = '{"workNumber":"00001","password":"00001","name":"西瓜","sex":"男","birthday":"20151201","department":"計算機","telephone":"110","email":"git@github.com"}'; $workNumber = '00001'; $password = '00001'; $tableName = 'user_teacher'; $lg = new Login; $actual = $lg->login($workNumber,$password,$tableName); $this->assertEquals($expected,$actual); } function testLoginFail() { $expected = 'false'; $workNumber = '11111'; $password = '11111'; $tableName = 'user_teacher'; $lg = new Login; $actual = $lg->login($workNumber,$password,$tableName); $this->assertEquals($expected,$actual); } } ?> -
執行測試文件
快捷鍵 Win + R ，輸入cmd並回車。進入該測試文件的目錄，輸入
phpunit login_test.php執行測試。
簡單的測試就完成了。
三、摸索過程
-
一開始下載PHPUnit，得到
.phar文件，以為要解壓，囧。找了半天才發現有一個能夠解壓這種文件的網站（點此進入）。然而並沒有什么用…… -
照着官方文檔來做，運行時出現錯誤：
'php' 不是內部或外部命令，也不是可運行的程序
或批處理文件。 -
Google搜索，必應搜索，StackOverFlow搜索，百度搜索，搜到的答案都沒有用。
主要是因為他們都默認你已經配置好了PHP環境變量……
-
最后想着是不是之前生成的
phpunit.cmd有問題？於是查看一下這個文件的內容。突然想到是不是PHP環境變量沒設置的原因？打開cmd，輸入php --version。得到：'php' 不是內部或外部命令，也不是可運行的程序
或批處理文件。和上面的錯誤一樣！果然是這里的問題。於是把
;E:\software\wamp\bin\php\php5.5.12添加到環境變量中。再運行php --version得到：PHP 5.5.12 (cli) (built: Apr 30 2014 11:20:58)
Copyright (c) 1997-2014 The PHP Group
Zend Engine v2.5.0, Copyright (c) 1998-2014 Zend Technologies
with Xdebug v2.2.5, Copyright (c) 2002-2014, by Derick Rethans再進入
phpunit.cmd所在文件夾，運行phpunit --version。得到：PHPUnit 4.8.18 by Sebastian Bergmann and contributors.
問題解決！
-
經過這次的探索，以后碰到"找不到xxx"這種問題的時候，首先會想起環境變量的設置。
比如解決這個問題的同一天下午，我想使用Visual Studio Code的Git功能，但是卻得到提示：
第一個反應是：我明明安裝了msysgit啊。
第二個反應是：會不會是環境變量沒配置？打開環境變量配置，果然沒有。於是將git.exe所在文件夾的路徑添加進去。重啟Visual Studio Code，問題解決！