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

在之前的文章《测试 Laravel 存储中的临时 URL》中，我们探讨了两种测试 Laravel 的 Storage::temporaryUrl() 方法的技术。虽然 Storage::fake 本身并不支持 temporaryUrl，但我们演示了如何使用模拟来有效地模拟其行为。如果您还没有阅读过，建议您先阅读它，了解在 Laravel 中测试临时 URL 的基础知识。

本文将深入探讨如何通过冻结时间使临时 URL 测试更可靠，尤其是在时间敏感的功能方面。我们将利用 Laravel 内置的测试辅助函数和 Carbon 的时间操作功能来解决测试中潜在的不一致性。

为什么冻结时间很重要

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

<code>断言两个字符串相等失败。
预期值：'http://localhost/test/image?expiration=1737729799'
实际值：'http://localhost/test/image?expiration=1737729800'</code>

当测试执行期间生成的过期时间戳由于时间的推移而略有不同时，就会发生这种情况。冻结时间确保所有与时间相关的操作返回一致的值，从而消除这种差异。

Laravel 的时间冻结辅助函数

Laravel 提供了几种在测试中冻结和操作时间的方法：

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

这些方法允许您控制时间的流逝，并确保测试的一致性。

更多详情，请参考以下资源：

• 在 Laravel 测试中冻结时间
• 在测试中冻结时间

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

控制器

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

final class ExternalImageTMController extends Controller
{
    /**
     * @throws ItemNotFoundException
     */
    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。

测试控制器

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

<code>断言两个字符串相等失败。
预期值：'http://localhost/test/image?expiration=1737729799'
实际值：'http://localhost/test/image?expiration=1737729800'</code>

关键点：

1. $this->freezeTime(): 确保测试中所有基于时间的操作都使用相同的时间。
2. 存储断言:
   • assertMissing：验证操作前文件不存在。
   • assertExists：确认操作后文件已存储。
3. HTTP 模拟: 模拟外部 API 调用以获取图像。
4. 临时 URL 验证: 比较预期和实际的临时 URL，由于时间冻结，它们保持一致。

如果没有冻结时间，此测试可能会由于临时 URL 中的时间戳不匹配而失败。

结论

冻结时间是一种简单而强大的技术，可以确保时间敏感测试的可靠性。通过结合 Laravel 的测试辅助函数 ($this->freezeTime) 和 Carbon 的时间操作方法 (Carbon::setTestNow)，您可以消除由执行延迟引起的不一致性。

通过采用这些实践，您将拥有更可预测和更强大的临时 URL 和其他时间敏感功能的测试。

以上是冻结时间：测试Laravel临时存储URL的详细内容。更多信息请关注PHP中文网其他相关文章！