Verzeichnisstruktur phpBB-3.2.0


Veröffentlicht
06.01.2017

So funktioniert es


Auf das letzte Element klicken. Dies geht jeweils ein Schritt zurück

Auf das Icon klicken, dies öffnet das Verzeichnis. Nochmal klicken schließt das Verzeichnis.
Auf den Verzeichnisnamen klicken, dies zeigt nur das Verzeichnis mit Inhalt an

(Beispiel Datei-Icons)

Auf das Icon klicken um den Quellcode anzuzeigen

RoutingExtension.php

Zuletzt modifiziert: 09.10.2024, 12:56 - Dateigröße: 3.48 KiB


01  <?php
02   
03  /*
04   * This file is part of the Symfony package.
05   *
06   * (c) Fabien Potencier <fabien@symfony.com>
07   *
08   * For the full copyright and license information, please view the LICENSE
09   * file that was distributed with this source code.
10   */
11   
12  namespace Symfony\Bridge\Twig\Extension;
13   
14  use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
15   
16  /**
17   * Provides integration of the Routing component with Twig.
18   *
19   * @author Fabien Potencier <fabien@symfony.com>
20   */
21  class RoutingExtension extends \Twig_Extension
22  {
23      private $generator;
24   
25      public function __construct(UrlGeneratorInterface $generator)
26      {
27          $this->generator = $generator;
28      }
29   
30      /**
31       * Returns a list of functions to add to the existing list.
32       *
33       * @return array An array of functions
34       */
35      public function getFunctions()
36      {
37          return array(
38              new \Twig_SimpleFunction('url', array($this, 'getUrl'), array('is_safe_callback' => array($this, 'isUrlGenerationSafe'))),
39              new \Twig_SimpleFunction('path', array($this, 'getPath'), array('is_safe_callback' => array($this, 'isUrlGenerationSafe'))),
40          );
41      }
42   
43      public function getPath($name, $parameters = array(), $relative = false)
44      {
45          return $this->generator->generate($name, $parameters, $relative ? UrlGeneratorInterface::RELATIVE_PATH : UrlGeneratorInterface::ABSOLUTE_PATH);
46      }
47   
48      public function getUrl($name, $parameters = array(), $schemeRelative = false)
49      {
50          return $this->generator->generate($name, $parameters, $schemeRelative ? UrlGeneratorInterface::NETWORK_PATH : UrlGeneratorInterface::ABSOLUTE_URL);
51      }
52   
53      /**
54       * Determines at compile time whether the generated URL will be safe and thus
55       * saving the unneeded automatic escaping for performance reasons.
56       *
57       * The URL generation process percent encodes non-alphanumeric characters. So there is no risk
58       * that malicious/invalid characters are part of the URL. The only character within an URL that
59       * must be escaped in html is the ampersand ("&") which separates query params. So we cannot mark
60       * the URL generation as always safe, but only when we are sure there won't be multiple query
61       * params. This is the case when there are none or only one constant parameter given.
62       * E.g. we know beforehand this will be safe:
63       * - path('route')
64       * - path('route', {'param': 'value'})
65       * But the following may not:
66       * - path('route', var)
67       * - path('route', {'param': ['val1', 'val2'] }) // a sub-array
68       * - path('route', {'param1': 'value1', 'param2': 'value2'})
69       * If param1 and param2 reference placeholder in the route, it would still be safe. But we don't know.
70       *
71       * @param \Twig_Node $argsNode The arguments of the path/url function
72       *
73       * @return array An array with the contexts the URL is safe
74       */
75      public function isUrlGenerationSafe(\Twig_Node $argsNode)
76      {
77          // support named arguments
78          $paramsNode = $argsNode->hasNode('parameters') ? $argsNode->getNode('parameters') : (
79              $argsNode->hasNode(1) ? $argsNode->getNode(1) : null
80          );
81   
82          if (null === $paramsNode || $paramsNode instanceof \Twig_Node_Expression_Array && count($paramsNode) <= 2 &&
83              (!$paramsNode->hasNode(1) || $paramsNode->getNode(1) instanceof \Twig_Node_Expression_Constant)
84          ) {
85              return array('html');
86          }
87   
88          return array();
89      }
90   
91      /**
92       * {@inheritdoc}
93       */
94      public function getName()
95      {
96          return 'routing';
97      }
98  }
99