Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. SandboxExtension.php

class SandboxExtension

Hierarchy

  • class \Twig\Extension\AbstractExtension implements \Twig\Extension\ExtensionInterface
    • class \Twig\Extension\SandboxExtension extends \Twig\Extension\AbstractExtension

Expanded class hierarchy of SandboxExtension

2 files declare their use of SandboxExtension
GetAttrExpression.php in vendor/twig/twig/src/Node/Expression/GetAttrExpression.php
TwigEnvironment.php in core/lib/Drupal/Core/Template/TwigEnvironment.php

File

vendor/twig/twig/src/Extension/SandboxExtension.php, line 22

Namespace

Twig\Extension
View source
final class SandboxExtension extends AbstractExtension {
    private $sandboxedGlobally;
    private $sandboxed;
    private $policy;
    private $sourcePolicy;
    public function __construct(SecurityPolicyInterface $policy, $sandboxed = false, ?SourcePolicyInterface $sourcePolicy = null) {
        $this->policy = $policy;
        $this->sandboxedGlobally = $sandboxed;
        $this->sourcePolicy = $sourcePolicy;
    }
    public function getTokenParsers() : array {
        return [
            new SandboxTokenParser(),
        ];
    }
    public function getNodeVisitors() : array {
        return [
            new SandboxNodeVisitor(),
        ];
    }
    public function enableSandbox() : void {
        $this->sandboxed = true;
    }
    public function disableSandbox() : void {
        $this->sandboxed = false;
    }
    public function isSandboxed(?Source $source = null) : bool {
        return $this->sandboxedGlobally || $this->sandboxed || $this->isSourceSandboxed($source);
    }
    public function isSandboxedGlobally() : bool {
        return $this->sandboxedGlobally;
    }
    private function isSourceSandboxed(?Source $source) : bool {
        if (null === $source || null === $this->sourcePolicy) {
            return false;
        }
        return $this->sourcePolicy
            ->enableSandbox($source);
    }
    public function setSecurityPolicy(SecurityPolicyInterface $policy) {
        $this->policy = $policy;
    }
    public function getSecurityPolicy() : SecurityPolicyInterface {
        return $this->policy;
    }
    public function checkSecurity($tags, $filters, $functions, ?Source $source = null) : void {
        if ($this->isSandboxed($source)) {
            $this->policy
                ->checkSecurity($tags, $filters, $functions);
        }
    }
    public function checkMethodAllowed($obj, $method, int $lineno = -1, ?Source $source = null) : void {
        if ($this->isSandboxed($source)) {
            try {
                $this->policy
                    ->checkMethodAllowed($obj, $method);
            } catch (SecurityNotAllowedMethodError $e) {
                $e->setSourceContext($source);
                $e->setTemplateLine($lineno);
                throw $e;
            }
        }
    }
    public function checkPropertyAllowed($obj, $property, int $lineno = -1, ?Source $source = null) : void {
        if ($this->isSandboxed($source)) {
            try {
                $this->policy
                    ->checkPropertyAllowed($obj, $property);
            } catch (SecurityNotAllowedPropertyError $e) {
                $e->setSourceContext($source);
                $e->setTemplateLine($lineno);
                throw $e;
            }
        }
    }
    public function ensureToStringAllowed($obj, int $lineno = -1, ?Source $source = null) {
        if (\is_array($obj)) {
            $this->ensureToStringAllowedForArray($obj, $lineno, $source);
            return $obj;
        }
        if ($obj instanceof \Stringable && $this->isSandboxed($source)) {
            try {
                $this->policy
                    ->checkMethodAllowed($obj, '__toString');
            } catch (SecurityNotAllowedMethodError $e) {
                $e->setSourceContext($source);
                $e->setTemplateLine($lineno);
                throw $e;
            }
        }
        return $obj;
    }
    private function ensureToStringAllowedForArray(array $obj, int $lineno, ?Source $source, array &$stack = []) : void {
        foreach ($obj as $k => $v) {
            if (!$v) {
                continue;
            }
            if (!\is_array($v)) {
                $this->ensureToStringAllowed($v, $lineno, $source);
                continue;
            }
            if ($r = \ReflectionReference::fromArrayElement($obj, $k)) {
                if (isset($stack[$r->getId()])) {
                    continue;
                }
                $stack[$r->getId()] = true;
            }
            $this->ensureToStringAllowedForArray($v, $lineno, $source, $stack);
        }
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
AbstractExtension::getFilters public function Returns a list of filters to add to the existing list. Overrides ExtensionInterface::getFilters 4
AbstractExtension::getFunctions public function Returns a list of functions to add to the existing list. Overrides ExtensionInterface::getFunctions 9
AbstractExtension::getOperators public function Returns a list of operators to add to the existing list. Overrides ExtensionInterface::getOperators 1
AbstractExtension::getTests public function Returns a list of tests to add to the existing list. Overrides ExtensionInterface::getTests 2
SandboxExtension::$policy private property
SandboxExtension::$sandboxed private property
SandboxExtension::$sandboxedGlobally private property
SandboxExtension::$sourcePolicy private property
SandboxExtension::checkMethodAllowed public function
SandboxExtension::checkPropertyAllowed public function
SandboxExtension::checkSecurity public function
SandboxExtension::disableSandbox public function
SandboxExtension::enableSandbox public function
SandboxExtension::ensureToStringAllowed public function
SandboxExtension::ensureToStringAllowedForArray private function
SandboxExtension::getNodeVisitors public function Returns the node visitor instances to add to the existing list. Overrides AbstractExtension::getNodeVisitors
SandboxExtension::getSecurityPolicy public function
SandboxExtension::getTokenParsers public function Returns the token parser instances to add to the existing list. Overrides AbstractExtension::getTokenParsers
SandboxExtension::isSandboxed public function
SandboxExtension::isSandboxedGlobally public function
SandboxExtension::isSourceSandboxed private function
SandboxExtension::setSecurityPolicy public function
SandboxExtension::__construct public function
RSS feed
Powered by Drupal