plone.app.caching

简介

此包为Plone提供用户界面和默认规则，用于管理Plone中的HTTP响应缓存。它基于z3c.caching、plone.caching和plone.cachepurging。

兼容性

安装

plone.app.caching是作为Plone包的依赖项提供的，因此它应该在所有Plone安装上可用，但缓存默认是未启用的，尽管强烈建议为每个新的Plone站点配置缓存。

在创建新的Plone站点后，转到站点设置，然后转到插件并安装HTTP缓存支持。

在“高级”标题下，查找缓存控制面板——目前仅在经典UI上受支持。

故障排除

当缓存控制面板不存在时，可能存在各种原因

• 如果您的安装没有加载Plone包，而只有Products.CMFPlone，则不包含plone.app.caching。
• 如果包已包含，但您使用高级表单添加Plone站点并禁用缓存，则控制面板将不存在。

如果您想在现有Plone站点中安装它

1. 请确保包在Plone实例中可用，通过添加plone.app.caching或Plone到您的安装中。
2. 从Plone站点设置转到ZMI（Zope管理界面）。
3. 转到portal_setup，然后转到“导入”选项卡。
4. 选择HTTP缓存支持配置文件，可能最简单的方法是通过id：profile-plone.app.caching:default。
5. 点击“导入所有步骤”。

源代码

贡献者，请阅读文档Plone核心开发的流程

源代码位于在GitHub上托管的Plone代码仓库。

此项目由

许可证

项目许可下GPLv2。

变更日志

4.0.0 (2024-09-24)

破坏性更改

• 将plone.app.caching导入步骤替换为后处理器。删除了导入步骤所需的plone.app.caching.txt通用设置标志文件。[maurits] #139

新功能

• 添加卸载配置文件。[maurits] #139

3.1.5 (2024-06-26)

错误修复

• 将Zope添加到依赖项。使用plone/meta更新配置文件。[maurits] #1

3.1.4 (2024-02-12)

错误修复

• 修复Dexterity内容图像缩放路径的清除。[erral] #136

内部

• 更新配置文件。[plone dev] cfffba8c

3.1.3 (2023-10-25)

错误修复

• 修复ETag的locked组件以区分不同的锁。@JeffersonBledsoe, @davisagli #122

3.1.2 (2023-06-16)

内部

• 更新配置文件。[plone dev] e08b1234, fb4615d7

测试

• 修复了与十年前的Expires处理器比较稳定时间的测试。[maurits] #127

3.1.1 (2023-05-15)

测试

• 将硬编码的测试日期更改为六月而不是五月，以暂时修复测试错误。请参阅问题127 <https://github.com/plone/plone.app.caching/issues/127>。需要在一个月内进行适当的修复。[maurits] #127

3.1.0 (2023-04-26)

新功能

• 将资源注册表的ETag更新为使用配置注册表的修改时间。此时间自Plone 6.0.4起设置。修复了问题93 <https://github.com/plone/plone.app.caching/issues/93>。[maurits] #93

3.0.5 (2023-04-14)

错误修复

• 修复拼写错误。[gforcada] #124

3.0.4 (2023-03-14)

错误修复

• 不要提Squid，但在描述中提CDN。[jensens] #119

内部

• 更新配置文件。[plone dev] 13d8d6c0, cbbcff93

3.0.3 (2023-02-22)

错误修复

• 声明依赖关系。[gforcada] #1

文档

• 将README和CHANGES转换为markdown。[ericof] #114

3.0.2 (2023-01-26)

错误修复

