介绍(Introduction) 入门(Getting Started) 应用结构(Application Structure) 请求处理(Handling Requests) 关键概念(Key Concepts) 配合数据库工作(Working with Databases) 接收用户数据(Getting Data from Users) 显示数据(Displaying Data) 安全(Security) 缓存(Caching) RESTful Web 服务 开发工具(Development Tools) 测试(Testing) 高级专题(Special Topics) 小部件(Widgets) 助手类(Helpers)

HTTP 缓存

除了前面章节讲到的服务器端缓存外, Web 应用还可以利用客户端 缓存去节省相同页面内容的生成和传输时间。

通过配置 yii\filters\HttpCache 过滤器,控制器操作渲染的内容就能 缓存在客户端。yii\filters\HttpCache 过滤器仅对 GETHEAD 请求生效,它能为这些请求设置三种与缓存有关的 HTTP 头。

  • yii\filters\HttpCache::lastModified
  • yii\filters\HttpCache::etagSeed
  • yii\filters\HttpCache::cacheControlHeader

Last-Modified

Last-Modified 头使用时间戳标明页面自上次客户端缓存后是否被修改过。

通过配置 yii\filters\HttpCache::lastModified 属性向客户端发送 Last-Modified 头。该属性的值应该为 PHP callable 类型,返回的是页 面修改时的 Unix 时间戳。该 callable 的参数和返回值应该如下:

/**
 * @param Action $action 当前处理的操作对象
 * @param array $params “params” 属性的值
 * @return integer 页面修改时的 Unix 时间戳
 */
function ($action, $params)

以下是使用 Last-Modified 头的示例:

public function behaviors()
{
    return [
        [
            'class' => 'yii\filters\HttpCache',
            'only' => ['index'],
            'lastModified' => function ($action, $params) {
                $q = new \yii\db\Query();
                return $q->from('post')->max('updated_at');
            },
        ],
    ];
}

上述代码表明 HTTP 缓存只在 index 操作时启用。它会基于页面 最后修改时间生成一个 Last-Modified HTTP 头。当浏览器第一 次访问 index 页时,服务器将会生成页面并发送至客户端浏览器。 之后客户端浏览器在页面没被修改期间访问该页,服务器将不会重新 生成页面,浏览器会使用之前客户端缓存下来的内容。因此服务端 渲染和内容传输都将省去。

ETag

“Entity Tag”(实体标签,简称 ETag)使用一个哈希值表示页面内容。如果页面 被修改过,哈希值也会随之改变。通过对比客户端的哈希值和服务器端生成的哈 希值,浏览器就能判断页面是否被修改过,进而决定是否应该重新传输内容。

通过配置 yii\filters\HttpCache::etagSeed 属性向客户端发送 ETag 头。该属性的值应该为 PHP callable 类型,返回的是一段种 子字符用来生成 ETag 哈希值。该 callable 的参数和返回值应该如下:

/**
 * @param Action $action 当前处理的操作对象
 * @param array $params “params” 属性的值
 * @return string 一段种子字符用来生成 ETag 哈希值
 */
function ($action, $params)

以下是使用 ETag 头的示例:

public function behaviors()
{
    return [
        [
            'class' => 'yii\filters\HttpCache',
            'only' => ['view'],
            'etagSeed' => function ($action, $params) {
                $post = $this->findModel(\Yii::$app->request->get('id'));
                return serialize([$post->title, $post->content]);
            },
        ],
    ];
}

上述代码表明 HTTP 缓存只在 view 操作时启用。它会基于用户 请求的标题和内容生成一个 ETag HTTP 头。当浏览器第一次访问 view 页时,服务器将会生成页面并发送至客户端浏览器。之后 客户端浏览器标题和内容没被修改在期间访问该页,服务器将不会 重新生成页面,浏览器会使用之前客户端缓存下来的内容。 因此服务端渲染和内容传输都将省去。

ETag 相比 Last-Modified 能实现更复杂和更精确的缓存策略。 例如,当站点切换到另一个主题时可以使 ETag 失效。

复杂的 Etag 生成种子可能会违背使用 HttpCache 的初衷而引起 不必要的性能开销,因为响应每一次请求都需要重新计算 Etag。 请试着找出一个最简单的表达式去触发 Etag 失效。

注意:为了遵循 RFC 7232(HTTP 1.1 协议) , 如果同时配置了 ETagLast-Modified 头,HttpCache 将会同时 发送它们。并且如果客户端同时发送 If-None-Match 头 和 If-Modified-Since 头,则只有前者会被接受。

Cache-Control

Cache-Control 头指定了页面的常规缓存策略。可以通过配置 yii\filters\HttpCache::cacheControlHeader 属性发送相 应的头信息。默认发送以下头:

Cache-Control: public, max-age=3600

会话缓存限制器

当页面使 session 时,PHP 将会按照 PHP.INI 中所设置的session.cache_limiter 值自动发送一些缓存相关的 HTTP 头。这些 HTTP 头有可能会干扰你原本设置的 HttpCache 或让其失效。为了避免此问题,默认情况下 HttpCache 禁止 自动发送这些头。想改变这一行为,可以配置 yii\filters\HttpCache::sessionCacheLimiter 属性。该属性接受一个 字符串值,包括 publicprivateprivate_no_expire, 和 nocache。请参考 PHP 手册中的缓存限制器 了解这些值的含义。

SEO 影响

搜索引擎趋向于遵循站点的缓存头。因为一些爬虫的 抓取频率有限制,启用缓存头可以可以减少重复请求 数量,增加爬虫抓取效率(译者:大意如此,但搜索引擎的排名规则不了解,好的缓存策略应该是可以为用户体验加分的)。

在线
408