📘 תיעוד 105

כללי תגובת מטמון

כללי תגובת מטמון מאפשרים להגדיר הגדרות מטמון על בסיס מאפייני בקשה ותגובה. כללים אלה רצים לפני השמירה במטמון בשלב http_response_cache_settings, שרץ אחרי ש-Cloudflare מקבלת את תגובת המקור.

הערה

כללי תגובת מטמון מעריכים את הבקשה כפי שהיא נשלחת למקור. אם כלל מקור משכתב את כותרת Host, ביטויים שמתאימים ל-http.host חייבים להשתמש בשם המארח המשוכתב. כלל המטמון המקביל עדיין רואה את שם המארח המקורי, כי כללי מטמון רצים לפני שכללי מקור מוחלים.

עם כללי תגובת מטמון אפשר:

• לשנות הנחיות Cache-Control שהמקור שולח.
• לשנות תגי מטמון בתגובות לצורך טיהור מטמון ממוקד.
• להסיר כותרות (ETag, Set-Cookie, Last-Modified) מתגובות המקור לפני השמירה במטמון.

כללי תגובת מטמון חלים גם על תגובות שמורות במטמון וגם על תגובות לא שמורות במטמון (דינמיות) מהמקור. לדוגמה, אפשר להסיר כותרות Set-Cookie מתגובות שאינן זכאיות לשמירה במטמון.

אפשר ליצור כללי תגובת מטמון בלוח הבקרה, דרך API, או Terraform.

הערה

כללי תגובת מטמון דורשים לנתב דרך פרוקסי את רשומות ה-DNS של הדומיין (או תת הדומיין) דרך Cloudflare.

#זמינות

הטבלה הבאה מתארת את זמינות כללי תגובת המטמון לפי תוכנית.

#פתרון בעיות

בזמן פתרון בעיות בכללי תגובת מטמון, השתמשו במדמה כללים כדי לקבוע אם כלל מופעל עבור כתובת URL מסוימת.

#קשר לכללי מטמון

כללי תגובת מטמון פועלים על תגובת המקור, בעוד כללי מטמון פועלים על הבקשה הנכנסת. כשהגדרות משני סוגי הכללים מתנגשות, לכללי תגובת מטמון יש עדיפות.

הבדלים מרכזיים:

• זכאות למטמון: כללי מטמון נשארים המנגנון היחיד להחלטה אם תוכן זכאי לשמירה במטמון. עם זאת, כללי תגובת מטמון יכולים להפוך נכס שניתן לשמור במטמון לנכס שאינו ניתן לשמירה במטמון, על ידי הגדרת הנחיית no-store באמצעות הפעולה set_cache_control.
• בקרת מטמון מקור (OCC): אם כלל כלשהו בשלב http_response_cache_settings תואם, Cloudflare עוברת כברירת מחדל להתנהגות Origin Cache Control (origin_cache_control = true).
• עדיפות CDN-Cache-Control: הנחיות Cache-Control שמוגדרות על ידי כללי תגובת מטמון גוברות על כותרות Cloudflare-CDN-Cache-Control ו-CDN-Cache-Control שהוגדרו במקור. למידע נוסף, ראו עדיפות כותרת CDN-Cache-Control.
• הערמה: כללי תגובת מטמון נערמים באותו אופן כמו כללי מטמון. כשמספר כללים מציינים את אותה הגדרה, הכלל התואם האחרון מנצח.

#דוגמה: עדיפות OCC על Edge TTL

שקלו את התרחיש הבא:

1. כלל מטמון מגדיר Edge TTL ל-override_origin עם ערך של 7200 שניות (שעתיים).
2. כלל תגובת מטמון משתמש ב-set_cache_control כדי להגדיר s-maxage ל-3600 שניות (שעה אחת) עם cloudflare_only מופעל.
3. המקור מגיב עם Cache-Control: s-maxage=600.

במקרה זה, לכלל תגובת המטמון יש עדיפות. Cloudflare שומרת את הנכס במטמון למשך 3600 שניות (שעה אחת) על בסיס הנחיית s-maxage שהוגדרה על ידי כלל תגובת המטמון, בעוד המבקרים עדיין מקבלים את s-maxage=600 המקורי מהמקור כי cloudflare_only מופעל.

#ההבדל מ-Workers ומכללי המרה

Workers וכללי המרת כותרות תגובה רצים אחרי שהתקבלה החלטת המטמון, ואינם יכולים להשפיע על האם או כיצד תגובה נשמרת במטמון. רק כללי תגובת מטמון יכולים לשנות התנהגות מטמון על בסיס כותרות תגובת המקור.

אם צריך לעקוף הנחיות Cache-Control מהמקור (לדוגמה, להסיר private או להוסיף s-maxage), השתמשו בכלל תגובת מטמון, ולא ב-Worker או בכלל המרה.

#הערות

• אם מסירים last modified, אז Smart Edge Revalidation יכובה.
• כללי תגובת מטמון מתעלמים מקודי סטטוס HTTP 1xx כי הם מטופלים כתגובות מידע.
• אפשר לנהל גרסאות של כללי תגובת מטמון. למידע נוסף ראו את תיעוד ניהול גרסאות.