vendor/pimcore/pimcore/lib/Controller/FrontendController.php line 132

Open in your IDE?
  1. <?php
  3. /**
  4.  * Pimcore
  5.  *
  6.  * This source file is available under two different licenses:
  7.  * - GNU General Public License version 3 (GPLv3)
  8.  * - Pimcore Commercial License (PCL)
  9.  * Full copyright and license information is available in
  10.  * LICENSE.md which is distributed with this source code.
  11.  *
  12.  *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
  13.  *  @license    http://www.pimcore.org/license     GPLv3 and PCL
  14.  */
  16. namespace Pimcore\Controller;
  18. use Pimcore\Http\Request\Resolver\DocumentResolver;
  19. use Pimcore\Http\Request\Resolver\EditmodeResolver;
  20. use Pimcore\Http\Request\Resolver\ResponseHeaderResolver;
  21. use Pimcore\Model\Document;
  22. use Pimcore\Templating\Renderer\EditableRenderer;
  23. use Symfony\Component\HttpFoundation\Request;
  24. use Symfony\Component\HttpFoundation\Response;
  26. /**
  27.  * @property Document\PageSnippet $document
  28.  * @property bool $editmode
  29.  */
  30. abstract class FrontendController extends Controller
  31. {
  32.     /**
  33.      * @return string[]
  34.      */
  35.     public static function getSubscribedServices()// : array
  36.     {
  37.         $services = parent::getSubscribedServices();
  38.         $services[EditmodeResolver::class] = '?'.EditmodeResolver::class;
  39.         $services[DocumentResolver::class] = '?'.DocumentResolver::class;
  40.         $services[ResponseHeaderResolver::class] = '?'.ResponseHeaderResolver::class;
  41.         $services[EditableRenderer::class] = '?'.EditableRenderer::class;
  43.         return $services;
  44.     }
  46.     /**
  47.      * document and editmode as properties and proxy them to request attributes through
  48.      * their resolvers.
  49.      *
  50.      * @param string $name
  51.      *
  52.      * @return mixed
  53.      */
  54.     public function __get($name)
  55.     {
  56.         if ('document' === $name) {
  57.             return $this->container->get(DocumentResolver::class)->getDocument();
  58.         }
  60.         if ('editmode' === $name) {
  61.             return $this->container->get(EditmodeResolver::class)->isEditmode();
  62.         }
  64.         throw new \RuntimeException(sprintf('Trying to read undefined property "%s"', $name));
  65.     }
  67.     /**
  68.      * @param string $name
  69.      * @param mixed $value
  70.      */
  71.     public function __set($name, $value)
  72.     {
  73.         $requestAttributes = ['document', 'editmode'];
  74.         if (in_array($name, $requestAttributes)) {
  75.             throw new \RuntimeException(sprintf(
  76.                 'Property "%s" is a request attribute and can\'t be set on the controller instance',
  77.                 $name
  78.             ));
  79.         }
  81.         throw new \RuntimeException(sprintf('Trying to set unknown property "%s"', $name));
  82.     }
  84.     /**
  85.      * We don't have a response object at this point, but we can add headers here which will be
  86.      * set by the ResponseHeaderListener which reads and adds this headers in the kernel.response event.
  87.      *
  88.      * @param string $key
  89.      * @param array|string $values
  90.      * @param bool $replace
  91.      * @param Request|null $request
  92.      */
  93.     protected function addResponseHeader(string $key, $values, bool $replace = false, Request $request = null)
  94.     {
  95.         if (null === $request) {
  96.             $request = $this->container->get('request_stack')->getCurrentRequest();
  97.         }
  99.         $this->container->get(ResponseHeaderResolver::class)->addResponseHeader($request, $key, $values, $replace);
  100.     }
  102.     /**
  103.      * Loads a document editable
  104.      *
  105.      * e.g. `$this->getDocumentEditable('input', 'foobar')`
  106.      *
  107.      * @param string $type
  108.      * @param string $inputName
  109.      * @param array $options
  110.      * @param Document\PageSnippet|null $document
  111.      *
  112.      * @return Document\Editable\EditableInterface
  113.      *
  114.      * @throws \Exception
  115.      */
  116.     public function getDocumentEditable($type, $inputName, array $options = [], Document\PageSnippet $document = null)
  117.     {
  118.         if (null === $document) {
  119.             $document = $this->document;
  120.         }
  122.         return $this->container->get(EditableRenderer::class)->getEditable($document, $type, $inputName, $options);
  123.     }
  125.     /**
  126.      * @param string $view
  127.      * @param array $parameters
  128.      * @param Response|null $response
  129.      *
  130.      * @return Response
  131.      */
  132.     public function renderTemplate($view, array $parameters = [], Response $response = null)
  133.     {
  134.         return $this->render($view, $parameters, $response);
  135.     }
  136. }