AbstractSurrogateFragmentRenderer.php in Zircon Profile 8

Namespace

Symfony\Component\HttpKernel\Fragment

File

vendor/symfony/http-kernel/Fragment/AbstractSurrogateFragmentRenderer.php

<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <[e-mail]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace Symfony\Component\HttpKernel\Fragment;

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\Controller\ControllerReference;
use Symfony\Component\HttpKernel\HttpCache\SurrogateInterface;
use Symfony\Component\HttpKernel\UriSigner;

/**
 * Implements Surrogate rendering strategy.
 *
 * @author Fabien Potencier <[e-mail]>
 */
abstract class AbstractSurrogateFragmentRenderer extends RoutableFragmentRenderer {
  private $surrogate;
  private $inlineStrategy;
  private $signer;

  /**
   * Constructor.
   *
   * The "fallback" strategy when surrogate is not available should always be an
   * instance of InlineFragmentRenderer.
   *
   * @param SurrogateInterface        $surrogate      An Surrogate instance
   * @param FragmentRendererInterface $inlineStrategy The inline strategy to use when the surrogate is not supported
   * @param UriSigner                 $signer
   */
  public function __construct(SurrogateInterface $surrogate = null, FragmentRendererInterface $inlineStrategy, UriSigner $signer = null) {
    $this->surrogate = $surrogate;
    $this->inlineStrategy = $inlineStrategy;
    $this->signer = $signer;
  }

  /**
   * {@inheritdoc}
   *
   * Note that if the current Request has no surrogate capability, this method
   * falls back to use the inline rendering strategy.
   *
   * Additional available options:
   *
   *  * alt: an alternative URI to render in case of an error
   *  * comment: a comment to add when returning the surrogate tag
   *
   * Note, that not all surrogate strategies support all options. For now
   * 'alt' and 'comment' are only supported by ESI.
   *
   * @see Symfony\Component\HttpKernel\HttpCache\SurrogateInterface
   */
  public function render($uri, Request $request, array $options = array()) {
    if (!$this->surrogate || !$this->surrogate
      ->hasSurrogateCapability($request)) {
      return $this->inlineStrategy
        ->render($uri, $request, $options);
    }
    if ($uri instanceof ControllerReference) {
      $uri = $this
        ->generateSignedFragmentUri($uri, $request);
    }
    $alt = isset($options['alt']) ? $options['alt'] : null;
    if ($alt instanceof ControllerReference) {
      $alt = $this
        ->generateSignedFragmentUri($alt, $request);
    }
    $tag = $this->surrogate
      ->renderIncludeTag($uri, $alt, isset($options['ignore_errors']) ? $options['ignore_errors'] : false, isset($options['comment']) ? $options['comment'] : '');
    return new Response($tag);
  }
  private function generateSignedFragmentUri($uri, Request $request) {
    if (null === $this->signer) {
      throw new \LogicException('You must use a URI when using the ESI rendering strategy or set a URL signer.');
    }

    // we need to sign the absolute URI, but want to return the path only.
    $fragmentUri = $this->signer
      ->sign($this
      ->generateFragmentUri($uri, $request, true));
    return substr($fragmentUri, strlen($request
      ->getSchemeAndHttpHost()));
  }

}

Classes

Name	Description
AbstractSurrogateFragmentRenderer	Implements Surrogate rendering strategy.