Title: Purgely
Author: Zack Tollman
Published: <strong>2016 年 1 月 11 日</strong>
Last modified: 2016 年 6 月 15 日

---

搜索插件

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

![](https://s.w.org/plugins/geopattern-icon/purgely.svg)

# Purgely

 作者：[Zack Tollman](https://profiles.wordpress.org/tollmanz/)

[下载](https://downloads.wordpress.org/plugin/purgely.1.0.1.zip)

 * [详情](https://cn.wordpress.org/plugins/purgely/#description)
 * [评价](https://cn.wordpress.org/plugins/purgely/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/purgely/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/purgely/#developers)

 [支持](https://wordpress.org/support/plugin/purgely/)

## 描述

Purgely manages caching behavior for WordPress sites using Fastly as an edge caching
solution. The plugin exposes useful
 APIs to help control how pages on your site
are cached, as well as provides sane defaults to make this a plug and play solution
for Fastly cache management.

The plugin handles the following:

 * Sets the `Surrogate-Control` header to control the expiration time for pages
 * Sets the `stale-while-revalidate` and `stale-if-error` `Cache-Control` directives
   for managing these special Fastly
    behaviors
 * Set groups of `Surrogate-Keys` for all pages to provide purging across multiple
   pages with one command
 * Provides invalidation of posts and related posts on save

Each of these items have sane defaults with ways to override them and configure 
them to your liking.

Additionally, the plugin exposes a WP CLI command to provide more flexible purging
options.

## 安装

### 手动安装

 1. Upload the plugin directory to `/wp-content/plugins/`
 2. 通过WordPress的的“Plugins”菜单激活插件

### WP CLI installation

 1. Run `wp plugin install --activate purgely`

### 配置

Purgely provides a number of constants that can be used to control the behavior 
of the plugin and Fastly’s cache. Users
 who wish to change these values should 
define the constants in `wp-config.php`.

After installing, you should define `PURGELY_FASTLY_KEY` and `PURGELY_FASTLY_SERVICE_ID`
in `wp-config.php`. The plugin will work without them; however, you will not be 
able to purge by surrogate key or purge all without configuring these options. To
define them copy the following code to your `wp-config.php` file, update the key
to use your key, and the service ID to match the fastly service you’re using:

    ```
    `
    ```

define( ‘PURGELY_FASTLY_KEY’, ’39c4820390d8f050giweda50268c7583′ );
 define( ‘PURGELY_FASTLY_SERVICE_ID’,‘
abcdefghijklmn1234567890’ ); `

Configuring other constants is similarly done by defining the constant in `wp-config.
php`. All constants are explained
 below.

**PURGELY_API_ENDPOINT**

Defines the API endpoint for Fastly. This should not usually need to be changed,
but is added in the event that Fastly
 decides to use a different API endpoint, 
or if there is a need for a user to have a special endpoint.

_default: (string) ”_

**PURGELY_ALLOW_PURGE_ALL**

Determines whether or not the plugin can issue a purge all request. Purge all can
have dire consequences for a website.
 As such, this behavior is disabled by default.
If can be turned on by setting this value to `true`.

_default: (bool) false_

**PURGELY_ENABLE_STALE_WHILE_REVALIDATE**

Determines whether or not the plugin sets the `stale-while-revalidate` directive
for the `Cache-Control` header. Setting
 this value to `false` will turn off the`
stale-while-revalidate` behavior. Note that you can manually control this behavior
via the functions exposed in the plugin regardless of this configuration option.
This option only controls the default plugin behavior.

_default: (bool) true_

**PURGELY_STALE_WHILE_REVALIDATE_TTL**

Sets the TTL for the `stale-while-revalidate` directive in seconds. The value instructs
Fastly to continue serving stale
 content while new content is generated for the
duration of the value that is set.

_default: (int) 86400_

**PURGELY_ENABLE_STALE_IF_ERROR**

Determines whether or not the plugin sets the `stale-if-error` directive for the`
Cache-Control` header. Setting
 this value to `false` will turn off the `stale-if-
error` behavior. Note that you can manually control this behavior via the functions
exposed in the plugin regardless of this configuration option. This option only 
controls the default plugin behavior.

_default: (bool) true_

**PURGELY_STALE_IF_ERROR_TTL**

Sets the TTL for the `stale-if-error` directive in seconds. The value instructs 
Fastly to continue serving stale
 content while the origin site is serving an error
for the duration of the value that is set.

_default: (int) 86400_

**PURGELY_SURROGATE_CONTROL_TTL**

Sets the TTL for the `Surrogate-Control` header in seconds. This value is the default
TTL for all pages on your site,
 unless it is cached within the app. Changing this
value changes the value for the whole site.

_default: (int) 300_

## 评价

![](https://secure.gravatar.com/avatar/778914d549e545a18f92dec2a5db45137baead95b17e472738a56c42a1627a21?
s=60&d=retro&r=g)

### 󠀁[Excellent cache handling](https://wordpress.org/support/topic/excellent-cache-handling/)󠁿

 [eightbits](https://profiles.wordpress.org/eightbits/) 2016 年 9 月 3 日

Sets surrogate keys based on all posts. Saved me a lot of time.

 [ 阅读所有1条评价 ](https://wordpress.org/support/plugin/purgely/reviews/)

## 贡献者及开发者

「Purgely」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Zack Tollman ](https://profiles.wordpress.org/tollmanz/)

[帮助将「Purgely」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/purgely)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/purgely/)，查看[SVN仓库](https://plugins.svn.wordpress.org/purgely/)，
或通过[RSS](https://plugins.trac.wordpress.org/log/purgely/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/purgely/)。

## 更新日志

#### 1.0.1

 * Update key saniziation to allow all capital letters, not just A-B.

#### 1.0.0

 * Initial release.

## 额外信息

 *  版本 **1.0.1**
 *  最后更新：**10 年前**
 *  活跃安装数量 **10+**
 *  WordPress 版本 ** 4.2.0 或更高版本 **
 *  已测试的最高版本为 **4.3.34**
 *  语言
 * [English (US)](https://wordpress.org/plugins/purgely/)
 * 标签
 * [cache invalidation](https://cn.wordpress.org/plugins/tags/cache-invalidation/)
   [caching](https://cn.wordpress.org/plugins/tags/caching/)[fastly](https://cn.wordpress.org/plugins/tags/fastly/)
   [page cache](https://cn.wordpress.org/plugins/tags/page-cache/)
 *  [高级视图](https://cn.wordpress.org/plugins/purgely/advanced/)

## 评级

 5 星（最高 5 星）。

 *  [  1 条 5 星评价     ](https://wordpress.org/support/plugin/purgely/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/purgely/reviews/?filter=4)
 *  [  0 条 3 星评价     ](https://wordpress.org/support/plugin/purgely/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/purgely/reviews/?filter=2)
 *  [  0 条 1 星评价     ](https://wordpress.org/support/plugin/purgely/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/purgely/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/purgely/reviews/)

## 贡献者

 *   [ Zack Tollman ](https://profiles.wordpress.org/tollmanz/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/purgely/)