Laravel单元测试使用示例

Date: 2025-05-28 17:35:46 author: lijianzhan

在 Laravel 框架中，单元测试是一种常用的测试方法，它是允许你测试应用程序中的最小可测试单元，通常是方法或函数。Laravel 提供了内置的测试工具PHPUnit，实践中进行单元测试是保障代码质量的核心。以下是关键要点和最佳实践指南：

运行环境

操作系统：Windows X64

PHP版本：8.2.9nts

Laravel Framework：10.48.28

IDE：phpstorm2024.1.5

Laravel 测试体系结构

测试类型	存放路径	特点
单元测试(Unit)	tests/Unit	测试独立类/方法，不依赖框架
--	--	--
功能测试 (Feature)	tests/Feature	测试完整业务流（含路由、数据库）

通过 Composer 来安装或更新 PHPUnit测试库依赖，以下命令：

bash 复制代码

composer require --dev phpunit/phpunit

通过Artisan 命令创建测试类

bash 复制代码

		// 创建模型测试
        php artisan make:test ExampleTest
        
        // 创建控制器测试
        php artisan make:test ExampleControllerTest
        
        // 创建模型测试
        php artisan make:test ExampleServiceTest

编写测试用例

php 复制代码

<?php

namespace Tests\Feature;

use Tests\TestCase;

class ExampleTest extends TestCase
{
    /**
     * A basic test example.
     *
     * @return void
     */
    public function test_example()
    {
        $result = "start unit success!";
        dd($result);
    }

}

运行测试

（1）使用Artisan 命令运行test测试用例

bash 复制代码

php artisan test

（2）运行命令后返回信息

（3）或者使用Artisan 命令运行test指定目录测试用例

bash 复制代码

php artisan test tests/Feature/ExampleTest.php

（4）使用代码编辑器自带Debug方法

运行测试用例返回结果
常用断言方法示例

php 复制代码

$this->assertTrue($condition);
$this->assertEquals($expected, $actual);
$this->assertCount(3, $array);
$this->assertInstanceOf(User::class, $object);
$this->assertDatabaseHas('users', ['email' => 'test@example.com']);
// 数据库事务回滚
$this->assertDatabaseCount('users', 1);

测试覆盖率分析

bash 复制代码

# 1. 安装 Xdebug 或 PCOV
sudo apt install php8.1-xdebug

# 2. 运行测试并生成报告
php artisan test --coverage-html=coverage-report

# 3. 查看报告
open coverage-report/index.html

测试金字塔原则

总结：Laravel的构建考虑到了测试。事实上，对PHPUnit测试的支持是现成的，并且已经为您的应用程序设置了PHPUnit.xml文件。该框架还附带了方便的辅助方法，允许您对应用程序进行富有表现力的测试。