別讓你的網站等到天荒地老！WordPress Transients API 終極指南，一招榨乾網站潛在效能

嗨，我是浪花科技的資深工程師 Eric。寫了這麼多年的 WordPress，我看過太多網站因為一些可以輕易避免的效能問題而變得龜速。其中一個最常見，卻也最容易被忽略的元兇，就是重複進行昂貴的運算或 API 請求。每次使用者重新整理頁面，你的伺服器就得再跑一次複雜的資料庫查詢、再跟遠方的 API 打一次招呼… 天啊，光想就覺得心累，你的伺服器跟使用者的耐心大概也差不多被磨光了。

今天，我就要來揭露一個 WordPress 內建的效能黑魔法：Transients API。它就像是你網站的「短期記憶」，能把那些耗時的運算結果暫存起來，在需要的時候瞬間調用，而不是每次都傻傻地重新來過。搞懂它，你的網站效能絕對能提升一個檔次。好了，工程師的咖啡泡好了，我們開始吧！

揭開 Transients 的神秘面紗：它到底是什麼？

簡單來說，Transients API 提供了一個非常簡單的方式，讓你可以在 WordPress 資料庫中暫時儲存一些資料。它有三個關鍵字：「暫時」、「有名字」、「有期限」。

• 暫時 (Transient)： 顧名思義，這些資料不是永久性的。你可以設定一個過期時間，時間一到，它就自動失效。
• 有名字 (Key-Value)： 你會給每一筆暫存資料一個獨一無二的名字（Key），然後把你要存的資料（Value）放進去。下次要用的時候，就用這個名字把它叫出來。
• 有期限 (Expiration)： 這是 Transients 最迷人的地方。你可以設定這筆資料要存活多久，例如 15 分鐘、1 小時或 1 天。

把它想像成是你去圖書館查了一個複雜的資料，為了避免下次還要重查，你順手抄在一張便利貼上，並註明「這個資料一小時後可能就舊了」。在一小時內，你只要看便利貼就好，省去了跑回圖書館的力氣。Transients 就是你網站的這張「數位便利貼」。

Transients vs. Object Cache：別再傻傻分不清楚！

講到快取，很多開發者會馬上想到 Redis 或 Memcached 這類的 Object Cache (物件快取)。這時候問題就來了：「Eric，既然有 Object Cache，我幹嘛還需要 Transients？」

這就是工程師的小囉嗦時間了。這兩者不是競爭關係，而是合作關係！你可以這樣理解：

• Transients API 是一套「標準化介面」或「規格」。
• Object Cache (如 Redis) 是實現這個介面的「高效能後端」。

當你的主機環境有設定 Object Cache (例如 Redis)，你用 Transients API 存資料時，WordPress 會非常聰明地將資料直接存到記憶體中，速度快到飛起。但如果你的主機沒裝這些東西（很多共享主機都沒有），WordPress 也會自動降級（fallback），把資料改存到資料庫的 wp_options 資料表中。

這代表什麼？這代表你寫的程式碼完全不用變！無論客戶的網站是用高階的 VPS 還是入門的共享主機，你寫的 Transients 程式碼都能運作，並且在高效能環境下自動獲得加速。這就是 WordPress 設計的優雅之處啊！想更深入了解 Object Cache，可以參考這篇揭秘 WordPress Object Cache 的文章。

Transients API 三劍客：動手實戰教學

Transients API 的核心其實就三個函式，非常簡單好懂。讓我們一個一個來看。

1. 儲存你的寶貴資料：`set_transient()`

這是用來建立或更新一筆暫存資料的函式。它需要三個參數：

• $transient (字串): 你的便利貼名稱（Key），必須是獨一無二的。
• $value (混合型): 你要儲存的任何資料，可以是字串、數字、陣列，甚至是物件。WordPress 會自動幫你序列化處理。
• $expiration (整數): 過期時間，單位是秒。你可以用 WordPress 內建的時間常數，例如 HOUR_IN_SECONDS (3600秒), DAY_IN_SECONDS (86400秒)，這樣程式碼會更語意化。

<?php
// 假設我們從一個很慢的 API 拿到了一些天氣資料
$weather_data = array(
    'city' => 'Taipei',
    'temperature' => '28°C',
    'description' => 'Sunny'
);

// 將天氣資料存起來，設定過期時間為 1 小時
set_transient( 'taipei_weather_data', $weather_data, HOUR_IN_SECONDS );
?>

2. 聰明地讀取資料：`get_transient()`

這是用來讀取我們剛剛存進去的資料。它只需要一個參數：

• $transient (字串): 你要讀取的便利貼名稱（Key）。

如果資料存在且尚未過期，它會回傳你儲存的資料。如果資料不存在或已過期，它會回傳 false。這個特性讓我們可以寫出非常經典的快取邏輯：

<?php
// 嘗試從暫存中讀取天氣資料
$weather_data = get_transient( 'taipei_weather_data' );

