Ausführliche Erklärung zum Testen von Laravel-Befehlen

Einführung

Ich habe kürzlich das Befehlszeilentool consolo von Laravel verwendet und wollte einige Tests schreiben. Dabei stellte ich fest, dass die Befehlstestmethode im offiziellen Dokument nicht erwähnt wurde Dokumentation. Es hat einige Zeit gedauert, bis ich Informationen über die Mauer gefunden habe, und ich habe sie erfolgreich umgesetzt und aufgezeichnet, um sie für mehr Menschen zugänglich zu machen.

Empfohlen: "Laravel Tutorial"

Testmethode

Jeder weiß, dass Laravel viele ausgereifte Komponenten von Symfony verwendet, Laravel's Konsolenkomponente verwendet Symfony/console.

Glücklicherweise bietet die Symfony/Konsolenkomponente CommandTester zum Testen von Befehlen. Die Verwendung ist wie folgt

...
use FooCommand;
use Symfony\Component\Console\Application;
use Symfony\Component\Console\Tester\CommandTester;
...
public function testSample(){
    //创建一个console测试应用平台，用来搭载测试的命令
    $application = new Application();
    
    //创建待测试的command
    $testedCommand = $this->app->make(FooCommand::class);
    //设置命令执行需要的laravel依赖
    $testedCommand->setLaravel(app());
    //添加待测试的command到测试应用上
    //同时command 也绑定 application
    $application->add($testedCommand);
    //实例化命令测试类
    $commandTester = new CommandTester($testedCommand);
    //命令输入流，对应每次交互需要提供的输入内容
    $commandTester->setInputs([
        //...
        ]);
    //执行命令
    $commandTester->execute(['command' => $testedCommand->getName()]);
    //对命令执行结果进行断言测试，主要是依靠正则判断
    //$commandTester->getDisplay() 方法可以获取命令执行后的输出结果
    $this->assertRegExp("/some reg/", $commandTester->getDisplay());
}

Beispiel

Wir haben jetzt einen Befehl dazu Manuelles Erstellen eines neuen Benutzers, createUser, wird zum manuellen Erstellen eines Benutzers verwendet.

Benutzer müssen interaktiv die Eingabe von Namen, E-Mail-Adresse, Passwort, Bestätigungspasswort und diesen Daten ermöglichen.

Zu testender Befehl

