上一篇文章探讨了两种测试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的详细内容,更多请关注php中文网其它相关文章!