gclid 快取：廣告點選查詢、頁面快取鍵與實測首位元組

https://example.com/sample-page/?gad_source=1&gad_campaignid=1234567890&gbraid=EXAMPLE&gclid=EXAMPLE
https://example.com/sample-page/?gclid=EXAMPLE&gbraid=EXAMPLE&wbraid=EXAMPLE

# nginx.conf — http 區塊：跳過快取檔案的條件
map $http_cookie $rocket_cookie {
    default                   0;
    '~*wordpress_logged_in'   1;
    '~*wp-postpass'           1;
    '~*comment_author'        1;
    '~*woocommerce_items'     1;
}
map $request_method $rocket_method {
    default  1;
    GET      0;
    HEAD     0;
}
map $query_string $rocket_query {
    default  1;
    ''       0;      # 只有查詢字串為空時才是 0
}

# server 區塊
set $rocket_bypass '';
if ($rocket_cookie = 1) { set $rocket_bypass '1'; }
if ($rocket_method = 1) { set $rocket_bypass '1'; }
if ($rocket_query  = 1) { set $rocket_bypass '1'; }
set $rocket_file '/wp-content/cache/wp-rocket/example.com${request_uri}index-https.html';
if ($rocket_bypass = '1') { set $rocket_file ''; }

location / {
    try_files $rocket_file @apache;                       # 路徑為空或沒有檔案時轉給 Apache
    add_header X-Rocket-Nginx-Serving-File 'HIT' always;  # 表示 nginx 直接用快取檔案回應
}

curl -so /dev/null -H 'Accept-Encoding: gzip' -w '%{time_starttransfer}\n' \
  'https://example.com/sample-page/'

0.015127

curl -so /dev/null -H 'Accept-Encoding: gzip' -w '%{time_starttransfer}\n' \
  'https://example.com/sample-page/?gclid=test123'

0.029525

curl -sI 'https://example.com/sample-page/' | grep -i x-rocket-nginx-serving-file

x-rocket-nginx-serving-file: HIT

// wp-rocket/inc/classes/Buffer/class-tests.php (3.23.5.1)
public function get_query_params() {
    // …
    $params = array_diff_key(                                  // 先拿掉要忽略的查詢
        self::$get,
        $this->config->get_config( 'cache_ignored_parameters' )
    );
    // …
}

public function can_process_query_string() {
    // …
    $params = $this->get_query_params();

    if ( ! $params ) {                                         // 沒有剩下的查詢就用快取處理
        return self::memoize( __FUNCTION__, [], true );
    }
    // 只有 lang · s · permalink_name · lp-variation-id 與加進 [Cache Query String(s)] 的查詢能通過
    // …
}

// 摘自 WP Rocket | Ignore Query Strings 1.1.1（WP Rocket 支援團隊的輔助外掛）
function define_ignored_parameters( array $params ) {
    $params['new_query_string'] = 1;      // 加入要忽略的查詢
    //unset ( $params['utm_source'] );    // 從要忽略的查詢中移除
    return $params;
}
add_filter( 'rocket_cache_ignored_parameters', __NAMESPACE__ . '\define_ignored_parameters', 999 );

register_activation_hook( __FILE__, __NAMESPACE__ . '\flush_wp_rocket' );   // 啟用時執行 rocket_generate_config_file()

curl -s -o /dev/null -w '%{size_download} %{time_starttransfer}\n' -H 'Accept-Encoding: gzip' 'https://example.com/sample-page/'
curl -s -o /dev/null -w '%{size_download} %{time_starttransfer}\n' -H 'Accept-Encoding: gzip' 'https://example.com/sample-page/?uk_test=abc'
curl -s -o /dev/null -w '%{size_download} %{time_starttransfer}\n' -H 'Accept-Encoding: gzip' 'https://example.com/sample-page/?uk_test=xyz'

21390 0.025720
21390 0.025507
21390 0.027929

curl -s --compressed 'https://example.com/sample-page/?uk_test=abc' | tail -c 200

ck=lazyLoadYoutubeIframe;}});</script></body>
</html>

<!-- This website is like a Rocket, isn't it? Performance optimized by WP Rocket. Learn more: https://wp-rocket.me - Debug: cached@1792248839 -->

# gclid 值不同的兩次請求的 CDN 快取狀態（標頭名稱依 CDN 而不同）
curl -sI 'https://example.com/sample-page/?gclid=test1' | grep -i -E 'cache|age'

curl -sI 'https://example.com/sample-page/?gclid=test2' | grep -i -E 'cache|age'

curl -s -o /dev/null -w '%{size_download} %{time_starttransfer}\n' -H 'Accept-Encoding: gzip' 'https://example.com/sample-page/?gclid=EXAMPLE1'
ls -l --time-style='+%F %T' wp-content/cache/wp-rocket/example.com/sample-page/
curl -s -o /dev/null -w '%{size_download} %{time_starttransfer}\n' -H 'Accept-Encoding: gzip' 'https://example.com/sample-page/'

21361 0.366881
合計 116
-rw-r--r-- 1 example nobody 90908 2026-10-17 23:56:38 index-https.html
-rw-r--r-- 1 example nobody 21385 2026-10-17 23:56:38 index-https.html_gzip
21385 0.025379

ls -l --time-style='+%F %T' wp-content/cache/wp-rocket/example.com/sample-page/

合計 3520
-rw-r--r-- 1 example nobody 1445922 2026-10-17 14:07:44 index-https.html
-rw-r--r-- 1 example nobody  350668 2026-10-17 14:07:44 index-https.html_gzip
-rw-r--r-- 1 example nobody 1446862 2026-10-17 14:07:47 index-mobile-https.html
-rw-r--r-- 1 example nobody  351042 2026-10-17 14:07:47 index-mobile-https.html_gzip

curl -s --compressed 'https://example.com/sample-page/?gclid=test123' | tail -c 200

n/1/wp-content/uploads/example-plugin/style.css' media='all' /></noscript></body>
</html>
<!-- Cached for great performance - Debug: cached@1792213663 -->