凍結時間：測試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中文網其他相關文章！