Win7下,使用 Laravel 框架的 phpunit测试 (通常说做testcase)—— 安装和编写测试用例

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/qq_41249766/article/details/83989503


在这里插入图片描述

如果你想要测试一个方法内部逻辑是否正确,那么就写一个测试用例测试一下,给它一个值,看看输出的结果是否和我们预期的一样。

简介

Laravel 植根于测试,实际上,内置使 PHPUnit 对测试提供支持是开箱即用的,并且 phpunit.xml 文件已经为应用设置好了。框架还提供了方便的辅助方法允许你对应用进行优雅的测试。

默认情况下,tests 目录包含了两个子目录:FeatureUnit,分别用于功能测试和单元测试,单元测试专注于小的、相互隔离的代码,实际上,大部分单元测试可能都是聚焦于单个方法。功能测试可用于测试较大区块的代码,包括若干组件之前的交互,甚至一个完整的HTTP请求。

Feature 和 Unit 测试目录下都提供了ExampleTest.php 文件,安装完新的 Laravel 应用后,只需在项目根目录下简单运行 phpunit命令 即可自动运行项目的所有测试(如果提示找不到命令,得重新安装phpunit,见第二步)。

注:PHPUnit 是一个面向程序员的、功能强大的 PHP 单元测试框架,如果你之前没接触过 PHPUnit,可以通过官网中文文档快速入门。

一、什么是测试?测试的重要性?

我们在写代码的时候,通常就需要验证程序的执行是不是符合预期,所以我们需要做testcase;

下面是一个活动报名的系统:
在这里插入图片描述

可以看到这个系统有「限制活动的报名人数20人」的设定,要测试这个设定是否符合我们的预期(20人内能成功报名,超过20人将不能报名),要怎么做呢?

最容易想到就是手动或人工测试:让 20 个以上的使用者来报名活动,如果没超过限制的人数,使用者就能继续报名,反之,超过了限制人数的话,使用者就无法继续报名了!

手动或人工测试测试会有什么问题:

1.测试案例一多,会花太多时间
如果把人数限制从20改为30, 或者 再增加一个报名截止日期的测试案例,这样可能要再重新做一次测试。
2.改了代码之后,需要再做一次测试
日常维护时,会需要再次修改代码,要验证修改后的代码没问题,肯定又要从头做一次测试。
3.与其他程序混在一起测试

所以,我们需要一个可以自动化、重复的、独立的测试,即使用phpunit,在这里我使用laravel框架下自带的phpunit,没有用laravel框架的也可以独立安装phpunit。

二、Laravel下重新安装配置phpunit

我是win7系统,安装了composer和laravel框架,laravel框架目录是D:\wamp64\www\question_bank\,question_bank是我的laravel项目名,虽然框架下的D:\wamp64\www\question_bank\verdor\bin有phpunit文件,但是不能使用,直接在项目中输入phpunit命令会有以下提示:

Yliku@USER-20181020VX MINGW64 /d/wamp64/www/question_bank (master)
$ phpunit
bash: phpunit: command not found

所以得在项目中引入phpunit组件:

1、进入终端,cd进入laravel项目,删除vendor文件夹,然后重新更新composer:
Yliku@USER-20181020VX MINGW64 /d/wamp64/www/question_bank (master)
$ composer update
2、输入以下命令引入phpunit:
Yliku@USER-20181020VX MINGW64 /d/wamp64/www/question_bank (master)
$ composer global require phpunit/phpunit

composer global remove phpunit/phpunit 删除phpunit命令

成功引入以后,phpunit组件将会存在于vendor/phpunit/phpunit下,phpunit命令存放在项目的 vendor/bin 目录下。

3、配置环境变量:

桌面-我的电脑-右键属性-高级系统设置-高级-环境变量-系统变量-选择 系统变量 里面的 path,点击编辑,将phpunit的存放路径 D:\wamp64\www\question_bank\vendor\bin;
添加进去,注意最后一定要加分号!
执行以下命令 phpunit -v 或者 phpunit --version,出现以下提示即安装成功。

Yliku@USER-20181020VX MINGW64 /d/wamp64/www/question_bank (master)
$ phpunit -v
PHPUnit 7.4.3 by Sebastian Bergmann and contributors.
4、phpunit其他报错:
Yliku@USER-20181020VX MINGW64 /d/wamp64/www/study/laravel (master)
$ phpunit

Fatal error: Uncaught TypeError: Argument 1 passed to PHPUnit\Runner\BaseTestRunner::getTest() must be of the type string, object given, called in D:\.......

这个错误是laravel版本问题造成,应该是phpunit和laravel版本有冲突,输入 php artisan --version查看项目下的laravel版本;
laravel --version 命令是啥?????)
接下来应该只能更新laravel的版本了吧。。。

三、创建测试案例

// 该命令会在 /tests/Feature/下生成一个Usertest.php文件,也叫创建Feature测试类...
php artisan make:test UserTest

// 该命令会在 /tests/Unit/下生成一个Usertest.php文件,也叫创建Unit测试类...
php artisan make:test UserTest --unit

四、使用PHPUnit实现简单测试

cd进入laravel框架项目,

  • ①输入:phpunit,自动运行项目下的所有测试案例:
Yliku@USER-20181020VX MINGW64 /d/wamp64/www/question_bank (master)
$ phpunit
PHPUnit 7.4.3 by Sebastian Bergmann and contributors.