<?php
namespace App\Console\Commands;
use App\User;
use Illuminate\Auth\Events\Registered;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\Validator;
class CreateUser extends Command
{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = &#39;createUser&#39;;
    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = &#39;create new user for system manually&#39;;
    /**
     * Create a new command instance.
     *
     * @return void
     */
    public function __construct()
    {
        parent::__construct();
    }
    /**
     * Execute the console command.
     *
     * @return mixed
     */
    public function handle()
    {
        $this->line($this->description);
        // 获取输入的数据
        $data = [
            &#39;name&#39; => $this->ask(&#39;What\&#39;s your name?&#39;),
            &#39;email&#39; => $this->ask(&#39;What\&#39;s your email?&#39;),
            &#39;password&#39; => $this->secret(&#39;What\&#39;s your password?&#39;),
            &#39;password_confirmation&#39; => $this->secret(&#39;Pleas confirm your password.&#39;)
        ];
        // 验证输入内容
        $validator = $this->makeValidator($data);
        if ($validator->fails()) {
            foreach ($validator->errors()->toArray() as $error) {
                foreach ($error as $message) {
                    $this->error($message);
                }
            }
            return;
        }
        // 向用户确认输入信息
        if (!$this->confirm(&#39;Confirm your info: &#39; . PHP_EOL . &#39;name:&#39; . $data[&#39;name&#39;] . PHP_EOL . &#39;email:&#39; . $data[&#39;email&#39;] . PHP_EOL . &#39;is this correct?&#39;)) {
            return;
        }
        // 注册
        $user = $this->create($data);
        event(new Registered($user));
        $this->line(&#39;User &#39; . $user->name . &#39; successfully registered&#39;);
    }
    /**
     * Get a validator for an incoming registration request.
     *
     * @param  array $data
     * @return \Illuminate\Contracts\Validation\Validator
     */
    protected function makeValidator($data)
    {
        return Validator::make($data, [
            &#39;name&#39; => &#39;required|string|max:255|unique:users&#39;,
            &#39;email&#39; => &#39;required|string|email|max:255|unique:users&#39;,
            &#39;password&#39; => &#39;required|string|min:6|confirmed&#39;
        ]);
    }
    /**
     * Create a new user instance after a valid registration.
     *
     * @param  array $data
     * @return \App\User
     */
    protected function create($data)
    {
        return User::create([
            &#39;name&#39; => $data[&#39;name&#39;],
            &#39;email&#39; => $data[&#39;email&#39;],
            &#39;password&#39; => bcrypt($data[&#39;password&#39;])
        ]);
    }
}

Richtiges Ergebnis

Wenn Sie die Informationen korrekt eingeben, erhalten Sie die folgende Ausgabe

$ path-to-your-app/app# php artisan createUser
create new user for system manually
 What's your name?:
 > vestin
 What's your email?:
 > correct@abc.com
 What's your password?:
 > 
 Pleas confirm your password.:
 > 
 Confirm your info: 
name:vestin
email:correct@abc.com
is this correct? (yes/no) [no]:
 > yes
User vestin successfully registered

Was Sie testen möchten

Ich möchte zwei Inhalte testen:

1. Dateneingabe-Verifizierungstest

● E-Mail-Gültigkeitstest

● Testen Sie, ob das zweimal eingegebene Passwort dasselbe ist

2. Benutzertest korrekt erstellen

● Unit-Test schreiben

<?php
namespace Tests\Unit\command;
use App\Console\Commands\CreateUser;
use Symfony\Component\Console\Application;
use Symfony\Component\Console\Tester\CommandTester;
use Tests\TestCase;
use Illuminate\Foundation\Testing\RefreshDatabase;
class CreateUserTest extends TestCase
{
    use RefreshDatabase;
    /**
     * 测试数据验证
     *
     * @return void
     */
    public function testValidation()
    {
        $application = new Application();
        $testedCommand = $this->app->make(CreateUser::class);
        $testedCommand->setLaravel(app());
        $application->add($testedCommand);
        $commandTester = new CommandTester($testedCommand);
        $commandTester->setInputs([&#39;Vestin&#39;, &#39;badEmail@abc&#39;, &#39;123456&#39;, &#39;654321&#39;]);
        $commandTester->execute([&#39;command&#39; => $testedCommand->getName()]);
        // assert
        $this->assertRegExp("/The email must be a valid email address/", $commandTester->getDisplay());
        $commandTester->setInputs([&#39;vestin&#39;, &#39;correct@abc.com&#39;, &#39;123456&#39;, &#39;654321&#39;]);
        $commandTester->execute([&#39;command&#39; => $testedCommand->getName()]);
        // assert
        $this->assertRegExp("/The password confirmation does not match/", $commandTester->getDisplay());
    }
    /**
     * 测试成功注册用户
     *
     * @return void
     */
    public function testSuccess()
    {
        $application = new Application();
        $testedCommand = $this->app->make(CreateUser::class);
        $testedCommand->setLaravel(app());
        $application->add($testedCommand);
        $commandTester = new CommandTester($testedCommand);
        $commandTester->setInputs([&#39;Vestin&#39;, &#39;correct@abc.com&#39;, &#39;123456&#39;, &#39;123456&#39;, &#39;y&#39;]);
        $commandTester->execute([&#39;command&#39; => $testedCommand->getName()]);
        // assert
        $this->assertRegExp("/User Vestin successfully registered/", $commandTester->getDisplay());
        $this->assertDatabaseHas(&#39;users&#39;, [
            &#39;email&#39; => &#39;correct@abc.com&#39;,
            &#39;name&#39; => &#39;Vestin&#39;
        ]);
    }
}

Test ausführen

$ path-to-your-app/app#  ./vendor/bin/phpunit 
PHPUnit 6.4.3 by Sebastian Bergmann and contributors.
..                                                                  3 / 3 (100%)
Time: 659 ms, Memory: 14.00MB

Das obige ist der detaillierte Inhalt vonAusführliche Erklärung zum Testen von Laravel-Befehlen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!