• 修复controlpanel中<select>的Bootstrap类。[petschki] (#112)
• 将测试的更改还原以与Zope安全修复兼容。我们必须有一个空字节，而不是文本，否则它是一个指示，表明我们在304状态中可能获得了错误的Content-Type。参见Zope问题1089 <https://github.com/zopefoundation/Zope/issues/1089>_. [maurits] (#1089)

3.0.1 (2022-12-21)

错误修复

• 修复测试以与Zope安全修复兼容。 [maurits] (#106)

3.0.0 (2022-11-14)

错误修复

• 在Etag 304响应中添加缺少的引号 [sverbois] (#104)

3.0.0b2（2022-07-20）

错误修复

• 删除尾随逗号以避免同一msgid有不同的默认消息 [erral] (#102)

3.0.0b1（2022-06-23）

错误修复

• 添加缺少的i18n标签 [erral] (#101)

3.0.0a14（2022-05-15）

破坏性更改

• 删除不再维护的Split-View配置文件。 [jensens] (#99)

新功能

• 将缓存规则集分配从此处移动到plone.restapi，并在此处添加ZCML功能。 [jensens] (#100)

错误修复

• 微调，使用plone.base，删除一些Plone 5.2导入，... [jensens] (#98)
• 微小的代码清理和审查/重构文档。 [jensens] (#99)

3.0.0a13（2022-04-05）

错误修复

• 将black应用于代码库，格式化为仅Python 3。 (#94)

3.0.0a12（2022-04-04）

错误修复

• 测试修复：在不再存在的portal_resources中检查timestamp.txt缓存。相应地更新ETAG头。 [pbauer] (#92)

3.0.0a11（2022-02-24）

错误修复

• 更新控制面板图标。使用iconresolver获取正确的svg图标。 [yurj] (#91)

3.0.0a10（2021-12-01）

新功能

• 当清除图像时，清除不带大小参数的字段（例如[...]/@@images/image）。 [wolbernd] (#89)

3.0.0a9（2021-11-23）

错误修复

• 删除没有正确固件的翻译端点测试 [sneridagh] (#87)

3.0.0a8（2021-10-22）

错误修复

• 修复过时的导入 [petschki] (#86)

3.0.0a7（2021-10-13）

错误修复

• 修复controlpanel.pt中的标签。 [brian.duncan] (#84)

3.0.0a6（2021-09-15）

错误修复

• 添加升级步骤以定义新的基本简短缓存设置。 [maurits] (#82)

3.0.0a5（2021-09-01）

新功能

• 为布局属性添加ETag。这尚未添加到缓存配置文件中，但以后可以这样做。修复问题80 <https://github.com/plone/plone.app.caching/issues/80>_. [maurits] (#80)

3.0.0a4（2021-05-14）

错误修复

• 修复二进制文件的ram缓存。 [agitator] (#79)

3.0.0a3（2021-02-25）

破坏性更改

• 针对Plone 6更新，使用Bootstrap标记 [ale-rt, jensens] (#63)

错误修复

• 带有pat-modal的链接：从data-pat-modal actionOptions中删除未使用的redirectOnResponse。（Products.CMFPlone#3197） [fulv] (#3197)

3.0.0a2（2021-02-02）

新功能

• 恢复resourceRegistries ETag，但现在为Plone 5资源注册表。修复警告“无法找到ETag组件resourceRegistries的值适配器”。 [maurits] (#61)

错误修复

• 为图像和下载添加更多清除路径 [jensens] (#71)

3.0.0a1（2020-12-03）

破坏性更改

• 删除Archetypes的痕迹 [pbauer] (#68)
• 停止支持Python 2。Black代码风格和isort。 [jensens] (#69)

新功能

• 引入terseCaching操作和plone.content.dynamic规则集。terseCaching是一个默认在浏览器缓存中10秒、在边缘缓存中60秒的规则。它旨在用于在plone.content.dynamic规则集中定义的高度动态内容。这种组合可以在有大量请求时减少后端负载。 [jensens] (66-1)
• 支持plone.restapi。为匿名可访问的端点定义cache:ruleset分配。注意：除非plone.restapi放弃内容协商，否则依赖于Vary头。后一种可能与不支持Vary头的边缘缓存发生冲突。 [jensens] (66-2)

2.0.8 (2020-10-30)

错误修复

• 不要假设request或request.URL是字符串。它可能为None。 [jensens, iham] (#59)
• 删除过时的代理配置示例。请查看plone.recipe.varnish以获取出色的示例！ [jensens] (#64)

2.0.7 (2020-09-28)

错误修复

• 修复无效的转义序列。 [maurits] (#3130)

2.0.6 (2020-06-24)

新功能

• 如果If-Range条件不满足，则从请求中删除Range。 [mamico] (#58)

2.0.5 (2020-04-20)

错误修复

• 较小的打包更新。 (#1)

2.0.4 (2020-02-20)

错误修复

• 清除行为字段（例如主图像）的图像比例。 [ksuess] (#55)

2.0.3 (2019-09-13)

错误修复

• 修复手动清除页面上的Python 3相关编码错误。 [agitator] (#51)

2.0.2 (2019-04-10)

错误修复

• 修复拼写错误 [vincentfretin] (#47)
• 修复控制面板以兼容Python 3 [petschki] (#48)

2.0.1 (2019-03-03)

错误修复

• 删除内容时只调用一次 Purge()，而不是3次 [skurfer] 更可靠地检测和忽略内容创建 [skurfer] 当某个对象发生变化时，同时清除父对象（因为父对象可能显示一个包含被修改项的列表） [skurfer] (#37)

2.0.0 (2019-02-08)

破坏性更改

• 删除了旧版资源注册表 [ksuess] (#45)

1.2.23 (2018-12-28)

错误修复

• 如果在清除时禁用了缓存，则在保存后发出警告。 [jensens]

清理

• 清理旧代码 处理旧版资源注册表 Products.ResourceRegistries 已移除 [ksuess]

1.2.22 (2018-09-23)

新功能

• 支持 Python 3 [pbauer, MatthewWilkes, ale-rt]

1.2.21 (2018-04-03)

新功能

• 在 ZCML 文件中也使用 plone 作为 i18n 域 [erral]

• 使用 plone 作为 i18n 域 [erral]

错误修复

• 修复 i18nstring 中的反斜杠转义（poedit 抱怨）。 [jensens]

1.2.20 (2018-02-05)

新功能

• 为 Python 2/3 兼容性做准备 [b4oshany, davilima6]

1.2.19 (2017-11-24)

新功能

• 清除自定义 dexterity 内容类型中的所有图像缩略图路径和文件路径。 [karalics]

1.2.18 (2017-04-08)

错误修复

• 修复了 per ruleset 参数的空白编辑表单。 问题 1993 <https://github.com/plone/Products.CMFPlone/issues/1993>_. [maurits]

1.2.17 (2017-04-02)

错误修复

• 修复了资源强缓存规则中最大年龄的标题和描述。它们错误地与共享最大年龄相同。修复了 问题 1989 <https://github.com/plone/Products.CMFPlone/issues/1989>_. [maurits]

1.2.16 (2017-03-23)

错误修复

• 修复：如果没有 Archetypes，则不会破坏 Plone。 [jensens]

1.2.15 (2017-01-12)

错误修复

• 删除对 unittest2 的依赖；修复测试断言。 [hvelarde]

• 修复了使用 ZODB 4 时的测试。 [davisagli]

1.2.14 (2016-11-18)

错误修复

• 更新代码以遵循 Plone 风格指南。 [gforcada]

1.2.13 (2016-10-05)

错误修复

• 代码风格：isort，utf8-headers，zca-decorators，手动清理。 [jensens]

1.2.12 (2016-09-16)

错误修复

• 通过使用模式类 pat-formunloadalert 而不是 enableUnloadProtection 来启用卸载保护。 [thet]

1.2.11 (2016-08-17)

修复

• 使用 plone.namedfile 作为测试图像。 [didrix]

• 使用 zope.interface 装饰器。 [gforcada]

1.2.10 (2016-03-29)

新增

• 如果同步清除为错误状态，则显示状态。 [maurits]

1.2.9 (2016-02-19)

修复

• 修复测试中的过时导入。 [thet]

1.2.8 (2015-11-28)

修复

• 更新所有控制面板中的站点设置链接。修复 https://github.com/plone/Products.CMFPlone/issues/1255 [davilima6]

1.2.7 (2015-09-09)

• 修复缓存设置模式设置，使其在保存时不显示内容。 [vangheem]

1.2.6 (2015-07-18)

• 删除 gzip 选项，在这一层做这件事是愚蠢的。 [vangheem]

• 将配置小部件的类别更改为 'plone-advanced' [sneridagh]

1.2.5 (2015-06-09)

• 正确创建站点根的清除路径，防止双斜杠，以及空站点根（无尾斜杠）不生成清除路径 [vangheem]

1.2.4 (2015-06-05)

• 更新第一次在这里警告 [vangheem]

• 使控制面板同时适用于 plone 4 和 plone 5 并使用选项卡 [vangheem]

1.2.3 (2015-05-04)

• 修复了 getObjectDefaultView 方法，以删除开头的 / 和/ 或 @@。 [alecghica]

• 修复了控制面板中用于手动清除 URL 的 portalPath。此错误导致很少进行所需的全部清除。 [puittenbroek]

1.2.2 (2014-10-23)

• 从门户消息模板中删除 DL。 https://github.com/plone/Products.CMFPlone/issues/153 [khink]

• 修复规则集注册测试的隔离，使其不再依赖于顺序。 [jone]

1.2.1 (2014-04-01)

• 修复了在夏令时切换前一天失败的测试。 [pbauer]

1.2.0 (2014-02-26)

• 使用 PLONE_APP_CONTENTTYPES_FIXTURE 测试层以实现 Plone 5 兼容性。 [timo]

1.1.7 (未发布)

• 在强缓存中设置最大年龄为零。这是一个边缘情况，因为这通常由适度缓存处理。 [smcmahon]

• 添加一些针对弱缓存操作的测试。 [smcmahon]

• 修复了对 maxage 不为零的情况的匿名标志的处理。它实际上被忽略了。添加了针对强缓存的操作测试。 [smcmahon]

1.1.6 (2013-08-14)

• 修复了默认视图与 /view 相同时路径的双重清除问题 [eleddy]

1.1.5 (2013-08-13)

• 在安装 Products.Archetypes 和 plone.app.blob 时注册 plone.atobjectfields 适配器。 [thet]

1.1.4 (2013-06-13)

• 修复了使用虚拟路径组件的虚拟主机场景中的清除路径。 [dokai]

1.1.3 (2013-03-05)

• 为新用户提供消息，建议导入预定义的缓存规则集。 [vangheem]

1.1.2 (2012-12-27)

• 将其他馈送类型添加到plone.content.feed清除策略中 [vangheem]

• 修复了一个错误，当资源注册表中缺少注册表时，etag计算不正确。 [davisagli]

• 修复了错误 12038 <http://dev.plone.org/ticket/12038>。如果transformIterable在'result'可迭代对象上迭代，则必须返回一个新的对象。 [ebrehault]

1.1.1 (2012-08-30)

• 目前还没有任何变化。

1.1 (2012-05-25)

• 使用zope.browserresource代替zope.app.publisher。 [hannosch]

• 在测试中替换了已弃用的方法别名。 [hvelarde]

1.0.4（未发布）

• 通过使用用户名登录来修复可能出现的测试失败。注意，用户ID和用户名（登录名）可能不同。 [maurits]

1.0.3 (2012-04-15)

• 修复了打包问题。 [esteele]

1.0.2 (2012-04-15)

• 通过不在RAMCache中存储空体来处理资源注册表的RAM缓存。 [eleddy，主要得到tseaver的支持]

1.0.1 (2012-01-26)

• 通过强制页面刷新，正确处理从etag到无etag的配置更改。 [eleddy]

• 在不使用etag缓存时，不要发送etag标头以停止缓存。 [eleddy]

• 当出现如未经授权的错误时，200状态和空体会被存储在RAMCache中而不是不缓存任何内容。这是由于Zope 2.13发布事件中的一个bug：当IPubBeforeAbort被通知时，response.status不会被设置。通过使用plone.transformchain在请求中存储的error_status来修复。 [gotcha]

• 为规则集的标题和描述添加了12个翻译字符串。相应的翻译字符串已添加到PloneTranslations中的plone.app.caching-manual.pot。 [giacomos]

• 为缓存配置文件的标题和描述添加了6个翻译字符串。相应的翻译字符串已添加到PloneTranslations中的plone.app.caching-manual.pot。 [giacomos]

• 在messagefactory中更改了错误的i18n域。plone.caching -> plone.app.caching。 [giacomos]

1.0 (2011-05-12)

• 在默认配置中使用userLanguage ETag组件代替语言ETag组件，以允许匿名用户使用缓存。 [elro]

• 将SERVER_URL添加到RAM缓存键中。 [elro]

• 将plone.namedfile.scaling.ImageScale声明为plone.stableResource。 [elro]

• 添加MANIFEST.in。 [WouterVH]

• 修复了由于HTTP状态不再包含在响应头中而导致在Zope 2.13上失败的测试。 [davisagli]

• 为FSPageTemplate添加了ILastModified适配器，因为FSObject适配器否则将具有优先权。 [stefan]

1.0b2（2011-02-10）

• 将新闻条目添加到purgedContentTypes列表中，因此图像字段及其缩略图将得到清除。 [stefan，hannosch]

• 默认情况下将file_view、image_view和image_view_fullscreen与plone.content.itemView规则集关联，因为它们都不是它们各自内容类型的默认视图，因此它们没有获得自动处理。 [stefan，hannosch]

• 为plone.app.blob的BlobFields添加了清除。 [stefan，hannosch]

• 修复了文档，使其引用正确的resourceRegistries而不是单数形式。 [stefan，hannosch]

• 使用plone.registry FieldRefs来管理参数覆盖。这需要plone.app.registry 1.0b3以及plone.app.registry 1.0b3或更高版本。 [optilude]

• 更新分发元数据以符合当前最佳实践。 [hannosch]

• 添加了一个etag组件来跟踪复制/剪切cookie的存在。 [newbery]

• 修复了各种i18n问题。 [vincentfretin]

1.0b1（2010-08-04）

• 将“仅匿名用户”缓存选项添加到默认操作中。这是一个关闭已登录用户缓存的简单方法。有关更多详细信息，请参阅README。 [optilude]

• 如果已安装plone.namedfile，则添加基本的plone.namedfile缓存规则。 [optilude]

• 根据门户类型类/接口以及名称执行查找，并为项目和文件夹设置默认值。 [optilude]

• 为cmf.pt兼容性进行了模板修复。 [pilz]

1.0a1（2010-04-24）

• 初始发布。 [optilude，newbery，smcmahon]