README

存档项目

由于不再接受积极开发，该项目自 2024 年 8 月起已存档。此 SDK 工具和相关项目中提供的基础架构仍然有效，并将在 Pantheon AGCDN 上继续工作。然而，我们将不会对问题或拉取请求做出回应，也不会对这些工具进行更多开发。

欢迎来到 Pantheon Edge Integrations Drupal SDK！

此存储库是集成您的 Drupal 网站与我们的边缘集成工具集的一站式商店。

架构

以下图表说明了此 SDK 提供的总体概述以及各个组件如何相互配合。

描述

Edge Integrations Drupal SDK 由几个组件组成，除了存储在此存储库中的文档外，当您在 Drupal 项目根目录中通过 composer require 项目时，所有这些组件都将自动安装。

Pantheon 高级全局 CDN

边缘集成始于“边缘”本身，这是在浏览器中渲染页面之前的最后一个停顿点，即 CDN 层。Pantheon 的高级全局 CDN 在我们的 AGCDN 平台上启用了 Varnish 配置规则，允许地理位置信息和兴趣跟踪数据在 CDN 之间来回发送，从而实现针对由这些参数个性化内容进行 CDN 缓存。AGCDN 是 Pantheon Edge Integrations 的第一步，使我们能够渲染个性化页面的缓存版本。

Pantheon Edge Integrations 全局库

Pantheon Edge Integrations 全局库允许开发人员与 CDN 发送的头部数据进行交互。这是一个低级接口，简化了与 CDN 通信和解释来自 CDN 的头部的过程。需要注意的是，边缘集成库被构建为一个通用、CMS 通用 PHP 包，并且用作 WordPress 和 Drupal 实现的基础。

智能内容 CDN

Smart Content CDN 使用 Smart Content 提供的接口以及 Pantheon Edge Integrations 库启用的头部数据交互来处理 CDN 和 CMS 之间的双向通信，以通过地理位置或兴趣渲染个性化内容。

智能内容预览

Smart Content Preview 允许预览和测试使用智能内容创建的块。在这种情况下，这允许网站管理员在前端预览基于地理位置或兴趣的内容。此模块目前仍在开发中。

设置

将边缘集成支持添加到您的项目非常简单。

要开始，您只需要将此存储库作为依赖项添加。

composer require pantheon-systems/edge-integrations-drupal-sdk

该命令将此存储库及其所有相关文档添加到您的 /vendor 目录中，同时还包括一个全球、与CMS无关的PHP库，以便您能够立即开始使用。

此外，Composer建议使用智能内容CDN 作为Drupal个性化的可能实现方式。

如果您不需要本地文档，也可以使用Composer单独要求这些包（例如，使用 composer require pantheon-systems/smart-content-cdn 或 composer require pantheon-systems/pantheon-edge-integrations）。

已知问题

已知与内部页面缓存模块存在冲突。该模块在Pantheon环境中使用时不会提供任何好处，但可能被建议（或启用）用于某些模块。我们的建议是在Pantheon上禁用内部页面缓存模块，以确保与Edge Integrations的兼容性。《动态页面缓存》与Edge Integrations兼容，且不受相同的限制。

pantheon-systems / edge-integrations-drupal-sdk

维护者

详细信息