简介 intro

可以通过使用AEM as a Cloud Service SDK Dispatcher工具在global.vars中定义EXPIRATION_TIME变量来覆盖所有HTML/文本内容。

可以使用以下Apache mod_headers指令在更细粒度级别覆盖，包括独立控制CDN和浏览器缓存：

<LocationMatch "^/content/.*\.(html)$">
     Header set Cache-Control "max-age=200"
     Header set Surrogate-Control "max-age=3600"
     Header set Age 0
</LocationMatch>

在设置与宽正则表达式匹配的全局缓存控制标头或类似缓存标头时，请务必谨慎，以免将它们应用于必须保持私密的内容。 请考虑使用多个指令，以确保以细粒度应用规则。 这样一来，如果AEM as a Cloud Service检测到缓存标头已应用于它检测到无法由Dispatcher缓存的内容，则会删除该缓存标头，如Dispatcher文档中所述。 要强制AEM始终应用缓存标头，可以按如下方式添加​ always ​选项：

<LocationMatch "^/content/.*\.(html)$">
     Header unset Cache-Control
     Header unset Expires
     Header always set Cache-Control "max-age=200"
     Header set Age 0
</LocationMatch>

确保src/conf.dispatcher.d/cache下的文件具有以下规则（默认配置中的规则）：

/0000
{ /glob "*" /type "allow" }

若要防止在CDN 处缓存 ​特定内容，请将Cache-Control标头设置为​ private。 例如，以下内容将阻止在CDN上缓存名为​ secure ​的目录下的html内容：

   <LocationMatch "/content/secure/.*\.(html)$">.  // replace with the right regex
   Header unset Cache-Control
   Header unset Expires
   Header always set Cache-Control "private"
  </LocationMatch>

虽然未在CDN中缓存设置为私有的HTML内容，但如果配置了权限敏感型缓存，则可以在Dispatcher中缓存该内容，从而确保仅授权用户提供该内容。

避免使用User-Agent作为Vary标头的一部分。 旧版默认Dispatcher设置（在原型版本28之前）包含该变量，Adobe建议您使用以下步骤将其删除。

• 在<Project Root>/dispatcher/src/conf.d/available_vhosts/*.vhost中找到vhost文件
• 从所有vhost文件中删除或注释掉行： Header append Vary User-Agent env=!dont-vary，但default.vhost除外，其为只读

使用Surrogate-Control标头独立于浏览器缓存控制CDN缓存

请考虑应用stale-while-revalidate和stale-if-error指令以允许后台刷新并避免缓存丢失，从而为用户保持内容的快速刷新。

• 可以使用多种方法应用这些指令，但将30分钟的stale-while-revalidate添加到所有缓存控制标头是一个很好的起点。

下面是各种内容类型的示例，在设置自己的缓存规则时，可参考这些示例。 请仔细考虑并测试您的特定设置和要求：

• 缓存可变的客户端库资源达12小时，12小时后进行后台刷新。

  code language-none
  <LocationMatch "^/etc\.clientlibs/.*\.(?i:json|png|gif|webp|jpe?g|svg)$"> Header set Cache-Control "max-age=43200,stale-while-revalidate=43200,stale-if-error=43200,public" "expr=%{REQUEST_STATUS} < 400" Header set Age 0 </LocationMatch>

• 通过后台刷新缓存不可变的客户端库资源长期（30天）以避免丢失。

  code language-none
  <LocationMatch "^/etc\.clientlibs/.*\.(?i:js|css|ttf|woff2)$"> Header set Cache-Control "max-age=2592000,stale-while-revalidate=43200,stale-if-error=43200,public,immutable" "expr=%{REQUEST_STATUS} < 400" Header set Age 0 </LocationMatch>

• 在浏览器上缓存5分钟HTML页，后台刷新一小时，在CDN上缓存12小时。 将始终添加Cache-Control标头，因此请务必确保在/content/*下与html页面匹配的页面是公共的。 如果不能，请考虑使用更具体的正则表达式。

  code language-none
  <LocationMatch "^/content/.*\.html$"> Header unset Cache-Control Header always set Cache-Control "max-age=300,stale-while-revalidate=3600" "expr=%{REQUEST_STATUS} < 400" Header always set Surrogate-Control "stale-while-revalidate=43200,stale-if-error=43200" "expr=%{REQUEST_STATUS} < 400" Header set Age 0 </LocationMatch>

• 将内容服务/Sling模型导出程序json响应缓存五分钟，在浏览器上后台刷新一小时，在CDN上后台刷新十二小时。

  code language-none
  <LocationMatch "^/content/.*\.model\.json$"> Header set Cache-Control "max-age=300,stale-while-revalidate=3600" "expr=%{REQUEST_STATUS} < 400" Header set Surrogate-Control "stale-while-revalidate=43200,stale-if-error=43200" "expr=%{REQUEST_STATUS} < 400" Header set Age 0 </LocationMatch>

• 通过后台刷新来缓存核心图像组件中的不可变URL，以使其保持长期（30天）不变，从而避免MISS。

  code language-none
  <LocationMatch "^/content/.*\.coreimg.*\.(?i:jpe?g|png|gif|svg)$"> Header set Cache-Control "max-age=2592000,stale-while-revalidate=43200,stale-if-error=43200,public,immutable" "expr=%{REQUEST_STATUS} < 400" Header set Age 0 </LocationMatch>

• 将来自DAM的可变资源（如图像和视频）缓存24小时，并在12小时后进行后台刷新以避免遗漏。

  code language-none
  <LocationMatch "^/content/dam/.*\.(?i:jpe?g|gif|js|mov|mp4|png|svg|txt|zip|ico|webp|pdf)$"> Header set Cache-Control "max-age=43200,stale-while-revalidate=43200,stale-if-error=43200" "expr=%{REQUEST_STATUS} < 400" Header set Age 0 </LocationMatch>

当必须保证每个事件时（例如，与需要准确知识的外部系统同步），需要SCD API。 如果在失效调用时存在发布层升级事件，则当每个新发布处理失效时，将引发一个额外事件。

使用复制API不是常见用例，但可用于以下情况：使缓存失效的触发器来自发布层，而不是创作层。 如果配置了Dispatcher TTL，此方法可能很有用。