// web/app.php
require_once __DIR__.'/../app/bootstrap.php.cache';
require_once __DIR__.'/../app/AppKernel.php';
require_once __DIR__.'/../app/AppCache.php';
use Symfony\Component\HttpFoundation\Request;
$kernel = new AppKernel('prod', false);
$kernel->loadClassCache();
//使用AppCache包裹默认的AppKernel
$kernel = new AppCache($kernel);
$kernel->handle(Request::createFromGlobale())->send();

error_log($kernel->getLog());

// app/AppCache.php
use Symfony\Bundle\FrameworkBundle\HttpCache\HttpCache;
class AppCache extends HttpCache
{
  protected function getOptions()
  {
    return array(
      'debug'         => false,
      'default_ttl'      => 0,
      'private_headers'    => array('Authorization', 'Cookie'),
      'allow_reload'      => false,
      'allow_revalidate'    => false,
      'stale_while_revalidate' => 2,
      'stale_if_error'     => 60,
    );
  }
}

Cache-Control:private,max-age=0,must-revalidate
Cache-Control:max-age=3600,must-revalidate

$response = new Response();
// 标记response为public还是private
$response->setPublic();
$response->setPrivate();
// 设置private或者shared 的最大年龄 age
$response->setMaxAge(600);
$response->setSharedMaxAge(600);
// 设置一个自定义的Cache-Control 指令
$response->headers->addCacheControlDirective('must-revalidate', true);

$date = new DateTime();
$date->modify('+600 seconds');
$response->setExpires($date);

Expires: Thu, 01 Mar 2011 16:00:00 GMT

// 设置一个秒数，过了这个秒数后response就被认为是陈旧的了。
$response->setMaxAge(600);
// 同上，但是只用于共享缓存。
$response->setSharedMaxAge(600);
Cache-Control头将使用如下格式（它可能还有其它指令）：
Cache-Control: max-age=600, s-maxage=600

public function indexAction()
{
  $response = $this->render('MyBundle:Main:index.html.twig');
  $response->setETag(md5($response->getContent()));
  $response->isNotModified($this->getRequest());
  return $response;
}

