冻结时间：测试Laravel临时存储URL

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《冻结时间：测试Laravel临时存储URL》，聊聊，我们一起来看看吧！

上一篇文章探讨了两种测试Laravel Storage::temporaryUrl() 方法的技术。文章演示了如何使用模拟来处理本地不支持临时URL的情况。本文将深入探讨如何利用“冻结时间”技术提升测试临时URL的可靠性，尤其针对时间敏感型功能。我们将结合Laravel内置的测试助手和Carbon的时间操纵功能，解决测试中可能出现的时间不一致问题。

为什么“冻结时间”至关重要

临时URL通常包含过期时间戳，使其对时间敏感。测试环境中细微的执行延迟可能导致过期时间不匹配，从而导致测试失败。例如：

failed asserting that two strings are equal.
expected :'http://localhost/test/image?expiration=1737729799'
actual   :'http://localhost/test/image?expiration=1737729800'

这种差异源于测试执行过程中，时间流逝导致生成的过期时间戳略有不同。“冻结时间”确保所有与时间相关的操作都返回一致的值，从而消除此类差异。

Laravel的时间冻结助手

Laravel提供多种在测试中冻结和操纵时间的方法：

• $this->freezeTime()：将时间冻结在当前时刻。后续所有基于时间的方法都将使用此冻结时间。
• $this->travelTo(Carbon::now())：模拟跳转到特定时间点。
• Carbon::setTestNow(Carbon::now())：直接设置所有Carbon操作的当前时间。

这些方法允许精确控制时间流，确保测试的一致性。更多细节，请参考Laravel测试文档中关于“冻结时间”的部分。

实际示例：使用临时URL获取外部图像

以下是一个控制器方法，从外部源获取图像，将其存储在本地存储中，并生成临时URL进行重定向：

final class ExternalImageTmController extends Controller
{
    public function show(string $path): RedirectResponse
    {
        $path = str_replace('-', '/', trim($path));

        if (!Storage::disk(StorageDiskName::DO_S3_TEHNOMIR_PRODUCT_IMAGE->value)->exists($path)) {
            $externalUrl = implode('/', [config('services.tehnomir.s3_image_url'), $path]);
            $response = Http::get($externalUrl);

            if (!$response->successful()) {
                throw new ItemNotFoundException('external image', [$path]);
            }

            Storage::disk(StorageDiskName::DO_S3_TEHNOMIR_PRODUCT_IMAGE->value)->put($path, $response->body());
        }

        return redirect()->away(
            Storage::disk(StorageDiskName::DO_S3_TEHNOMIR_PRODUCT_IMAGE->value)->temporaryUrl($path, Carbon::now()->addHour())
        );
    }
}

此方法确保图像在不存在的情况下被获取并存储，然后用户被重定向到图像的临时URL。

测试控制器

以下是如何使用“冻结时间”测试上述功能：

public function test_image_is_fetched_externally_stored_and_redirected(): void
{
    // Arrange
    $user = $this->getDefaultUser();
    $this->actingAsFrontendUser($user);

    $this->freezeTime(); // 冻结时间

    $path = 'test/image';
    $disk = Storage::fake(StorageDiskName::DO_S3_TEHNOMIR_PRODUCT_IMAGE->value);
    $externalUrl = config('services.tehnomir.s3_image_url') . '/' . $path;

    Http::fake([
        $externalUrl => Http::response('external-image-content'),
    ]);

    $disk->assertMissing($path); // 断言文件不存在

    // Act
    $response = $this->getJson(route('api-v2:external.images.tm.show', ['path' => 'test-image']));

    // Assert
    $disk->assertExists($path); // 断言文件存在
    $this->assertEquals('external-image-content', $disk->get($path));

    $temporaryUrl = $disk->temporaryUrl($path, Carbon::now()->addHour());
    $response->assertRedirect($temporaryUrl);
}

要点：

• $this->freezeTime()：确保所有基于时间的操作都使用相同的冻结时间。
• Storage 断言：assertMissing 验证操作前文件不存在；assertExists 验证操作后文件存在。
• Http::fake()：模拟外部API调用以获取图像。
• 临时URL验证：比较预期和实际的临时URL，由于时间冻结，它们保持一致。 没有冻结时间，则可能因时间戳不匹配而失败。

结论

“冻结时间”是一种简单而有效的方法，可确保时间敏感型测试的可靠性。结合Laravel测试助手和Carbon的时间操纵方法，可以消除执行延迟造成的不一致性，从而编写更可预测、更可靠的测试。

终于介绍完啦！小伙伴们，这篇关于《冻结时间：测试Laravel临时存储URL》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！