0

0

Laravel怎么写单元测试_PHPUnit在Laravel项目中的基础测试入门

裘德小鎮的故事

裘德小鎮的故事

发布时间:2025-12-03 07:21:24

|

177人浏览过

|

来源于php中文网

原创

Laravel内置PHPUnit支持,提供单元测试和功能测试两类,通过TestCase基类和辅助方法如assertDatabaseHas、RefreshDatabase等简化测试流程,可使用php artisan test命令运行测试,建议从简单类测试入手逐步覆盖业务逻辑。

laravel怎么写单元测试_phpunit在laravel项目中的基础测试入门

在 Laravel 项目中写单元测试非常方便,因为框架本身就集成了 PHPUnit,并提供了丰富的辅助方法来简化测试流程。如果你刚接触 Laravel 测试,可以从基础的单元测试和功能测试开始。

什么是 PHPUnit 和 Laravel 中的测试

PHPUnit 是 PHP 的标准单元测试框架。Laravel 默认使用 PHPUnit 来运行测试,测试文件放在 tests 目录下。Laravel 提供了两种主要类型的测试:

  • 单元测试(Unit Tests):测试单个函数、类或方法的逻辑,不涉及数据库、路由或外部服务。
  • 功能测试(Feature Tests):测试整个请求响应流程,比如访问某个路由是否返回正确页面或 JSON 数据。

Laravel 为这两类测试都提供了基类:Tests\TestCase,所有测试类都会继承它。

创建第一个单元测试

假设你有一个简单的数学工具类,用来做加法运算:

立即学习PHP免费学习笔记(深入)”;

// app/Services/MathService.php
namespace App\Services;

class MathService
{
    public function add($a, $b)
    {
        return $a + $b;
    }
}

你可以为这个类写一个单元测试:

// tests/Unit/MathServiceTest.php
namespace Tests\Unit;

use Tests\TestCase;
use App\Services\MathService;

class MathServiceTest extends TestCase
{
    public function test_it_can_add_two_numbers()
    {
        $math = new MathService();
        $result = $math->add(3, 5);

        $this->assertEquals(8, $result);
    }
}

运行这个测试:

68爱写
68爱写

专业高质量AI4.0论文写作平台,免费生成大纲,支持无线改稿

下载
php artisan test --filter=MathServiceTest

如果看到绿色的“OK”,说明测试通过了。

测试 Laravel 功能:例如用户注册

功能测试更贴近实际使用场景。比如测试用户注册接口是否正常工作:

// tests/Feature/UserRegistrationTest.php
namespace Tests\Feature;

use Tests\TestCase;
use Illuminate\Foundation\Testing\RefreshDatabase;

class UserRegistrationTest extends TestCase
{
    use RefreshDatabase; // 每次测试后清空测试数据库

    public function test_user_can_register()
    {
        $response = $this->post('/register', [
            'name' => 'John Doe',
            'email' => 'john@example.com',
            'password' => 'password',
            'password_confirmation' => 'password',
        ]);

        $response->assertRedirect('/dashboard');
        $this->assertDatabaseHas('users', [
            'name' => 'John Doe',
            'email' => 'john@example.com',
        ]);
    }
}

几点说明:

  • RefreshDatabase:确保测试不会污染真实数据,推荐用于涉及数据库的操作。
  • $this->post():模拟 POST 请求。
  • assertRedirect:断言跳转到指定路径。
  • assertDatabaseHas:断言数据库中存在某条记录。

常用断言方法

在测试中,断言是验证结果的核心。常见的有:

  • $this->assertEquals($expected, $actual):判断两个值是否相等。
  • $this->assertTrue($condition):判断是否为 true。
  • $response->assertStatus(200):检查 HTTP 状态码
  • $response->assertSee('text'):检查响应内容是否包含某文本。
  • $response->assertJson(['key' => 'value']):检查 JSON 响应结构。
  • $this->assertNull($value):判断是否为 null。

运行测试

Laravel 提供了 Artisan 命令来运行测试:

  • php artisan test:运行所有测试。
  • php artisan test --filter=MathServiceTest:运行指定测试类或方法。
  • php artisan test --parallel:并行运行测试(Laravel 9+),加快速度。

你也可以只运行单元测试或功能测试:

php artisan test --parallel --group=Unit

小建议

  • 测试类命名规范:以测试类型开头,如 UserTestMathServiceTest
  • 测试方法名尽量描述行为,如 test_user_cannot_view_unpublished_post
  • 使用 RefreshDatabase 避免数据残留。
  • 不要测试第三方包逻辑,只测试自己的代码。
基本上就这些。Laravel 的测试系统开箱即用,配合 PHPUnit 写起来很顺手。从简单类测试入手,再逐步覆盖控制器、API 和业务逻辑,能显著提升代码质量。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2709

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1668

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1528

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

974

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1444

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1235

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1529

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1307

2023.11.13

excel表格操作技巧大全 表格制作excel教程
excel表格操作技巧大全 表格制作excel教程

Excel表格操作的核心技巧在于 熟练使用快捷键、数据处理函数及视图工具,如Ctrl+C/V(复制粘贴)、Alt+=(自动求和)、条件格式、数据验证及数据透视表。掌握这些可大幅提升数据分析与办公效率,实现快速录入、查找、筛选和汇总。

0

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
HTML教程
HTML教程

共500课时 | 4.8万人学习

php初学者入门课程
php初学者入门课程

共10课时 | 0.6万人学习

RunnerGo从入门到精通
RunnerGo从入门到精通

共22课时 | 1.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号