PHP单元测试框架PHPUnit的使用

Bryan 发布于2019-07-01 12:23 / 439人阅读

摘要：以前在学习开发时有专门写过的单元测试的文章，开发学习之单元测试，今天再总结下怎么在中使用单元测试。是一个用编程语言开发的开源软件，是一个单元测试框架。单元测试框架经常会包含每个测试的报告，以及给出你已经覆盖到的代码覆盖率。

以前在学习IOS开发时有专门写过Objective-C的单元测试的文章，IOS开发学习之单元测试，今天再总结下怎么在PHP中使用单元测试。

一、前言

在这篇文章中，我们使用 composer 的依赖包管理工具进行phpunit包安装和管理，composer 官方地址 https://getcomposer.org/，按照提示进行全局安装即可，另外，我们也会使用一个非常好用的Monolog记录日志组件记录日志，方便我们查看。

在根目录下建立 coomposer.json 的配置文件,输入以下内容:

{
    "autoload": {
        "classmap": [
            "./"
        ]
    }
}

上面的意思是将根目录下的所有的类文件都加载进来，在命令行执行 composer install 后，在根目录会生成出一个vendor的文件夹，我们以后通过 composer 安装的任何第三方代码都会被生成在这里。

二、为什么要单元测试？

只要你想到输入一些东西到print语句或调试表达式中，就用测试代替它。 --Martin Fowler

PHPUnit 是一个用PHP编程语言开发的开源软件，是一个单元测试框架。PHPUnit由Sebastian Bergmann创建，源于Kent Beck的SUnit，是xUnit家族的框架之一。

单元测试是对多带带的代码对象进行测试的过程，比如对函数、类、方法进行测试。单元测试可以使用任意一段已经写好的测试代码，也可以使用一些已经存在的测试框架，比如JUnit、PHPUnit或者Cantata++，单元测试框架提供了一系列共同、有用的功能来帮助人们编写自动化的检测单元，例如检查一个实际的值是否符合我们期望的值的断言。单元测试框架经常会包含每个测试的报告，以及给出你已经覆盖到的代码覆盖率。

总之一句话，使用 phpunit 进行自动测试，会使你的代码更健壮，减少后期维护的成本，也是一种比较标准的规范，现如今流行的PHP框架都带了单元测试，如Laraval,Symfony,Yii2等，单元测试已经成了标配。

另外，单元测试用例是通过命令操控测试脚本的，而不是通过浏览器访问URL的。

三、安装PHPUnit

使用 composer 方式安装 PHPUnit，其他安装方式请看这里

composer require --dev phpunit/phpunit ^6.2

安装 Monolog 日志包,做 phpunit 测试记录日志用。

composer require monolog/monolog

安装好之后，我们可以看coomposer.json 文件已经有这两个扩展包了：

 "require": {  
     "monolog/monolog": "^1.23",
    },

 "require-dev": {
        "phpunit/phpunit": "^6.2"
    },

四、PHPUnit简单用法 1、单个文件测试

创建目录tests，新建文件 StackTest.php，编辑如下：

assertEquals(0, count($stack));

        array_push($stack, "foo");

        // 添加日志文件,如果没有安装monolog，则有关monolog的代码都可以注释掉
        $this->Log()->error("hello", $stack);

        $this->assertEquals("foo", $stack[count($stack)-1]);
        $this->assertEquals(1, count($stack));

        $this->assertEquals("foo", array_pop($stack));
        $this->assertEquals(0, count($stack));
    }

    public function Log()
    {
        // create a log channel
        $log = new Logger("Tester");
        $log->pushHandler(new StreamHandler(ROOT_PATH . "storage/logs/app.log", Logger::WARNING));
        $log->error("Error");
        return $log;
    }
}

代码解释：

StackTest为测试类

StackTest 继承于 PHPUnitFrameworkTestCase

测试方法testPushAndPop()，测试方法必须为public权限，一般以test开头，或者你也可以选择给其加注释@test来表

在测试方法内，类似于 assertEquals() 这样的断言方法用来对实际值与预期值的匹配做出断言。

命令行执行:
phpunit 命令测试文件命名

➜  framework#  ./vendor/bin/phpunit tests/StackTest.php

// 或者可以省略文件后缀名
//  ./vendor/bin/phpunit tests/StackTest

执行结果：

➜  framework# ./vendor/bin/phpunit tests/StackTest.php
PHPUnit 6.4.1 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 56 ms, Memory: 4.00MB

OK (1 test, 5 assertions)

我们可以在app.log文件中查看我们打印的日志信息。

2、类文件引入

Calculator.php

单元测试类：
CalculatorTest.php

assertEquals(0, $obj->sum(0, 0));

    }

}

命令执行：

> ./vendor/bin/phpunit tests/CalculatorTest

执行结果：

PHPUnit 6.4.1 by Sebastian Bergmann and contributors.

F                                                                   1 / 1 (100%)

