使用 PHPUnit 在 Laravel 中进行测试的综合指南

Laravel 测试简介

测试是软件开发的一个重要方面，可确保您的应用程序按预期运行。 Laravel 通过 PHPUnit（一种流行的 PHP 测试框架）提供了一个强大的开箱即用的测试套件。本指南将引导您在 Laravel 中设置和运行测试，解释单元测试和功能测试之间的差异，并提供各种测试场景的示例。

文件夹结构：单元测试与功能测试

在 Laravel 中，测试通常被组织到两个主要目录中：Unit 和 Feature。

单元测试：这些测试旨在测试应用程序的小型、独立部分，例如单个方法或类。它们通常位于tests/Unit 目录中。每个测试函数都应以单词 test 开头。

示例：

public function testExampleFunction() {
    $this->assertTrue(true);
}

功能测试：这些测试处理更复杂的交互，通常测试多个组件一起工作。它们位于测试/功能目录中。功能测试通常涉及发出 HTTP 请求和检查响应。

在 Laravel 中运行测试

要在 Laravel 应用程序中运行所有测试，请使用以下命令：

./vendor/bin/phpunit

配置测试环境

在运行测试之前，配置测试环境非常重要。修改 phpunit.xml 文件以设置用于测试的环境变量。例如，要使用 SQLite 内存数据库进行更快的测试：

<php>
    <env name="APP_ENV" value="testing"></env>
    <env name="APP_MAINTENANCE_DRIVER" value="file"></env>
    <env name="BCRYPT_ROUNDS" value="4"></env>
    <env name="CACHE_STORE" value="array"></env>
    <env name="DB_CONNECTION" value="sqlite"></env>
    <env name="DB_DATABASE" value=":memory:"></env>
    <env name="MAIL_MAILER" value="array"></env>
    <env name="PULSE_ENABLED" value="false"></env>
    <env name="QUEUE_CONNECTION" value="sync"></env>
    <env name="SESSION_DRIVER" value="array"></env>
    <env name="TELESCOPE_ENABLED" value="false"></env>
</php>

启用 SQLite 作为测试环境后，清除配置缓存：

php artisan config:clear

*示例：测试配置文件路由是否存在并正常工作
*

为配置文件路由创建测试：

php artisan make:test ProfileTest

添加测试方法来检查个人资料页面是否显示特定文本：

public function testProfilePage(){
    $response = $this->get('/profile');
    $response->assertSeeText('Your Profile');
}

测试数据库交互

设置测试数据库

在测试数据库交互之前，在 config/database.php 中创建一个测试数据库配置：

'mysqltesting' => [
    'driver' => 'mysql',
    'url' => env('DB_URL'),
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '3306'),
    'database' => 'laravel_testing',
    'username' => env('DB_USERNAME', 'root'),
    'password' => env('DB_PASSWORD', ''),
    'unix_socket' => env('DB_SOCKET', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'prefix_indexes' => true,
    'strict' => true,
    'engine' => null,
    'options' => extension_loaded('pdo_mysql') ? array_filter([
        PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
    ]) : [],
],

运行数据库测试

运行 PHPUnit 命令以确保测试数据库已创建并正常工作：

./vendor/bin/phpunit

示例：测试用户注册

创建用户注册测试：

php artisan make:test UserTest

添加测试方法来验证可以创建用户并将其保存到数据库：

public function test_registration(): void
{
    $user = new User();
    $user->name = 'Test User';
    $user->email = 'email@example.com';
    $user->password = bcrypt('password');

    $user->save();

    $this->assertDatabaseHas('users', ['email' => 'email@example.com']);
}

测试商店操作

在 PostTest 类中创建存储操作的测试：

public function testPostStoreValid()
{
    $data = [
        'title'=> 'Test Post',
        'slug' => 'test-post',
        'content' => 'Content of the post',
        'active' => true,
    ];

    $this->post('/posts', $data)
         ->assertStatus(302)
         ->assertSessionHas('status');

    $this->assertEquals(session('status'), 'Post was created!');
}

故障测试

添加测试方法来检查验证错误：

public function testPostFail()
{
    $data = [
        'title'=> '',
        'content' => '',
    ];

    $this->post('/posts', $data)
         ->assertStatus(302)
         ->assertSessionHas('errors');

    $messages = session('errors')->getMessages();

    $this->assertEquals($messages['title'][0], 'The title must be at least 4 characters.');
    $this->assertEquals($messages['title'][1], 'The title field is required.');
    $this->assertEquals($messages['content'][0], 'The content field is required.');
}

*测试更新操作
*

添加更新帖子的测试方法：

public function testPostUpdate()
{
    $post = new Post();

    $post->title = "Initial Title";
    $post->slug = Str::slug($post->title, '-');
    $post->content = "Initial content";
    $post->active = true;

    $post->save();

    $this->assertDatabaseHas('posts', $post->toArray());

    $data = [
        'title' => 'Updated Title',
        'slug' => 'updated-title',
        'content' => 'Updated content',
        'active' => false,
    ];

    $this->put("/posts/{$post->id}", $data)
         ->assertStatus(302)
         ->assertSessionHas('status');

    $this->assertDatabaseHas('posts', ['title' => $data['title']]);
    $this->assertDatabaseMissing('posts', ['title' => $post->title]);
}

测试删除操作

添加删除帖子的测试方法：

public function testPostDelete()
{
    $post = new Post();

    $post->title = "Title to delete";
    $post->slug = Str::slug($post->title, '-');
    $post->content = "Content to delete";
    $post->active = true;

    $post->save();

    $this->assertDatabaseHas('posts', $post->toArray());

    $this->delete("/posts/{$post->id}")
         ->assertStatus(302)
         ->assertSessionHas('status');

    $this->assertDatabaseMissing('posts', $post->toArray());
}

**

使用 PHPUnit 运行特定测试

**

要运行特定的测试方法或类，请在 PHPUnit 中使用 --filter 选项。以下是一些示例：

运行特定的测试方法

./vendor/bin/phpunit --filter PostTest::testPostDelete

运行特定类中的所有测试

./vendor/bin/phpunit --filter PostTest

在特定文件中运行测试

./vendor/bin/phpunit tests/Feature/PostTest.php

详细输出

要获得更详细的输出，请添加 -v 选项：

./vendor/bin/phpunit --filter PostTest::testPostDelete -v

以上是使用 PHPUnit 在 Laravel 中进行测试的综合指南的详细内容。更多信息请关注PHP中文网其他相关文章！