[HttpCacheSettings]
Available since Exponential 6.0.15 (in development, not in a release yet).
Summary
The group [HttpCacheSettings] of settings/httpcache.ini.
File
settings/httpcache.ini; override it in settings/override/httpcache.ini.append.php, in a siteaccess or in an extension.
Settings
| Setting | Default | Description |
|---|---|---|
| Enabled | disabled | enabled or disabled. The early exit and Velocity only serve what exists, and nothing is stored while this is disabled. |
| CachedSiteAccesses[] | site | Siteaccesses whose pages are cached. Matched by host, by URI (URIMatchType element or map) or by host and URI (host_uri); a siteaccess found by another rule (port, servervar, index, the text and regexp types) is never served early, since that cannot be known before the kernel starts. |
| MaxAge | 3600 | Seconds a cached page may be served at most, even if nothing purged it. |
| StaleWhileRevalidate | 60 | Seconds an expired (not purged) page may still be served, marked STALE, while one request renders it again. 0 serves nothing expired. |
| TagHeader | disabled | The purge tags of each page (its nodes, objects and layouts) in one response header, for a purging proxy in front that reads them, or to see them while debugging: xkey (Varnish xkey vmod), Surrogate-Key (Fastly), Cache-Tag (Cloudflare), or another header name. disabled (the default) sends none: the tags name internal ids, so no visitor should see them otherwise. ProxyHeaders=enabled, the setting before this one, still means xkey. |
| APCu | enabled | Keep hot entries in APCu in front of the files (when APCu is usable). |
| MaxBodySize | 2097152 | Largest page body, in bytes, that is stored. |
| QueryStringParameters[] | (empty array) | Query string parameters a cached page may carry. A request with any other parameter is not cached (every random query string would add an entry). Exponential passes view parameters in the path, /(offset)/10. |
| ContentChangePurges | all | What a content change purges. A whole page also holds what the view cache never did (the pagelayout's menus, layout blocks that run queries), and the tags of a change cannot name all of those yet. all - every cached page (safe; the default) tags - only pages tagged with the changed objects, their nodes and parents, and pages with layout blocks that run queries (their items are tagged) Changes made in the layout editor always purge every page. |
See also
Generated example: httpcache.ini [HttpCacheSettings]
Added to the reference for Exponential 6.0.15: the 4.x reference had no page for this group. The descriptions are the comment lines of settings/httpcache.ini.
Contributors
- Graham Brookins Updated
Comments
Add a comment