public function showAction($articleSlug)
{
  //...
  $articleDate = new \DateTime($article->getUdateAt());
  $authorDate = new \DateTime($author->getUpdateAt());  $date = $authorDate>$articleDate "htmlcode">

public funcation showAction($articleSlug)
{
  //获取最小信息来计算ETag或者Last-Modified值（基于Request，数据是从数据库或者一个键值对存储实例中获取。
  $article = //...
  //创建一个Response带有一个ETag 和/或者 一个Last-Modified 头
  $response = new Response();
  $response->setETag($article->computeETag());
  $response->setLastModified($article->getPublishedAt());
  //为给定的Request检查Response没有被修改
  if($response->isNotModified($this->getRequest())){
    //立刻返回304 Response
    return $response;
  }else{
    //做一些更多的工作-比如获取更多的数据
    $comment=//...
    //或者用你已经开启的$response渲染一个模版
    return $this->render('MyBundle:MyController:article.html.twig',
        array('article'=>$article, 'comments' =>$comments),
        $response
    );
  }
}




当Response没有被修改后，isNotModified()自动设置response的状态码为304，移除response的内容，移除一些不需要为304存在的头。
不同的回复响应：
到目前为止，我们已经假设了每个URI只有一个目标资源的表示。默认情况下，HTTP缓存通过使用URI的资源作为缓存键被执行。如果两个人请求同一个可缓存资源的URI，第二个用户将获取缓存版本。有时候这些不够，不同版本的用一个URI需要被按照一个或者多个请求头的值来被缓存。举个例子，如果当客户端支持你压缩页面时，任何给定的URI都有两种表示：一个是客户端支持压缩时，一个是不支持时的表示。这时候请求头的Accept-Encoding值将决定使用哪个。
在这种情况下，我们需要回复的特定URI缓存一个压缩版本和一个非压缩版本，基于请求的Accept-Encoding值返回它们。这是通过Vary Response头，Vary是一个不同头用逗号分隔，它的值触发请求资源的不同表示。


Vary:Accept-Encoding,User-Agent




注意，这个特别的Vary头，将基于URI和Accept-Encoding和User-Agent 请求头为每个资源的不同版本进行缓存。
Response对象提供一个干净的接口来管理Vary 头：


// 设置一个vary 头
$response->setVary('Accept-Encoding');
// 设置多个vary头
$response->setVary(array('Accept-Encoding', 'User-Agent'));



setVary()方法需要一个头名字或者一个头名字数组对应不同的response。


过期和校验：


你当然可以在同一个Response中同时使用校验和过期。因为过期胜过校验，你可以轻易的从它们两个中根据好处做出选择。换句话说，通过同时使用过期和校验，你可以指示缓存服务于缓存的内容，同时后台间隔检查来调查内容是否依然合法。
更多Response方法：
Response类提供了许多和缓存相关的方法。下面是主要的一些：


// 标志Response过期陈旧
$response->expire();
// 强迫response返回一个适合 304 的没有内容的response
$response->setNotModified();




另外，跟缓存最相关的HTTP头可以被通过一个单独的方法setCache()设置。


// 通过一个调用设置缓存参数
$response->setCache(array(
  'etag'     => $etag,
  'last_modified' => $date,
  'max_age'    => 10,
  's_maxage'   => 10,
  'public'    => true,
  // 'private'  => true,
));




使用ESI（Edge Side Includes)
网关缓存是一个提高你网站执行效率的很好的途径。但是它们有一个限制：只能缓存整个页面。如果你不想缓存整个页面或者页面的某一部分很动态，你就没那么幸运了。
幸运的是，Symfony2为这些情况提供一个解决方案，基于ESI技术。它允许页面指定的部分和主页比起来有一个不同的缓存策略。
ESI规范描述标签你可以嵌入到你的页面来和网关缓存交流。Symfony2中只实现了一个标签，include, 因为这是唯一一个能在Akami上下文之外使用的标签。


<html>
  <body>
    Some content
    <!-- 嵌入一个其它页的内容 -->
    <esi:include src="/UploadFiles/2021-04-02/...">

从这个例子中注意到每个ESI标签有一个全限定URL。一个ESI标签表示可以通过一个给定的URL获取的一个页面片段。
当请求被处理时，网关缓存从它的缓存或者从背后的应用程序中请求回复获取整个页面。换句话说，网关缓存既从缓存中获取包含的页面片段也会再次从背后的应用程序中获取回复请求的页面片段。当所有的ESI标签被解析后，网关缓存合并每一个ESI内容到一个主页并返回最后的内容到客户端。所有的这一切都透明的发生在网关缓存级（在你的程序外）。你将看到，如果你选择ESI标签，Symfony2让这包含它们的这一过程几乎不费劲。
在Symfony2中使用ESI
首先，使用ESI需要确认在你的应用程序配置中已经打开。
YAML格式：


# app/config/config.yml
framework:
  # ...
  esi: { enabled: true }




XML格式：


<!-- app/config/config.xml -->
<framework:config ...>
  <!-- ... -->
  <framework:esi enabled="true" />
</framework:config>




PHP代码格式：


// app/config/config.php
$container->loadFromExtension('framework', array(
  // ...
  'esi'  => array('enabled' => true),
));




现在假设我们有一个页面时相对静态的，除了一个新闻自动收报机在内容的底部。使用ESI，我们可以缓存新闻自动收报机独立于页面其它部分。


public function indexAction()
{
  $response = $this->render('MyBundle:MyController:index.html.twig');
  $response->setSharedMaxAge(600);
  return $response;
}




在该示例中，我们给全页面缓存周期为10分钟。接下来，通过嵌入一个action让新闻ticker包含到模板中。这是通过render帮助来实现的。因为嵌入的内容来自其它页面，Symfony2使用一个标准的render帮助来配置ESI标签：
Twig格式：


