PHP の API が no-store を返し、Cloudflare は素通しでした。エッジの TTL だけを上書きした設計メモ

# Cache Rules のエントリーポイント(http_request_cache_settings フェーズ)へ設定を入れる
# 注意: PUT はこのフェーズのルール全体を置き換える。先に現在の内容を保存してから実行する
ZONE=$CF_ZONE_ID
URL="https://api.cloudflare.com/client/v4/zones/$ZONE/rulesets/phases/http_request_cache_settings/entrypoint"
 
# 1) 変更前を必ず控える(戻し方を先に決めておく)
curl -sS "$URL" -H "Authorization: Bearer $CF_API_TOKEN" > before-cache-rules.json
 
# 2) 重い一覧だけを対象にしたルールを入れる
curl -sS -X PUT "$URL" -H "Authorization: Bearer $CF_API_TOKEN" \
  -H "Content-Type: application/json" --data '{
  "rules": [{
    "description": "list API: edge ttl only",
    "expression": "(http.host eq \"api.example.com\" and starts_with(http.request.uri.path, \"/v1/list\"))",
    "action": "set_cache_settings",
    "action_parameters": {
      "cache": true,
      "edge_ttl": { "mode": "override_origin", "default": 300 },
      "browser_ttl": { "mode": "respect_origin" }
    }
  }]
}'

// edge-ttl-check.mjs  使い方: node edge-ttl-check.mjs <URL> [回数] [間隔ms]
const [url, nArg = '4', waitArg = '1500'] = process.argv.slice(2);
if (!url) { console.error('URL を渡してください'); process.exit(2); }
const n = Number(nArg), wait = Number(waitArg);
const sleep = ms => new Promise(r => setTimeout(r, ms));
 
const rows = [];
for (let i = 1; i <= n; i++) {
  const t0 = performance.now();
  const res = await fetch(url, { cache: 'no-store', headers: { 'accept-encoding': 'identity' } });
  const body = await res.arrayBuffer();           // 本体まで読んで所要時間を測る
  rows.push({
    '#': i,
    status: res.status,
    'cf-cache-status': res.headers.get('cf-cache-status') ?? '(なし)',
    age: res.headers.get('age') ?? '-',
    'cache-control': res.headers.get('cache-control') ?? '(なし)',
    bytes: body.byteLength,
    ms: Math.round(performance.now() - t0),
  });
  if (i < n) await sleep(wait);
}
console.table(rows);
 
const hits = rows.filter(r => r['cf-cache-status'] === 'HIT').length;
if (rows.every(r => r['cf-cache-status'] === '(なし)')) {
  console.log('判定: cf-cache-status が付いていません。Cloudflare を通っていないか、別の層です。');
} else if (hits === 0) {
  console.log(`判定: ${n} 回とも HIT なし。応答が no-store 等で素通しされている可能性があります。`);
} else {
  console.log(`判定: ${n} 回中 ${hits} 回が HIT。エッジが応答を持っています。`);
}

#!/usr/bin/env bash
# publish-and-purge.sh  使い方: ./publish-and-purge.sh [--dry-run] <API のパス> ...
# アップロードが失敗したらパージへ進まない(set -e)
set -euo pipefail
 
DRY=0
if [ "${1:-}" = "--dry-run" ]; then DRY=1; shift; fi
[ "$#" -ge 1 ] || { echo "パージ対象のパスを 1 つ以上渡してください" >&2; exit 2; }
 
: "${API_ORIGIN:?例: https://api.example.com}"
: "${CF_ZONE_ID:?}"; : "${CF_API_TOKEN:?}"
 
# 1) アップロード(自分の配置コマンドに置き換える)
if [ "$DRY" -eq 1 ]; then echo "[dry-run] upload skipped"; else ./upload.sh; fi
 
# 2) パージ対象を URL にする。クエリ違いは別のキャッシュなので、アプリが叩く形をそのまま渡す
files=$(printf '"%s%s",' $(for p in "$@"; do echo "$API_ORIGIN" "$p"; done))
body="{\"files\":[${files%,}]}"
 
if [ "$DRY" -eq 1 ]; then echo "[dry-run] POST purge_cache $body"; exit 0; fi
 
# 3) success が true でなければ失敗として止める
out=$(curl -sS -X POST "https://api.cloudflare.com/client/v4/zones/${CF_ZONE_ID}/purge_cache" \
  -H "Authorization: Bearer ${CF_API_TOKEN}" -H "Content-Type: application/json" --data "$body")
echo "$out" | grep -q '"success":true' || { echo "パージ失敗: $out" >&2; exit 1; }
echo "パージ済み: $*"

Cloudflare の Cache Rule を 1 件だけ追加してください。
- 対象: api.example.com の /v1/list で始まるパスだけ
- Edge TTL は override_origin(300 秒)、Browser TTL は respect_origin
- 先に現在の entrypoint ruleset を before-cache-rules.json に保存すること
- PUT は既存ルールを置き換えるので、保存した rules を含めて送ること
- 実行後に edge-ttl-check.mjs を 4 回走らせ、cache-control の列が変わっていないことを報告すること
- 他のパスや他のゾーンには触れない