Laravel测试环境怎么隔离

wen PHP项目 2026-07-10 1

本文目录导读：

Laravel测试环境怎么隔离

使用独立测试数据库（最推荐）
环境配置隔离
文件系统隔离
缓存与队列隔离
完整的测试基类配置
并行测试隔离
注意事项

在 Laravel 测试环境中实现隔离，核心目标是：确保每个测试用例独立运行，互不影响，且不会污染实际数据或开发环境，以下是几种主流的隔离策略和方法,按推荐程度排序：

使用独立测试数据库（最推荐）

SQLite 内存数据库

最快、最彻底的隔离方式。

步骤：

修改 phpunit.xml 或 .env.testing：

<env name="DB_CONNECTION" value="sqlite"/>
<env name="DB_DATABASE" value=":memory:"/>

在测试基类中：

use Illuminate\Foundation\Testing\RefreshDatabase;

class TestCase extends BaseTestCase { use RefreshDatabase;

protected function setUp(): void
{
    parent::setUp();
    // 每次测试前迁移
    $this->artisan('migrate');
}


### 方法二：MySQL/PostgreSQL 独立数据库
为测试创建专用数据库。
**配置 `.env.testing`：**

DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=laravel_testing DB_USERNAME=root DB_PASSWORD=


**注意事项：**
- 每次运行测试前先清空该数据库
- 使用 `RefreshDatabase` trait 自动回滚
## 2. 事务回滚隔离
使用数据库事务，每个测试在事务中执行，结束后回滚。
```php
use Illuminate\Foundation\Testing\DatabaseTransactions;
class UserTest extends TestCase
{
    use DatabaseTransactions;
    public function test_create_user()
    {
        // 所有数据库操作在事务中
        // 测试结束后自动回滚
    }
}

优点： 速度快，不需要迁移 缺点： 无法测试事务本身，不支持某些数据库操作

环境配置隔离

使用 `.env.testing` 文件

Laravel 自动加载测试环境配置：

# .env.testing
APP_ENV=testing
DB_CONNECTION=sqlite
CACHE_DRIVER=array
SESSION_DRIVER=array
QUEUE_CONNECTION=sync

在 phpunit.xml 中覆盖配置

<php>
    <env name="APP_ENV" value="testing"/>
    <env name="CACHE_DRIVER" value="array"/>
    <env name="SESSION_DRIVER" value="array"/>
    <env name="QUEUE_CONNECTION" value="sync"/>
    <env name="MAIL_DRIVER" value="array"/>
    <env name="FILESYSTEM_DISK" value="testing"/>
</php>

文件系统隔离

使用 `RefreshDatabase` + 独立磁盘

// config/filesystems.php
'disks' => [
    'testing' => [
        'driver' => 'local',
        'root' => storage_path('app/testing'),
    ],
],
// 测试中
Storage::fake('testing');

缓存与队列隔离

// 测试基类中
protected function setUp(): void
{
    parent::setUp();
    // 使用数组缓存
    Config::set('cache.default', 'array');
    // 同步队列
    Config::set('queue.default', 'sync');
    // 禁用日志
    Config::set('logging.default', 'null');
}

完整的测试基类配置

<?php
namespace Tests;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\TestCase as BaseTestCase;
use Illuminate\Support\Facades\Config;
abstract class TestCase extends BaseTestCase
{
    use RefreshDatabase;
    protected $connectionsToTransact = [];
    protected function setUp(): void
    {
        parent::setUp();
        // 数据库隔离
        $this->artisan('migrate');
        // 环境配置隔离
        Config::set('cache.default', 'array');
        Config::set('queue.default', 'sync');
        Config::set('session.driver', 'array');
        Config::set('mail.driver', 'array');
        // 文件系统隔离
        Config::set('filesystems.disks.testing', [
            'driver' => 'local',
            'root' => storage_path('app/testing'),
        ]);
    }
    protected function tearDown(): void
    {
        // 清理测试文件
        $this->cleanTestingFiles();
        parent::tearDown();
    }
    private function cleanTestingFiles(): void
    {
        $testingPath = storage_path('app/testing');
        if (is_dir($testingPath)) {
            // 递归删除测试文件
        }
    }
}

并行测试隔离

使用 paratest 等工具时：

// tests/CreatesApplication.php
public function createApplication()
{
    $app = require __DIR__.'/../bootstrap/app.php';
    // 为每个进程创建独立数据库
    if (env('PARATEST')) {
        $processId = getmypid();
        config(['database.connections.mysql.database' => "laravel_testing_{$processId}"]);
    }
    $app->make(Kernel::class)->bootstrap();
    return $app;
}

隔离维度	推荐方法	原因
数据库	SQLite 内存 + RefreshDatabase	最快、最彻底
缓存	array 驱动	无副作用
队列	sync 驱动	同步执行可预测
文件	Storage::fake()	内存操作无残留
邮件	array 驱动	不实际发送
Session	array 驱动	无状态测试