You are here

class Twig_Extension_Escaper in Translation template extractor 7.3

Same name and namespace in other branches
  1. 6.3 vendor/Twig/Extension/Escaper.php \Twig_Extension_Escaper

Hierarchy

Expanded class hierarchy of Twig_Extension_Escaper

File

vendor/Twig/Extension/Escaper.php, line 11

View source
class Twig_Extension_Escaper extends Twig_Extension {
  protected $defaultStrategy;

  /**
   * Constructor.
   *
   * @param string|false|callable $defaultStrategy An escaping strategy
   *
   * @see setDefaultStrategy()
   */
  public function __construct($defaultStrategy = 'html') {
    $this
      ->setDefaultStrategy($defaultStrategy);
  }
  public function getTokenParsers() {
    return array(
      new Twig_TokenParser_AutoEscape(),
    );
  }
  public function getNodeVisitors() {
    return array(
      new Twig_NodeVisitor_Escaper(),
    );
  }
  public function getFilters() {
    return array(
      new Twig_SimpleFilter('raw', 'twig_raw_filter', array(
        'is_safe' => array(
          'all',
        ),
      )),
    );
  }

  /**
   * Sets the default strategy to use when not defined by the user.
   *
   * The strategy can be a valid PHP callback that takes the template
   * "filename" as an argument and returns the strategy to use.
   *
   * @param string|false|callable $defaultStrategy An escaping strategy
   */
  public function setDefaultStrategy($defaultStrategy) {

    // for BC
    if (true === $defaultStrategy) {
      @trigger_error('Using "true" as the default strategy is deprecated. Use "html" instead.', E_USER_DEPRECATED);
      $defaultStrategy = 'html';
    }
    if ('filename' === $defaultStrategy) {
      $defaultStrategy = array(
        'Twig_FileExtensionEscapingStrategy',
        'guess',
      );
    }
    $this->defaultStrategy = $defaultStrategy;
  }

  /**
   * Gets the default strategy to use when not defined by the user.
   *
   * @param string $filename The template "filename"
   *
   * @return string|false The default strategy to use for the template
   */
  public function getDefaultStrategy($filename) {

    // disable string callables to avoid calling a function named html or js,
    // or any other upcoming escaping strategy
    if (!is_string($this->defaultStrategy) && false !== $this->defaultStrategy) {
      return call_user_func($this->defaultStrategy, $filename);
    }
    return $this->defaultStrategy;
  }
  public function getName() {
    return 'escaper';
  }

}

Members

Namesort descending Modifiers Type Description Overrides
Twig_Extension::getFunctions public function Returns a list of functions to add to the existing list. Overrides Twig_ExtensionInterface::getFunctions 4
Twig_Extension::getGlobals Deprecated public function Overrides Twig_ExtensionInterface::getGlobals 1
Twig_Extension::getOperators public function Returns a list of operators to add to the existing list. Overrides Twig_ExtensionInterface::getOperators 1
Twig_Extension::getTests public function Returns a list of tests to add to the existing list. Overrides Twig_ExtensionInterface::getTests 2
Twig_Extension::initRuntime Deprecated public function Overrides Twig_ExtensionInterface::initRuntime
Twig_Extension_Escaper::$defaultStrategy protected property
Twig_Extension_Escaper::getDefaultStrategy public function Gets the default strategy to use when not defined by the user.
Twig_Extension_Escaper::getFilters public function Returns a list of filters to add to the existing list. Overrides Twig_Extension::getFilters
Twig_Extension_Escaper::getName public function Returns the name of the extension. Overrides Twig_ExtensionInterface::getName
Twig_Extension_Escaper::getNodeVisitors public function Returns the node visitor instances to add to the existing list. Overrides Twig_Extension::getNodeVisitors
Twig_Extension_Escaper::getTokenParsers public function Returns the token parser instances to add to the existing list. Overrides Twig_Extension::getTokenParsers
Twig_Extension_Escaper::setDefaultStrategy public function Sets the default strategy to use when not defined by the user.
Twig_Extension_Escaper::__construct public function Constructor.