{% render '...:news' with {}, {'standalone': true} %}




PHP格式：


<"htmlcode">

public function newsAction()
{
  //...
  $response->setShareMaxAge(60);
}




使用ESI，整个页面缓存将被保持600秒有效，但是新闻组建缓存将只持续60秒。
ESI的一个必备条件是嵌入的action可以通过一个URL被访问，这样网关缓存才可以独立于页面其它部分获取它。当然，一个action不能被通过一个URL访问除非有一个路由指向它。Symfony2 通过一个通用的路由和controller负责这个。
为了ESI包含标签能正常的工作，你必须定义_internal 路由：
YAML格式：


# app/config/routing.yml
_internal:
  resource: "@FrameworkBundle/Resources/config/routing/internal.xml"
  prefix:  /_internal




XML格式：


<!-- app/config/routing.xml -->
<"1.0" encoding="UTF-8" "http://symfony.com/schema/routing"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
  <import resource="@FrameworkBundle/Resources/config/routing/internal.xml" prefix="/_internal" />
</routes>




PHP代码格式：


// app/config/routing.php
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection->addCollection($loader->import('@FrameworkBundle/Resources/config/routing/internal.xml', '/_internal'));
return $collection;




因为路由允许所有的action通过一个URL被访问，你可以通过使用Symfony2防火墙（允许访问你的反向代理的IP范围）内容保护它。
缓存策略的一大优势是你可以让你的应用程序根据动态的需要同时又尽量的减少触及应用程序。
一旦你开始使用ESI，请记住一定使用s-maxage指令代替max-age。因为浏览器只接受聚合的资源，它不知道子组件，所以它会按照max-age指令缓存整个页面。这是你不希望它做的。
render helper支持的两外两个有用选项：

alt:用作ESI标签的alt属性，当src找不到时，它允许你指定一个替代URL。

ignore_errors:如果设置为true,一个onerror属性将被添加到ESI，并且属性值设置为continue，在一个失败事件中，网关缓存将只默默的移除ESI标签。
缓存失效：
“计算机科学中有两大难题：缓存失效和命名事物”---Phil Karlton
你永远都不需要失效缓存数据，因为失效早已在HTTP缓存模型中被考虑到了。如果你使用校验，你永远都不需要通过定义校验任何事情；如果你使用过期并失效某个资源，它意味着你设置一个未来的过期日期。因为在任何类型的反向代理中失效都是一个顶级规范，如果你不担心失效，你可以在不改变任何应用程序代码的情况下在反向代理间切换。
其实，所有的反向代理都提供了清除缓存数据的方式，但是你需要尽量的避免使用它们。最标准的清除给定URL的缓存的方式是通过指定请求的HTTP方法为PURGE 来进行。
下面是如何配置Symfony2的反向代理支持PURGE HTTP方法：


// app/AppCache.php
use Symfony\Bundle\FrameworkBundle\HttpCache\HttpCache;
class AppCache extends HttpCache
{
  protected function invalidate(Request $request)
  {
    if ('PURGE' !== $request->getMethod()) {
      return parent::invalidate($request);
    }
    $response = new Response();
    if (!$this->getStore()->purge($request->getUri())) {
      $response->setStatusCode(404, 'Not purged');
    } else {
      $response->setStatusCode(200, 'Purged');
    }
    return $response;
  }
}




注意，你必须保护你的PURGE HTTP方法以避免随便一个人使用某些方法清除你的缓存数据。
总结：
Symfony2旨在遵循一条被证明了的道路规则：HTTP。 缓存也不例外。掌握Symfony2缓存系统意味着熟悉HTTP缓存模式和有效的使用它们。
这就意味着，你不能只依赖于symfony2文档和代码示例，你必须了解有关HTTP缓存和网关缓存的更宽阔的知识，比如Varnish。
希望本文所述对大家基于Symfony框架的PHP程序设计有所帮助。

                                
                                

                                    Symfony2,HTTP,Cache,Symfony缓存