PHPUnit在Windows下的配置及使用教程

首页 > 娱乐前沿 > 热点

2015-12-02 09:15:15 | 来源：玩转帮会 | 投稿：佚名 | 编辑：小柯

原标题：PHPUnit在Windows下的配置及使用教程

由于我们项目涉及到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:repositoryCourseManagementmobile_api_test。

右键我的电脑，选择属性。点击左侧的高级系统设置。此时弹出系统属性，选择高级选项卡，点击右下角的环境变量。在用户变量里面，双击PATH，在变量值后面添加;D:repositoryCourseManagementmobile_api_test（注意最前面的分号，路径填存放phpunit.phar的路径）。配置这个是为了在任意位置都能使用PHPUnit，不配置的话，需要在phpunit.phar的路径下才能使用PHPUnit。

官方文档里有一点没有提到，就是php的环境变量也要设置。比如我的php.exe在E:softwarewampbinphpphp5.5.12里，那么也要在PATH后面添加;E:softwarewampbinphpphp5.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:repositoryCourseManagementmobile_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:repositoryCourseManagementmobile_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执行测试。

简单的测试就完成了。

三、摸索过程

一开始预告PHPUnit，得到.phar文件，以为要解压，囧。找了半天才发现有一个能够解压这种文件的网站（点此进入）。然而并没有什么用……

照着官方文档来做，运行时出现错误：

‘php’ 不是内部或外部命令，也不是可运行的程序
或批处理文件。

Google搜索，必应搜索，StackOverFlow搜索，百度搜索，搜到的答案都没有用。

主要是因为他们都默认你已经配置好了PHP环境变量……

最后想着是不是之前生成的phpunit.cmd有问题？于是查看一下这个文件的内容。突然想到是不是PHP环境变量没设置的原因？打开cmd，输入php --version。得到：

‘php’ 不是内部或外部命令，也不是可运行的程序
或批处理文件。

和上面的错误一样！果然是这里的问题。于是把;E:softwarewampbinphpphp5.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。得到：