// 檢查資料是否存在（也就是檢查回傳值是不是 false）
if ( false === $weather_data ) {
    // 如果不存在或已過期，我們才去呼叫那個很慢的 API
    // (這裡是示意程式碼，實際情況會是個 API call)
    $weather_data = fetch_slow_weather_api_data( 'taipei' );

    // 拿到新資料後，記得要再把它存回 transient，設定下次的過期時間
    set_transient( 'taipei_weather_data', $weather_data, HOUR_IN_SECONDS );

    // 這邊可以加個 log，方便我們 debug
    error_log('Weather data re-fetched from API.');
}

// 不管是從暫存還是 API 拿到的，現在 $weather_data 裡面都有最新的資料了
echo 'Current temperature in ' . $weather_data['city'] . ' is ' . $weather_data['temperature'];
?>

你看，這個邏輯多麼漂亮！只有在快取失效時，才需要執行那段昂貴的程式碼。

3. 當你需要「斷捨離」：`delete_transient()`

有時候，你可能在資料過期前就需要強制更新它。例如，你在後台更新了一篇「熱門文章」列表的設定，你希望前台立刻顯示最新的結果，而不是等到 transient 過期。這時候就需要 `delete_transient()`。

• $transient (字串): 你要刪除的便利貼名稱（Key）。

<?php
// 當使用者在後台儲存了新的熱門文章設定時，我們就刪除舊的 transient
// 這樣下次前台載入時，get_transient() 就會回傳 false，進而觸發重新抓取資料的邏輯
delete_transient( 'popular_posts_query' );
?>

實戰應用場景：讓你的網站快到飛起來！

理論講完了，來點實際的。Transients 在哪些地方可以發揮最大作用？

案例一：為複雜的資料庫查詢加上「渦輪增壓」

假設你的首頁需要顯示一個「留言數最多的 5 篇文章」列表。這個查詢可能需要 JOIN 好幾個資料表，在流量大的網站上會是個效能瓶頸。用 Transients 就能完美解決。

<?php
function get_most_commented_posts() {
    // 先檢查有沒有快取
    $popular_posts = get_transient('most_commented_posts');

    if ( false === $popular_posts ) {
        // 快取沒有，只好親自下海撈資料
        $args = array(
            'posts_per_page' => 5,
            'orderby' => 'comment_count',
            'order' => 'DESC'
        );
        $query = new WP_Query($args);
        
        // 為了避免儲存整個肥大的 WP_Query 物件，我們只儲存需要的資料
        $popular_posts = array();
        if ( $query->have_posts() ) {
            while ( $query->have_posts() ) {
                $query->the_post();
                $popular_posts[] = array(
                    'title' => get_the_title(),
                    'permalink' => get_permalink()
                );
            }
        }
        wp_reset_postdata(); // 好習慣，記得重設

        // 將整理好的資料存入 transient，有效期 6 小時
        set_transient('most_commented_posts', $popular_posts, 6 * HOUR_IN_SECONDS);
    }

    return $popular_posts;
}
?>

這樣一來，這個複雜的查詢每 6 個小時最多只會執行一次，對資料庫的壓力瞬間減輕！這也是我們在進行資料庫效能優化時常用的手法之一。

案例二：告別龜速的外部 API 請求

你的網站可能需要顯示 Instagram 的最新貼文、天氣資訊、或是貨幣匯率。這些都需要透過外部 API 取得，而網路請求通常是網站變慢的主因。這正是 Transients 大顯身手的地方。

前面的 `get_transient()` 範例其實就已經是這個場景的最佳實踐了。每次頁面載入都去請求一次 API 是非常沒有效率且不禮貌的行為（有些 API 還有請求頻率限制）。透過設定 15 分鐘或 1 小時的 transient，你可以在不犧牲太多即時性的前提下，大幅提升頁面載入速度。如果你正在開發需要大量使用 API 的功能，強烈建議你搭配閱讀這篇深入 WordPress REST API 的文章，會讓你對 API 的應用有更全面的了解。

工程師的總結

Transients API 看似簡單，但它體現了程式設計中一個非常重要的原則：「不要重複做昂貴的事」。無論是複雜的資料庫查詢還是外部 API 請求，都屬於「昂貴」的操作。學會使用 Transients 將這些操作的結果暫存起來，是你從 WordPress 新手邁向資深開發者的重要一步。

它不僅能顯著提升網站效能，還能讓你的程式碼在各種主機環境下都表現優異。下次當你發現網站某個部分載入緩慢時，先問問自己：「這裡的資料，真的需要每次都重新計算嗎？」或許，一個簡單的 `set_transient` 就能解決你的煩惱。

相關閱讀

• 還在被慢速資料庫拖垮？揭秘 WordPress Object Cache，釋放網站潛藏的終極效能！
• 你的 WordPress 資料庫肥到走不動？資深工程師的終極瘦身指南，榨出110%的網站效能！
• 解鎖 WordPress 的無限可能：資深工程師帶你深入 REST API 的黑魔法世界

如果你對 WordPress 網站效能優化還有更多疑問，或是有客製化開發的需求，網站總是慢到讓你懷疑人生？歡迎聯繫浪花科技，我們的團隊擁有豐富的實戰經驗，可以為你提供最專業的解決方案。