Time: 117 ms, Memory: 4.00MB

There was 1 failure:

如果我们把这里的断言故意写错，$this->assertEquals(1, $obj->sum(0, 0));
看执行结果：

PHPUnit 6.4.1 by Sebastian Bergmann and contributors.

F                                                                   1 / 1 (100%)

Time: 117 ms, Memory: 4.00MB

There was 1 failure:

1) App	estsCalculatorTest::testSum
Failed asserting that 0 matches expected 1.

/Applications/XAMPP/xamppfiles/htdocs/web/framework/tests/CalculatorTest.php:22

FAILURES!
Tests: 1, Assertions: 1, Failures: 1.

会直接报出方法错误信息及行号，有助于我们快速找出bug

3、高级用法

你是否已经厌烦了在每一个测试方法命名前面加一个test，是否因为只是调用的参数不同，却要写多个测试用例而纠结？我最喜欢的高级功能，现在隆重推荐给你，叫做框架生成器。

Calculator.php

命令行启动测试用例，使用关键字 --skeleton

> ./vendor/bin/phpunit --skeleton Calculator.php

执行结果：

PHPUnit 6.4.1 by Sebastian Bergmann and contributors.

Wrote test class skeleton for Calculator to CalculatorTest.php.

是不是很简单，因为没有测试数据，所以这里加测试数据，然后重新执行上边的命令

原始类中的每个方法都进行@assert注解的检测。这些被转变为测试代码，像这样

    /**
     * Generated from @assert (0, 0) == 0.
     */
    public function testSum() {
        $obj = new Calculator;
        $this->assertEquals(0, $obj->sum(0, 0));
    }

执行结果：

 ./vendor/bin/phpunit tests/CalculatorTest
PHPUnit 6.4.1 by Sebastian Bergmann and contributors. 
  
....  
  
Time: 0 seconds  
  
  
OK (4 tests)

4、其他用法

其他用法请参考官网：PHPUnit中国官网

参考文章：
PHPUnit中国官网文档

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/30616.html

PHPUnit实践一（初识）

摘要：另外一些单元测试可能会测试负向路径的场景，保证代码不仅会产生错误，而且是预期的错误。是一个面向程序员的测试框架，这是一个的体系结构的单元测试框架。本系列教程所有的PHPUnit测试基于PHPUnit6.5.9版本，Lumen 5.5框架前置日常我们的普通用到的测试：代码直接echo，debug等方法测试 -> 跟踪细节断点型测试 log日志辅助测试 -> 跟踪细节断点型测试 ...

weapon 2019-07-01 11:17 评论0 收藏0
PHPUnit实践一（初识）

摘要：另外一些单元测试可能会测试负向路径的场景，保证代码不仅会产生错误，而且是预期的错误。是一个面向程序员的测试框架，这是一个的体系结构的单元测试框架。本系列教程所有的PHPUnit测试基于PHPUnit6.5.9版本，Lumen 5.5框架前置日常我们的普通用到的测试：代码直接echo，debug等方法测试 -> 跟踪细节断点型测试 log日志辅助测试 -> 跟踪细节断点型测试 ...

hss01248 2019-05-29 17:12 评论0 收藏0
phpunit使用

摘要：单元测试是一个为代码编写测试用例并自动运行这些测试的框架。测试驱动的开发是一种单元测试方法，其思想是应该首先编写测试程序，并验证这些测试可以发现错误，然后才开始编写需要通过这些测试的代码。 phpunit使用标签（空格分隔）： php 现在是凌晨 3 点。我们怎样才能知道自己的代码依然在工作呢？Web 应用程序是 24x7 不间断运行的，因此我的程序是否还在运行这个问题会在晚上一直...

ZweiZhao 2019-07-01 12:31 评论0 收藏0
写一个“特殊”的查询构造器 - (八、单元测试、收尾工作)

摘要：单元测试的好处是给开发人员的，并不是给机器的。对于查询构造器这个项目，我们可以让其在远程运行环境安装相关数据库软件，执行数据表建立，数据导入，执行单元测试等操作。查询构造器的完整代码查询构造器的单元测试完整代码。 debug 模式对查询构造器进行调试并不难，从其构造 SQL -> 数据绑定 -> SQL 执行的过程中就能发现，要方便调试，只要可以观察以下信息：构造的 SQL 绑定...

Steve_Wang_ 2019-07-01 10:01 评论0 收藏0
Laravel 测试： PHPUnit 入门教程

摘要：介绍是最古老和最著名的单元测试包之一。它主要用于单元测试，这意味着可以用尽可能小的组件测试代码，但是它也非常灵活，可以用于很多不仅仅是单元测试。这时，的测试助手可以使这些测试像单元测试简单组件一样容易。新的测试代码如下注意到，在我们新建的 showImg(https://segmentfault.com/img/remote/1460000018355157?w=1440&h=585)...

张宪坤 2019-07-01 12:32 评论0 收藏0