EE............................................................... 65 / 68 ( 95%)
..E                                                               68 / 68 (100%)
Time: 1.8 seconds, Memory: 18.00MB
There were 3 errors:

上面的意思是:我的项目总共有68个测试案例,只有65个测试成功,总共花了时间1.8秒和内存18M,E代表ERROR·代表测试成功,参考下表:

. 成功时输出
F 运行过程中一个断言失败时输出
E 运行过程中产生一个错误时输出
R 被标记为有风险时输出
S 被跳过时输出
I 被标记为不完整或未实现时输出

  • ②输入:phpunit tests/feature/ExampleTest.php ,单独运行命为ExampleTest.php下的所有Test方法,一个方法代表一个测试案例:
Yliku@USER-20181020VX MINGW64 /d/wamp64/www/question_bank (master)
$ phpunit tests/Feature/ExampleTest.php
PHPUnit 7.4.3 by Sebastian Bergmann and contributors.

....                                                                4 / 4 (100%)
Time: 333 ms, Memory: 12.00MB
OK (4 tests, 8 assertions)

我的tests/feature/ExampleTest.php文件内容如下:

<?php

namespace Tests\Feature;
//此处命名空间的声明删除也没影响???
//所有测试类文件的命名必须为*Test.php;
//laravel项目自带phpunit,所有的测试类在根目录tests/ 下存放

//这句是必要的!!所有测试类必须继承Tests\TestCase,因为要使用该TestCase类的方法
use Tests\TestCase;

//以下两句use删除也没影响???
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;

class ExampleTest extends TestCase
{
    /** 简单测试示例 * @return void */
    //测试类文件中的所有方法/函数必须为公开的public,命名格式:public function test*(){}
    //当然可以在你的测试用例中包含private的方法,但它们不能被phpunit所调用
    public function testBasicTest()
    {
        $this->assertTrue(3>2);    //断言括号内的内容为真,是的话则该方法测试成功 
    }
    public function testExample1()
    {
        $this->assertFalse(3<2);   //断言括号内的内容为假,是的话则该方法测试成功 
    }    
    public function testExample2()
    {
        $this->assertFalse(false);  //断言括号内的内容为假,是的话则该方法测试成功 
    }
    //class里面总共写了四个方法,代表了四个测试~~~~~~~~~~~
    public function testExample3()
    {
        $stack = [];    //新建数组$stack,给它一个数组,看看输出的结果是否和我们预期的一致,判断是否一致就要开始断言了~~
        $this->assertEquals(0, count($stack));  //count()提取数组的长度,断言0和数组的长度相等,相等的话测试成功
        array_push($stack, 'foo');              //array_push向数组尾部插入元素'foo'
        $this->assertEquals('foo', $stack[count($stack) - 1]);
        $this->assertEquals(1, count($stack));
        $this->assertEquals('foo', array_pop($stack)); //array_pop()删除数组的最后一个元素,返回值是被删除的元素
        $this->assertEquals(0,count($stack) );  //判断括号内右边的值是否和左边的一致,左边的值是我们的预期输出
    }
}

五、常用的PHPunit断言方法

assertEquals() 判断是否相等
assertContains()判断输入是否包含指定的值
assertInstanceOf()
assertTrue/assertFalse 断言是否为真值还是假
assertEquals 判断输出是否和预期的相等
assertGreaterThan 断言结果是否大于某个值,同样的也有LessThan 小于
GreaterThanOrEqual 大于等于
LessThanOrEqual 小于等于
assertType 判断是否属于指定类型
assertNull 判断是否为空值
assertFileExists 判断文件是否存在
assertRegExp 根据正则表达式判断

六、phpunit相关文件说明

  • phpunit.xml为phpunit的核心配置文件,在laravel项目根目录下,其中:
    • testsuites中定义了测试文件存放路径为根目录下tests文件下的FeatureUnit目录。
    • filter中定义了需要进行单元测试的PHP文件存放位置。
    • php中配置了测试环境的环境变量,默认APP_ENV为testing
    • 缓存驱动设置为array
    • Session驱动设置为array
    • 队列驱动设置为sync
  • Laravel的 phpunit 默认有两个文件夹 FeatureUnit
    • FeatureUnit下都提供了ExampleTest.php文件;
    • FeatureUnit分别用于功能测试单元测试
    • 功能测试可用于测试较大区块的代码,包括若干组件之前的交互,甚至一个完整的HTTP请求。
    • 单元测试专注于小的、相互隔离的代码,实际上,大部分单元测试可能都是聚焦于单个方法。

运行测试的时候,Laravel 会自动设置环境为 testing,这是因为 phpunit.xml中定义了环境变量。Laravel 在测试时还会自动配置 Session 和缓存驱动为 array,这意味着测试时不会持久化存储会话和缓存。
如果需要的话,你也可以定义其它测试环境配置值。testing 环境变量可以在 phpunit.xml 文件中配置,但是要确保在运行命令之前使用 Artisan 命令 config:clear 清除配置缓存。
此外,你还可以在项目根目录下创建一个 .env.testing 文件,该文件会在运行 PHPUnit 测试或执行带 --env=testing 开关的 Artisan 命令时覆盖 .env 文件中的环境变量。

没有更多推荐了,返回首页