WP Rocket 多語系快取：儲存草稿時翻譯版快取消失的原因與解法

// wp-rocket/inc/ThirdParty/Plugins/I18n/TranslatePress.php (3.23.5.1)
'post_updated' => 'clear_post_languages',            // 每次儲存文章時執行

public function clear_post_languages( $post_id ) {
    // …
    $default_permalink = get_permalink( $post_id );   // 不檢查文章狀態

    foreach ( $trp_settings['translation-languages'] as $language ) {
        if ( $language === $trp_settings['default-language'] ) {
            continue;
        }
        $clear_urls[] = $converter->get_url_for_language( $language, $default_permalink, '' );
    }
    // …
    rocket_clean_files( $clear_urls );
}

// wp-rocket/inc/functions/files.php (3.23.5.1) — rocket_clean_files() 內
$parsed_url = get_rocket_parse_url( $url );               // 分開路徑與查詢
// …
$entry = $dir . $parsed_url['path'];                      // …/example.com/en/
// …
if ( $filesystem->is_dir( $entry ) ) {
    rocket_rrmdir( $entry, [], $filesystem );             // 連同資料夾遞迴刪除
} else {
    $filesystem->delete( $entry );
}

<?php
/**
 * Plugin Name: Rocket TranslatePress Draft Fix
 * Description: 把 WP Rocket TranslatePress 整合的翻譯版快取刪除限制在網址確定的情況
 */

// 1. 從 post_updated 拆下 WP Rocket 整合函式並保留
add_action( 'init', function () {
    global $wp_filter;
    if ( empty( $wp_filter['post_updated'] ) ) {
        return;
    }
    foreach ( $wp_filter['post_updated']->callbacks as $priority => $callbacks ) {
        foreach ( $callbacks as $cb ) {
            $fn = $cb['function'];
            if ( is_array( $fn ) && is_object( $fn[0] )
                && 0 === strpos( get_class( $fn[0] ), 'WP_Rocket\\' )
                && false !== stripos( get_class( $fn[0] ), 'TranslatePress' ) ) {
                remove_action( 'post_updated', $fn, $priority );
                $GLOBALS['rtdf_original'] = $fn;
            }
        }
    }
}, 9999 );

// 2. 替代函式
add_action( 'post_updated', function ( $post_id, $after, $before ) {
    if ( empty( $GLOBALS['rtdf_original'] ) || ! class_exists( 'TRP_Translate_Press' ) ) {
        return;
    }
    $trp       = TRP_Translate_Press::get_trp_instance();
    $converter = $trp->get_component( 'url_converter' );
    $settings  = $trp->get_component( 'settings' )->get_settings();
    $languages = array_diff( $settings['translation-languages'], [ $settings['default-language'] ] );

    // 首頁 — 只刪除語言首頁的快取檔案，不刪除語言資料夾
    if ( 'page' === get_option( 'show_on_front' ) && (int) get_option( 'page_on_front' ) === (int) $post_id ) {
        $urls = [];
        add_filter( 'trp_add_language_to_home_url_check_for_admin', '__return_false' );
        foreach ( $languages as $lang ) {
            $home = $converter->get_url_for_language( $lang, home_url( '/' ), '' );
            $dir  = WP_ROCKET_CACHE_PATH . wp_parse_url( $home, PHP_URL_HOST ) . wp_parse_url( $home, PHP_URL_PATH );
            array_map( 'unlink', glob( $dir . 'index*.html*' ) ?: [] );
            $urls[] = $home;
        }
        remove_filter( 'trp_add_language_to_home_url_check_for_admin', '__return_false' );
        do_action( 'rocket_after_clean_terms', $urls );   // 告知預先載入（5️⃣）
        return;
    }

    // 儲存已發佈文章 — 照樣執行 WP Rocket 原本的函式
    if ( 'publish' === $after->post_status ) {
        call_user_func( $GLOBALS['rtdf_original'], $post_id );
        return;
    }

    // 已發佈 → 草稿·私密·回收桶 — 只處理下架前網址的翻譯版
    if ( 'publish' === $before->post_status ) {
        $old  = get_permalink( $before );
        $urls = [];
        add_filter( 'trp_add_language_to_home_url_check_for_admin', '__return_false' );
        foreach ( $languages as $lang ) {
            $urls[] = $converter->get_url_for_language( $lang, $old, '' );
        }
        remove_filter( 'trp_add_language_to_home_url_check_for_admin', '__return_false' );
        rocket_clean_files( $urls );
    }

    // 其他情況（草稿·修訂版本·自動儲存）沒有翻譯版網址，因此不刪除
}, 10, 3 );

// 沒有刪除訊號就刪除之後 — 把刪除的網址陣列重新登記到預先載入佇列
rocket_clean_files( $urls, null, false );          // 第三個參數 false = 沒有刪除訊號
do_action( 'rocket_after_clean_terms', $urls );     // 預先載入把這些網址改回等待（pending）

# 該網址在佇列表中的狀態（表名前的 wp_ 是網站前綴）
wp db query <<'SQL'
SELECT url, status, modified FROM wp_wpr_rocket_cache WHERE url LIKE '%/en/sample-post-en'
SQL

url	status	modified
https://example.com/en/sample-post-en	pending	2026-10-17 09:10:48

# 約 1 分鐘後快取檔案是否重新產生
ls -l wp-content/cache/wp-rocket/example.com/en/sample-post-en/

total 240
-rw-r--r-- 1 example nobody 95084 Oct 17 18:12 index-https.html
-rw-r--r-- 1 example nobody 22352 Oct 17 18:12 index-https.html_gzip
-rw-r--r-- 1 example nobody 95083 Oct 17 18:12 index-mobile-https.html
-rw-r--r-- 1 example nobody 22348 Oct 17 18:12 index-mobile-https.html_gzip