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

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

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

什么是 PHPUnit 和 Laravel 中的测试

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

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

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

创建第一个单元测试

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

// 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);
    }
}

运行这个测试:

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 和业务逻辑,能显著提升代码质量。


# laravel  # php  # word  # js  # json  # app  # 工具  # ai  # 路由  # 状态码  # 用户注册  # red  # NULL  # Filter  # 继承  # 接口  # this  # 数据库  # http  # 单元测试  # 两类  # 自己的  # 判断是否  # 如果你  # 放在  # 第一个  # 两种  # 你有 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Win11应用商店下载慢怎么办 Win11更改DNS提速下载【修复】  nginx修改上传文件大小限制的方法  Win11搜索栏无法输入_解决Win11开始菜单搜索没反应问题【技巧】  七夕网站制作视频,七夕大促活动怎么报名?  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程?  Laravel如何创建和注册中间件_Laravel中间件编写与应用流程  如何在IIS中新建站点并解决端口绑定冲突?  Laravel怎么创建控制器Controller_Laravel路由绑定与控制器逻辑编写【指南】  Laravel Octane如何提升性能_使用Laravel Octane加速你的应用  JS碰撞运动实现方法详解  Laravel如何实现邮件验证激活账户_Laravel内置MustVerifyEmail接口配置【步骤】  惠州网站建设制作推广,惠州市华视达文化传媒有限公司怎么样?  javascript读取文本节点方法小结  学生网站制作软件,一个12岁的学生写小说,应该去什么样的网站?  深圳网站制作设计招聘,关于服装设计的流行趋势,哪里的资料比较全面?  使用PHP下载CSS文件中的所有图片【几行代码即可实现】  php做exe能调用系统命令吗_执行cmd指令实现方式【详解】  在线制作视频的网站有哪些,电脑如何制作视频短片?  Win11怎么开启自动HDR画质_Windows11显示设置HDR选项  Linux系统命令中screen命令详解  如何在建站主机中优化服务器配置?  音乐网站服务器如何优化API响应速度?  php增删改查怎么学_零基础入门php数据库操作必知基础【教程】  Java Adapter 适配器模式(类适配器,对象适配器)优缺点对比  Laravel怎么实现观察者模式Observer_Laravel模型事件监听与解耦开发【指南】  如何在云主机上快速搭建多站点网站?  JS实现鼠标移上去显示图片或微信二维码  Python自然语言搜索引擎项目教程_倒排索引查询优化案例  油猴 教程,油猴搜脚本为什么会网页无法显示?  详解jQuery停止动画——stop()方法的使用  Laravel如何实现API资源集合?(Resource Collection教程)  Laravel如何创建自定义中间件?(Middleware代码示例)  Chrome浏览器标签页分组怎么用_谷歌浏览器整理标签页技巧【效率】  如何快速重置建站主机并恢复默认配置?  Laravel如何实现多语言支持_Laravel本地化与国际化(i18n)配置教程  安克发布新款氮化镓充电宝:体积缩小 30%,支持 200W 输出  Laravel如何使用Spatie Media Library_Laravel图片上传管理与缩略图生成【步骤】  网站制作壁纸教程视频,电脑壁纸网站?  Laravel模型关联查询教程_Laravel Eloquent一对多关联写法  详解Android图表 MPAndroidChart折线图  如何在阿里云高效完成企业建站全流程?  如何用低价快速搭建高质量网站?  详解Oracle修改字段类型方法总结  网站制作怎么样才能赚钱,用自己的电脑做服务器架设网站有什么利弊,能赚钱吗?  香港服务器网站卡顿?如何解决网络延迟与负载问题?  网站设计制作书签怎么做,怎样将网页添加到书签/主页书签/桌面?  Laravel如何实现用户密码重置功能?(完整流程代码)  详解Android——蓝牙技术 带你实现终端间数据传输  Python文件异常处理策略_健壮性说明【指导】  如何在云服务器上快速搭建个人网站?