跳到内容

控制台测试

简介

除了简化 HTTP 测试之外,Laravel 还提供了一个简单的 API,用于测试应用程序的自定义控制台命令

成功/失败预期

要开始使用,让我们探索如何对 Artisan 命令的退出代码进行断言。为了实现这一点,我们将使用 artisan 方法从我们的测试中调用 Artisan 命令。然后,我们将使用 assertExitCode 方法来断言命令以给定的退出代码完成

1test('console command', function () {
2 $this->artisan('inspire')->assertExitCode(0);
3});
1/**
2 * Test a console command.
3 */
4public function test_console_command(): void
5{
6 $this->artisan('inspire')->assertExitCode(0);
7}

您可以使用 assertNotExitCode 方法来断言命令没有以给定的退出代码退出

1$this->artisan('inspire')->assertNotExitCode(1);

当然,所有终端命令通常在成功时以状态代码 0 退出,而在不成功时以非零退出代码退出。因此,为了方便起见,您可以利用 assertSuccessfulassertFailed 断言来断言给定的命令是否以成功的退出代码退出

1$this->artisan('inspire')->assertSuccessful();
2 
3$this->artisan('inspire')->assertFailed();

输入/输出预期

Laravel 允许您使用 expectsQuestion 方法轻松“模拟”控制台命令的用户输入。此外,您可以使用 assertExitCodeexpectsOutput 方法指定您期望控制台命令输出的退出代码和文本。例如,考虑以下控制台命令

1Artisan::command('question', function () {
2 $name = $this->ask('What is your name?');
3 
4 $language = $this->choice('Which language do you prefer?', [
5 'PHP',
6 'Ruby',
7 'Python',
8 ]);
9 
10 $this->line('Your name is '.$name.' and you prefer '.$language.'.');
11});

您可以使用以下测试来测试此命令

1test('console command', function () {
2 $this->artisan('question')
3 ->expectsQuestion('What is your name?', 'Taylor Otwell')
4 ->expectsQuestion('Which language do you prefer?', 'PHP')
5 ->expectsOutput('Your name is Taylor Otwell and you prefer PHP.')
6 ->doesntExpectOutput('Your name is Taylor Otwell and you prefer Ruby.')
7 ->assertExitCode(0);
8});
1/**
2 * Test a console command.
3 */
4public function test_console_command(): void
5{
6 $this->artisan('question')
7 ->expectsQuestion('What is your name?', 'Taylor Otwell')
8 ->expectsQuestion('Which language do you prefer?', 'PHP')
9 ->expectsOutput('Your name is Taylor Otwell and you prefer PHP.')
10 ->doesntExpectOutput('Your name is Taylor Otwell and you prefer Ruby.')
11 ->assertExitCode(0);
12}

如果您正在使用 Laravel Prompts 提供的 searchmultisearch 函数,您可以使用 expectsSearch 断言来模拟用户的输入、搜索结果和选择

1test('console command', function () {
2 $this->artisan('example')
3 ->expectsSearch('What is your name?', search: 'Tay', answers: [
4 'Taylor Otwell',
5 'Taylor Swift',
6 'Darian Taylor'
7 ], answer: 'Taylor Otwell')
8 ->assertExitCode(0);
9});
1/**
2 * Test a console command.
3 */
4public function test_console_command(): void
5{
6 $this->artisan('example')
7 ->expectsSearch('What is your name?', search: 'Tay', answers: [
8 'Taylor Otwell',
9 'Taylor Swift',
10 'Darian Taylor'
11 ], answer: 'Taylor Otwell')
12 ->assertExitCode(0);
13}

您还可以使用 doesntExpectOutput 方法断言控制台命令不生成任何输出

1test('console command', function () {
2 $this->artisan('example')
3 ->doesntExpectOutput()
4 ->assertExitCode(0);
5});
1/**
2 * Test a console command.
3 */
4public function test_console_command(): void
5{
6 $this->artisan('example')
7 ->doesntExpectOutput()
8 ->assertExitCode(0);
9}

expectsOutputToContaindoesntExpectOutputToContain 方法可用于对输出的一部分进行断言

1test('console command', function () {
2 $this->artisan('example')
3 ->expectsOutputToContain('Taylor')
4 ->assertExitCode(0);
5});
1/**
2 * Test a console command.
3 */
4public function test_console_command(): void
5{
6 $this->artisan('example')
7 ->expectsOutputToContain('Taylor')
8 ->assertExitCode(0);
9}

确认预期

当编写需要以“是”或“否”答案形式进行确认的命令时,您可以使用 expectsConfirmation 方法

1$this->artisan('module:import')
2 ->expectsConfirmation('Do you really wish to run this command?', 'no')
3 ->assertExitCode(1);

表格预期

如果您的命令使用 Artisan 的 table 方法显示信息表,则为整个表编写输出预期可能很麻烦。相反,您可以使用 expectsTable 方法。此方法接受表格的标题作为其第一个参数,表格的数据作为其第二个参数

1$this->artisan('users:all')
2 ->expectsTable([
3 'ID',
4 'Email',
5 ], [
8 ]);

控制台事件

默认情况下,在运行应用程序的测试时,不会调度 Illuminate\Console\Events\CommandStartingIlluminate\Console\Events\CommandFinished 事件。但是,您可以通过将 Illuminate\Foundation\Testing\WithConsoleEvents trait 添加到类中,为给定的测试类启用这些事件

1<?php
2 
3use Illuminate\Foundation\Testing\WithConsoleEvents;
4 
5uses(WithConsoleEvents::class);
6 
7// ...
1<?php
2 
3namespace Tests\Feature;
4 
5use Illuminate\Foundation\Testing\WithConsoleEvents;
6use Tests\TestCase;
7 
8class ConsoleEventTest extends TestCase
9{
10 use WithConsoleEvents;
11 
12 // ...
13}

Laravel 是构建、部署和监控软件的最有效方式。
构建、部署和监控软件的最有效方式。