由于我们项目涉及到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":"[email protected]"}'; $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
执行测试。
简单的测试就完成了。