• 【Laravel系列7.9】测试

    测试

    测试相关的内容其实也不是我的强项，毕竟日常的开发就没怎么接触过，但是不讲吧，又总感觉缺少一点什么，所以这一块也只是简单的演示一下，没办法带大家进行更加深入的学习。

    很神奇吧，工作十来年，没有经历过一个是使用过测试驱动开发的公司，甚至连单元测试在工作中都从来没写过。测试的好处自然不用多说，道听途说也了解过测试驱动开发的种种好处，也期望在后续的工作中能够应用上。在这里，也希望大家尽量能找规模大一些的，开发比较正规的公司，类似的这种开发模式或测试相关的知识也能够学习到更多。

    运行测试

    Laravel 的测试组件，主要也是依赖于 PHPUnit 单元测试组件。这个东西单独拿出来就是可以出一个系列的。之前我也大致的看过，但是就像上面说过的，并没有实际的项目经验，所以看过也就忘了。如果你对这一块有更深入的了解，那么今天的内容其实你也不用再看了。

    正因为使用的是 PHPUnit ，所以我们可以通过 PHPUnit 来执行测试，比如下面这个命令。

    vendor/bin/phpunit

    不过它的报告格式是原始的 PHPUnit 格式，在 Laravel 框架中，我们更推荐的是使用是框架自带的一个测试命令。

    php artisan test

    通过跟踪调试，我们会发现这个命令的代码是在 vendor/nunomaduro/collision/src/Adapters/Laravel/Commands/TestCommand.php 文件中，从路径就可以看出，它不是包含在默认的 vendor/laravel 目录下的。继续跟踪它的 run() 方法，找到 vendor/symfony/process/Process.php 中的 start() 方法。在这个方法中，如果你是断点调试的话，可以看到它会组合一个命令行语句，也就是 $commandline 。

    1. public function start(callable $callback = null, array $env = [])
    2. {
    3.     if ($this->isRunning()) {
    4.         throw new RuntimeException('Process is already running.');
    5.     }
    6.  
    7.     $this->resetProcessData();
    8.     $this->starttime = $this->lastOutputTime = microtime(true);
    9.     $this->callback = $this->buildCallback($callback);
    10.     $this->hasCallback = null !== $callback;
    11.     $descriptors = $this->getDescriptors();
    12.  
    13.     if ($this->env) {
    14.         $env += $this->env;
    15.     }
    16.  
    17.     $env += $this->getDefaultEnv();
    18.  
    19.     if (\is_array($commandline = $this->commandline)) {
    20.         $commandline = implode(' ', array_map([$this, 'escapeArgument'], $commandline));
    21.  
    22.         if ('\\' !== \DIRECTORY_SEPARATOR) {
    23.             // exec is mandatory to deal with sending a signal to the process
    24.             $commandline = 'exec '.$commandline;
    25.         }
    26.     } else {
    27.         $commandline = $this->replacePlaceholders($commandline, $env);
    28.     }
    29.  
    30.     if ('\\' === \DIRECTORY_SEPARATOR) {
    31.         $commandline = $this->prepareWindowsCommandLine($commandline, $env);
    32.     } elseif (!$this->useFileHandles && $this->isSigchildEnabled()) {
    33.         // last exit code is output on the fourth pipe and caught to work around --enable-sigchild
    34.         $descriptors[3] = ['pipe', 'w'];
    35.  
    36.         // See https://unix.stackexchange.com/questions/71205/background-process-pipe-input
    37.         $commandline = '{ ('.$commandline.') <&3 3<&- 3>/dev/null & } 3<&0;';
    38.         $commandline .= 'pid=$!; echo $pid >&3; wait $pid; code=$?; echo $code >&3; exit $code';
    39.  
    40.         // Workaround for the bug, when PTS functionality is enabled.
    41.         // @see : https://bugs.php.net/69442
    42.         $ptsWorkaround = fopen(__FILE__, 'r');
    43.     }
    44.  
    45.     $envPairs = [];
    46.     foreach ($env as $k => $v) {
    47.         if (false !== $v) {
    48.             $envPairs[] = $k.'='.$v;
    49.         }
    50.     }
    51.  
    52.     if (!is_dir($this->cwd)) {
    53.         throw new RuntimeException(sprintf('The provided cwd "%s" does not exist.', $this->cwd));
    54.     }
    55.  
    56.     $this->process = @proc_open($commandline, $descriptors, $this->processPipes->pipes, $this->cwd, $envPairs, $this->options);
    57.  
    58.     if (!\is_resource($this->process)) {
    59.         throw new RuntimeException('Unable to launch a new process.');
    60.     }
    61.     $this->status = self::STATUS_STARTED;
    62.  
    63.     if (isset($descriptors[3])) {
    64.         $this->fallbackStatus['pid'] = (int) fgets($this->processPipes->pipes[3]);
    65.     }
    66.  
    67.     if ($this->tty) {
    68.         return;
    69.     }
    70.  
    71.     $this->updateStatus(false);
    72.     $this->checkTimeout();
    73. }

    这个 $commandline 是什么内容呢？

    '/usr/local/Cellar/php/7.3.9_1/bin/php' 'vendor/phpunit/phpunit/phpunit' '--configuration=/Users/zhangyue/MyDoc/博客文章/LearnLaravel/learn-laravel/phpunit.xml' '--printer=NunoMaduro\Collision\Adapters\Phpunit\Printer'

    不惊喜也不意外吧？最终依然使用的是 PHPUnit 的命令行来进行自动化测试的。只不过在这里框架帮我们去调用，并且将执行结果又进行了封装后返回。

    好了，现在放开你的断点继续执行吧。Laravel 默认是带了一些测试实例的，你可以看到一些测试成功了，一些测试失败了。接下来，我们就自己定义一个测试。

    单元测试

    单元测试是用于测试某个方法的结果是否符合我们预期的。在多数情况下，对于我们开发人员来说如果是在测试开发驱动的公司，单元测试肯定是必须要写的，而且是最重要的测试内容。那么单元测试一般测什么呢？不是说随便一个方法都要进行单元测试，最需要测试的其实是核心业务逻辑相关的一些功能函数或者类方法。这些比较偏理论了，当然也要根据个人和公司的情况有所不同，我们也不深究，直接来看看如何使用框架进行单元测试。

    首先，我们需要有一个待测试的方法，你可以随便建一个新类，或者使用已有的类，我这里就使用我们之前建立过的一个 Model ，直接在里面添加一个方法。

    1. class MTest extends Model
    2. {
    3.     public static function testCulAdd($a, $b){
    4.         return $a+$b;
    5.     }
    6. }

    这里只是演示作用哦，不是说只能测试静态方法。这个方法就实现了一个简单的功能，将两个参数想加。然后我们需要建立一个测试类，你可以用下面这个命令行来实现。

    php artisan make:test CulTest --unit

    执行命令后，会在 tests/Unit 目录下生成一个 CulTest.php 文件。接下来就在这个文件中写测试。

    1. class CulTest extends TestCase
    2. {
    3.     public function test_example()
    4.     {
    5.         $this->assertEquals(3, MTest::testCulAdd(1, 2));
    6.     }
    7.  
    8.     public function test_example1()
    9.     {
    10.         $this->assertEquals(4, MTest::testCulAdd(1, 2));
    11.     }
    12. }

    我们定义了两个测试方法，注意要以 test_ 开头。两个方法我们都使用 assertEquals() 断言，这个函数是表示两个参数的结果相等的话，就返回 true ，也就是测试的方法的结果应该和我们期望的结果一致。很明显就能看出，第一个测试方法应该是可以通过的，而第二个方法则可能出现问题。那么我们就来运行一下 php artisan test 看看结果是怎样的。

    f30bc04b9936185bb6491a8f85378e8e.png


    结果符合我们的预期，整个测试实例是失败的，那是因为其中一个测试方法没有通过断言。关于单元测试和断言以及其它相关的资料，大家可以参考官方文档或者是 PHPUnit 的文档，这里就不多说了，继续再看看别的测试方式。

    HTTP测试

    HTTP 测试就是模拟请求，可以帮助我们直接实现对页面或接口的测试。是不是感觉很强大。创建 HTTP 测试也可以使用命令行。

    php artisan make:test ZyBlogTest

    是的，你没看错，和单元测试类的区别就是不用加后面那个 --unit 了。也就说，其实 Laravel 框架默认是希望我们多使用这种 HTTP 测试的。好了，我们就来简单地测试一下。

    1. class ZyBlogTest extends TestCase
    2. {
    3.     /**
    4.      * A basic feature test example.
    5.      *
    6.      * @return void
    7.      */
    8.     public function test_example()
    9.     {
    10.         $response = $this->get('/');
    11.  
    12.         $response->assertStatus(200);
    13.     }
    14.  
    15.     public function test_example2()
    16.     {
    17.         $response = $this->post('/test/post');
    18.  
    19.         $response->assertStatus(200);
    20.         $response->dump();
    21.  
    22.     }
    23.  
    24.     public function test_example3()
    25.     {
    26.         $response = $this->postJson('/test/post/json');
    27.  
    28.         $response->assertStatus(200)->assertJson(['a'=>1]);
    29.     }
    30.  
    31.     public function test_example4()
    32.     {
    33.         $view = $this->view('test.test', ['message'=>'ZyBlog']);
    34.         $view->assertSee("ZyBlog");
    35.     }
    36. }

    第一个测试直接测试的首页，我们断言只要返回 200 就可以了。这里直接使用 get() 方法就可以完成 get 请求。第二个测试是一个简单的 post 测试，我们通过 dump() 打印出了 post 输出的内容。当然，你也可以使用断言来判断测试内容是否符合我们的要求，比如第三个测试，我们测试 json 接口返回的数据是否符合要求。在这里，还展示出了链式调用的效果。

    最后一个页面相关的测试就比较好玩，你只需要建立一个下面这样的页面。

    1. // resources/views/test/test.blade.php
    2. <!DOCTYPE html>
    3. <html lang="en">
    4. <head>
    5.     <meta charset="UTF-8">
    6.     <title>Title</title>
    7. </head>
    8. <body>
    9. {{$message}}
    10. </body>
    11. </html>

    不需要路由，不需要控制器，直接就可以测试了。测试的结果如图所示。

    809e1fddf5490eb019217e9b2ad48485.png


    测试命令行脚本

    命令行测试就是测试我们的命令行脚本功能是否正常。在测试前，我们要先准备两个命令行脚本。简单起见，直接使用路由命令行，也就是在 routes/console.php 中直接定义两个命令行脚本。这个东西之前没有说过，不过这里演示一下大家也就能明白是干什么用的了。

    1. // routes/console.php
    2. Artisan::command('testconsole', function () {
    3.     $this->line("Hello ZyBlog");
    4. });
    5.  
    6. Artisan::command('question', function () {
    7.     $food = $this->choice('选择午饭', [
    8.         '面条',
    9.         '盖饭',
    10.         '火锅',
    11.     ]);
    12.  
    13.     $this->line('你的选择是：'.$food);
    14. });

    第一个命令行，直接输出一段文字。第二个则是交互式命令行，会提示让你选择午饭，然后返回你选择的内容。你可以直接运行 php artisan testconsole 或者 php artisan question 看看效果。

    然后，我们就来写针对这两个命令行的测试脚本，你可以继续写在 ZyBlogTest 中。

    1. public function test_console1(){
    2.     $this->artisan('testconsole')->expectsOutput("Hello ZyBlog")->assertExitCode(0);
    3. }
    4.  
    5. public function test_console2(){
    6.     $this->artisan('question')
    7.         ->expectsQuestion("选择午饭", "面条")
    8.         ->expectsOutput("你的选择是：面条")
    9.         ->doesntExpectOutput("你的选择是：盖饭")
    10.         ->assertExitCode(0);
    11. }

    第一条测试的断言很简单，期望输出是我们给定的字符串，然后命令行退出码是 0 就可以了。因为我们没有做别的设置，所以命令行正常退出的退出码都会是 0 。

    第二个测试的断言就比较复杂了。我们可以使用 expectsQuestion() 方法模拟选择输入的内容，然后还是 expectsOutput() 断言期望的输出结果，另外还使用了一个 doesntExpectOutput() 也就是不期望输出的结果，通过一系列的组合断言来决定这个测试用例的通过情况。

    这个测试结果我就不截图了，很明显是正常通过的。大家可以自己修改断言或者输出来进行更复杂的测试。

    总结

    通过今天的学习，我们了解到 Laravel 的测试组件其实比我们相像中的要简单易用一些。毕竟它帮我们进行了封装，大家只需要去建立测试类然后写测试用例方法就可以了。同时希望我也能够和你们一起在实际的项目工作中用起来。有的时候并不是公司不需要我们就完全不去管了，这种好东西应该是用于约束自己的，即使公司没要求，我们也可以在自己的代码中加入这些测试来提高代码质量，这也是我需要反省的地方。话不多说，大家用起来吧。

    参考文档：

    https://learnku.com/docs/laravel/8.5/testing/10415

  • 相关阅读:
    JAVA高级教程Java TreeMap表达式(8)
    微服务实战系列之Token
    新品发布 | Cloudpods 3.9.1 版本上线
    一篇必读的物联网平台物模型开发指南，为你解锁未来科技趋势
    开发者测评：阿里云 ACR 与其他的镜像仓库到底有什么不同？
    吴恩达—机器学习的六个核心算法
    Open3D ICP精配准（点到面）
    RabbitMQ——02
    flask——介绍、安装、快速使用、配置文件、路由系统、视图
    C. Rooks Defenders - 树状数组
  • 原文地址：https://blog.csdn.net/zhangyue0503/article/details/125437846