vendor/twig/twig/src/ExpressionParser.php line 778

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of Twig.
  5.  *
  6.  * (c) Fabien Potencier
  7.  * (c) Armin Ronacher
  8.  *
  9.  * For the full copyright and license information, please view the LICENSE
  10.  * file that was distributed with this source code.
  11.  */
  13. namespace Twig;
  15. use Twig\Error\SyntaxError;
  16. use Twig\Node\Expression\AbstractExpression;
  17. use Twig\Node\Expression\ArrayExpression;
  18. use Twig\Node\Expression\ArrowFunctionExpression;
  19. use Twig\Node\Expression\AssignNameExpression;
  20. use Twig\Node\Expression\Binary\ConcatBinary;
  21. use Twig\Node\Expression\BlockReferenceExpression;
  22. use Twig\Node\Expression\ConditionalExpression;
  23. use Twig\Node\Expression\ConstantExpression;
  24. use Twig\Node\Expression\GetAttrExpression;
  25. use Twig\Node\Expression\MethodCallExpression;
  26. use Twig\Node\Expression\NameExpression;
  27. use Twig\Node\Expression\ParentExpression;
  28. use Twig\Node\Expression\TestExpression;
  29. use Twig\Node\Expression\Unary\NegUnary;
  30. use Twig\Node\Expression\Unary\NotUnary;
  31. use Twig\Node\Expression\Unary\PosUnary;
  32. use Twig\Node\Node;
  34. /**
  35.  * Parses expressions.
  36.  *
  37.  * This parser implements a "Precedence climbing" algorithm.
  38.  *
  39.  * @see https://www.engr.mun.ca/~theo/Misc/exp_parsing.htm
  40.  * @see https://en.wikipedia.org/wiki/Operator-precedence_parser
  41.  *
  42.  * @author Fabien Potencier <fabien@symfony.com>
  43.  *
  44.  * @internal
  45.  */
  46. class ExpressionParser
  47. {
  48.     const OPERATOR_LEFT = 1;
  49.     const OPERATOR_RIGHT = 2;
  51.     private $parser;
  52.     private $env;
  53.     private $unaryOperators;
  54.     private $binaryOperators;
  56.     public function __construct(Parser $parser, Environment $env)
  57.     {
  58.         $this->parser = $parser;
  59.         $this->env = $env;
  60.         $this->unaryOperators = $env->getUnaryOperators();
  61.         $this->binaryOperators = $env->getBinaryOperators();
  62.     }
  64.     public function parseExpression($precedence = 0, $allowArrow = false)
  65.     {
  66.         if ($allowArrow && $arrow = $this->parseArrow()) {
  67.             return $arrow;
  68.         }
  70.         $expr = $this->getPrimary();
  71.         $token = $this->parser->getCurrentToken();
  72.         while ($this->isBinary($token) && $this->binaryOperators[$token->getValue()]['precedence'] >= $precedence) {
  73.             $op = $this->binaryOperators[$token->getValue()];
  74.             $this->parser->getStream()->next();
  76.             if ('is not' === $token->getValue()) {
  77.                 $expr = $this->parseNotTestExpression($expr);
  78.             } elseif ('is' === $token->getValue()) {
  79.                 $expr = $this->parseTestExpression($expr);
  80.             } elseif (isset($op['callable'])) {
  81.                 $expr = $op['callable']($this->parser, $expr);
  82.             } else {
  83.                 $expr1 = $this->parseExpression(self::OPERATOR_LEFT === $op['associativity'] ? $op['precedence'] + 1 : $op['precedence']);
  84.                 $class = $op['class'];
  85.                 $expr = new $class($expr, $expr1, $token->getLine());
  86.             }
  88.             $token = $this->parser->getCurrentToken();
  89.         }
  91.         if (0 === $precedence) {
  92.             return $this->parseConditionalExpression($expr);
  93.         }
  95.         return $expr;
  96.     }
  98.     /**
  99.      * @return ArrowFunctionExpression|null
  100.      */
  101.     private function parseArrow()
  102.     {
  103.         $stream = $this->parser->getStream();
  105.         // short array syntax (one argument, no parentheses)?
  106.         if ($stream->look(1)->test(/* Token::ARROW_TYPE */ 12)) {
  107.             $line = $stream->getCurrent()->getLine();
  108.             $token = $stream->expect(/* Token::NAME_TYPE */ 5);
  109.             $names = [new AssignNameExpression($token->getValue(), $token->getLine())];
  110.             $stream->expect(/* Token::ARROW_TYPE */ 12);
  112.             return new ArrowFunctionExpression($this->parseExpression(0), new Node($names), $line);
  113.         }
  115.         // first, determine if we are parsing an arrow function by finding => (long form)
  116.         $i = 0;
  117.         if (!$stream->look($i)->test(/* Token::PUNCTUATION_TYPE */ 9, '(')) {
  118.             return null;
  119.         }
  120.         ++$i;
  121.         while (true) {
  122.             // variable name
  123.             ++$i;
  124.             if (!$stream->look($i)->test(/* Token::PUNCTUATION_TYPE */ 9, ',')) {
  125.                 break;
  126.             }
  127.             ++$i;
  128.         }
  129.         if (!$stream->look($i)->test(/* Token::PUNCTUATION_TYPE */ 9, ')')) {
  130.             return null;
  131.         }
  132.         ++$i;
  133.         if (!$stream->look($i)->test(/* Token::ARROW_TYPE */ 12)) {
  134.             return null;
  135.         }
  137.         // yes, let's parse it properly
  138.         $token = $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, '(');
  139.         $line = $token->getLine();
  141.         $names = [];
  142.         while (true) {
  143.             $token = $stream->expect(/* Token::NAME_TYPE */ 5);
  144.             $names[] = new AssignNameExpression($token->getValue(), $token->getLine());
  146.             if (!$stream->nextIf(/* Token::PUNCTUATION_TYPE */ 9, ',')) {
  147.                 break;
  148.             }
  149.         }
  150.         $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, ')');
  151.         $stream->expect(/* Token::ARROW_TYPE */ 12);
  153.         return new ArrowFunctionExpression($this->parseExpression(0), new Node($names), $line);
  154.     }
  156.     private function getPrimary(): AbstractExpression
  157.     {
  158.         $token = $this->parser->getCurrentToken();
  160.         if ($this->isUnary($token)) {
  161.             $operator = $this->unaryOperators[$token->getValue()];
  162.             $this->parser->getStream()->next();
  163.             $expr = $this->parseExpression($operator['precedence']);
  164.             $class = $operator['class'];
  166.             return $this->parsePostfixExpression(new $class($expr, $token->getLine()));
  167.         } elseif ($token->test(/* Token::PUNCTUATION_TYPE */ 9, '(')) {
  168.             $this->parser->getStream()->next();
  169.             $expr = $this->parseExpression();
  170.             $this->parser->getStream()->expect(/* Token::PUNCTUATION_TYPE */ 9, ')', 'An opened parenthesis is not properly closed');
  172.             return $this->parsePostfixExpression($expr);
  173.         }
  175.         return $this->parsePrimaryExpression();
  176.     }
  178.     private function parseConditionalExpression($expr): AbstractExpression
  179.     {
  180.         while ($this->parser->getStream()->nextIf(/* Token::PUNCTUATION_TYPE */ 9, '?')) {
  181.             if (!$this->parser->getStream()->nextIf(/* Token::PUNCTUATION_TYPE */ 9, ':')) {
  182.                 $expr2 = $this->parseExpression();
  183.                 if ($this->parser->getStream()->nextIf(/* Token::PUNCTUATION_TYPE */ 9, ':')) {
  184.                     $expr3 = $this->parseExpression();
  185.                 } else {
  186.                     $expr3 = new ConstantExpression('', $this->parser->getCurrentToken()->getLine());
  187.                 }
  188.             } else {
  189.                 $expr2 = $expr;
  190.                 $expr3 = $this->parseExpression();
  191.             }
  193.             $expr = new ConditionalExpression($expr, $expr2, $expr3, $this->parser->getCurrentToken()->getLine());
  194.         }
  196.         return $expr;
  197.     }
  199.     private function isUnary(Token $token): bool
  200.     {
  201.         return $token->test(/* Token::OPERATOR_TYPE */ 8) && isset($this->unaryOperators[$token->getValue()]);
  202.     }
  204.     private function isBinary(Token $token): bool
  205.     {
  206.         return $token->test(/* Token::OPERATOR_TYPE */ 8) && isset($this->binaryOperators[$token->getValue()]);
  207.     }
  209.     public function parsePrimaryExpression()
  210.     {
  211.         $token = $this->parser->getCurrentToken();
  212.         switch ($token->getType()) {
  213.             case /* Token::NAME_TYPE */ 5:
  214.                 $this->parser->getStream()->next();
  215.                 switch ($token->getValue()) {
  216.                     case 'true':
  217.                     case 'TRUE':
  218.                         $node = new ConstantExpression(true, $token->getLine());
  219.                         break;
  221.                     case 'false':
  222.                     case 'FALSE':
  223.                         $node = new ConstantExpression(false, $token->getLine());
  224.                         break;
  226.                     case 'none':
  227.                     case 'NONE':
  228.                     case 'null':
  229.                     case 'NULL':
  230.                         $node = new ConstantExpression(null, $token->getLine());
  231.                         break;
  233.                     default:
  234.                         if ('(' === $this->parser->getCurrentToken()->getValue()) {
  235.                             $node = $this->getFunctionNode($token->getValue(), $token->getLine());
  236.                         } else {
  237.                             $node = new NameExpression($token->getValue(), $token->getLine());
  238.                         }
  239.                 }
  240.                 break;
  242.             case /* Token::NUMBER_TYPE */ 6:
  243.                 $this->parser->getStream()->next();
  244.                 $node = new ConstantExpression($token->getValue(), $token->getLine());
  245.                 break;
  247.             case /* Token::STRING_TYPE */ 7:
  248.             case /* Token::INTERPOLATION_START_TYPE */ 10:
  249.                 $node = $this->parseStringExpression();
  250.                 break;
  252.             case /* Token::OPERATOR_TYPE */ 8:
  253.                 if (preg_match(Lexer::REGEX_NAME, $token->getValue(), $matches) && $matches[0] == $token->getValue()) {
  254.                     // in this context, string operators are variable names
  255.                     $this->parser->getStream()->next();
  256.                     $node = new NameExpression($token->getValue(), $token->getLine());
  257.                     break;
  258.                 } elseif (isset($this->unaryOperators[$token->getValue()])) {
  259.                     $class = $this->unaryOperators[$token->getValue()]['class'];
  261.                     $ref = new \ReflectionClass($class);
  262.                     if (!(\in_array($ref->getName(), [NegUnary::class, PosUnary::class, 'Twig_Node_Expression_Unary_Neg', 'Twig_Node_Expression_Unary_Pos'])
  263.                         || $ref->isSubclassOf(NegUnary::class) || $ref->isSubclassOf(PosUnary::class)
  264.                         || $ref->isSubclassOf('Twig_Node_Expression_Unary_Neg') || $ref->isSubclassOf('Twig_Node_Expression_Unary_Pos'))
  265.                     ) {
  266.                         throw new SyntaxError(sprintf('Unexpected unary operator "%s".', $token->getValue()), $token->getLine(), $this->parser->getStream()->getSourceContext());
  267.                     }
  269.                     $this->parser->getStream()->next();
  270.                     $expr = $this->parsePrimaryExpression();
  272.                     $node = new $class($expr, $token->getLine());
  273.                     break;
  274.                 }
  276.                 // no break
  277.             default:
  278.                 if ($token->test(/* Token::PUNCTUATION_TYPE */ 9, '[')) {
  279.                     $node = $this->parseArrayExpression();
  280.                 } elseif ($token->test(/* Token::PUNCTUATION_TYPE */ 9, '{')) {
  281.                     $node = $this->parseHashExpression();
  282.                 } elseif ($token->test(/* Token::OPERATOR_TYPE */ 8, '=') && ('==' === $this->parser->getStream()->look(-1)->getValue() || '!=' === $this->parser->getStream()->look(-1)->getValue())) {
  283.                     throw new SyntaxError(sprintf('Unexpected operator of value "%s". Did you try to use "===" or "!==" for strict comparison? Use "is same as(value)" instead.', $token->getValue()), $token->getLine(), $this->parser->getStream()->getSourceContext());
  284.                 } else {
  285.                     throw new SyntaxError(sprintf('Unexpected token "%s" of value "%s".', Token::typeToEnglish($token->getType()), $token->getValue()), $token->getLine(), $this->parser->getStream()->getSourceContext());
  286.                 }
  287.         }
  289.         return $this->parsePostfixExpression($node);
  290.     }
  292.     public function parseStringExpression()
  293.     {
  294.         $stream = $this->parser->getStream();
  296.         $nodes = [];
  297.         // a string cannot be followed by another string in a single expression
  298.         $nextCanBeString = true;
  299.         while (true) {
  300.             if ($nextCanBeString && $token = $stream->nextIf(/* Token::STRING_TYPE */ 7)) {
  301.                 $nodes[] = new ConstantExpression($token->getValue(), $token->getLine());
  302.                 $nextCanBeString = false;
  303.             } elseif ($stream->nextIf(/* Token::INTERPOLATION_START_TYPE */ 10)) {
  304.                 $nodes[] = $this->parseExpression();
  305.                 $stream->expect(/* Token::INTERPOLATION_END_TYPE */ 11);
  306.                 $nextCanBeString = true;
  307.             } else {
  308.                 break;
  309.             }
  310.         }
  312.         $expr = array_shift($nodes);
  313.         foreach ($nodes as $node) {
  314.             $expr = new ConcatBinary($expr, $node, $node->getTemplateLine());
  315.         }
  317.         return $expr;
  318.     }
  320.     public function parseArrayExpression()
  321.     {
  322.         $stream = $this->parser->getStream();
  323.         $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, '[', 'An array element was expected');
  325.         $node = new ArrayExpression([], $stream->getCurrent()->getLine());
  326.         $first = true;
  327.         while (!$stream->test(/* Token::PUNCTUATION_TYPE */ 9, ']')) {
  328.             if (!$first) {
  329.                 $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, ',', 'An array element must be followed by a comma');
  331.                 // trailing ,?
  332.                 if ($stream->test(/* Token::PUNCTUATION_TYPE */ 9, ']')) {
  333.                     break;
  334.                 }
  335.             }
  336.             $first = false;
  338.             $node->addElement($this->parseExpression());
  339.         }
  340.         $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, ']', 'An opened array is not properly closed');
  342.         return $node;
  343.     }
  345.     public function parseHashExpression()
  346.     {
  347.         $stream = $this->parser->getStream();
  348.         $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, '{', 'A hash element was expected');
  350.         $node = new ArrayExpression([], $stream->getCurrent()->getLine());
  351.         $first = true;
  352.         while (!$stream->test(/* Token::PUNCTUATION_TYPE */ 9, '}')) {
  353.             if (!$first) {
  354.                 $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, ',', 'A hash value must be followed by a comma');
  356.                 // trailing ,?
  357.                 if ($stream->test(/* Token::PUNCTUATION_TYPE */ 9, '}')) {
  358.                     break;
  359.                 }
  360.             }
  361.             $first = false;
  363.             // a hash key can be:
  364.             //
  365.             //  * a number -- 12
  366.             //  * a string -- 'a'
  367.             //  * a name, which is equivalent to a string -- a
  368.             //  * an expression, which must be enclosed in parentheses -- (1 + 2)
  369.             if (($token = $stream->nextIf(/* Token::STRING_TYPE */ 7)) || ($token = $stream->nextIf(/* Token::NAME_TYPE */ 5)) || $token = $stream->nextIf(/* Token::NUMBER_TYPE */ 6)) {
  370.                 $key = new ConstantExpression($token->getValue(), $token->getLine());
  371.             } elseif ($stream->test(/* Token::PUNCTUATION_TYPE */ 9, '(')) {
  372.                 $key = $this->parseExpression();
  373.             } else {
  374.                 $current = $stream->getCurrent();
  376.                 throw new SyntaxError(sprintf('A hash key must be a quoted string, a number, a name, or an expression enclosed in parentheses (unexpected token "%s" of value "%s".', Token::typeToEnglish($current->getType()), $current->getValue()), $current->getLine(), $stream->getSourceContext());
  377.             }
  379.             $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, ':', 'A hash key must be followed by a colon (:)');
  380.             $value = $this->parseExpression();
  382.             $node->addElement($value, $key);
  383.         }
  384.         $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, '}', 'An opened hash is not properly closed');
  386.         return $node;
  387.     }
  389.     public function parsePostfixExpression($node)
  390.     {
  391.         while (true) {
  392.             $token = $this->parser->getCurrentToken();
  393.             if (/* Token::PUNCTUATION_TYPE */ 9 == $token->getType()) {
  394.                 if ('.' == $token->getValue() || '[' == $token->getValue()) {
  395.                     $node = $this->parseSubscriptExpression($node);
  396.                 } elseif ('|' == $token->getValue()) {
  397.                     $node = $this->parseFilterExpression($node);
  398.                 } else {
  399.                     break;
  400.                 }
  401.             } else {
  402.                 break;
  403.             }
  404.         }
  406.         return $node;
  407.     }
  409.     public function getFunctionNode($name, $line)
  410.     {
  411.         switch ($name) {
  412.             case 'parent':
  413.                 $this->parseArguments();
  414.                 if (!\count($this->parser->getBlockStack())) {
  415.                     throw new SyntaxError('Calling "parent" outside a block is forbidden.', $line, $this->parser->getStream()->getSourceContext());
  416.                 }
  418.                 if (!$this->parser->getParent() && !$this->parser->hasTraits()) {
  419.                     throw new SyntaxError('Calling "parent" on a template that does not extend nor "use" another template is forbidden.', $line, $this->parser->getStream()->getSourceContext());
  420.                 }
  422.                 return new ParentExpression($this->parser->peekBlockStack(), $line);
  423.             case 'block':
  424.                 $args = $this->parseArguments();
  425.                 if (\count($args) < 1) {
  426.                     throw new SyntaxError('The "block" function takes one argument (the block name).', $line, $this->parser->getStream()->getSourceContext());
  427.                 }
  429.                 return new BlockReferenceExpression($args->getNode(0), \count($args) > 1 ? $args->getNode(1) : null, $line);
  430.             case 'attribute':
  431.                 $args = $this->parseArguments();
  432.                 if (\count($args) < 2) {
  433.                     throw new SyntaxError('The "attribute" function takes at least two arguments (the variable and the attributes).', $line, $this->parser->getStream()->getSourceContext());
  434.                 }
  436.                 return new GetAttrExpression($args->getNode(0), $args->getNode(1), \count($args) > 2 ? $args->getNode(2) : null, Template::ANY_CALL, $line);
  437.             default:
  438.                 if (null !== $alias = $this->parser->getImportedSymbol('function', $name)) {
  439.                     $arguments = new ArrayExpression([], $line);
  440.                     foreach ($this->parseArguments() as $n) {
  441.                         $arguments->addElement($n);
  442.                     }
  444.                     $node = new MethodCallExpression($alias['node'], $alias['name'], $arguments, $line);
  445.                     $node->setAttribute('safe', true);
  447.                     return $node;
  448.                 }
  450.                 $args = $this->parseArguments(true);
  451.                 $class = $this->getFunctionNodeClass($name, $line);
  453.                 return new $class($name, $args, $line);
  454.         }
  455.     }
  457.     public function parseSubscriptExpression($node)
  458.     {
  459.         $stream = $this->parser->getStream();
  460.         $token = $stream->next();
  461.         $lineno = $token->getLine();
  462.         $arguments = new ArrayExpression([], $lineno);
  463.         $type = Template::ANY_CALL;
  464.         if ('.' == $token->getValue()) {
  465.             $token = $stream->next();
  466.             if (
  467.                 /* Token::NAME_TYPE */ 5 == $token->getType()
  468.                 ||
  469.                 /* Token::NUMBER_TYPE */ 6 == $token->getType()
  470.                 ||
  471.                 (/* Token::OPERATOR_TYPE */ 8 == $token->getType() && preg_match(Lexer::REGEX_NAME, $token->getValue()))
  472.             ) {
  473.                 $arg = new ConstantExpression($token->getValue(), $lineno);
  475.                 if ($stream->test(/* Token::PUNCTUATION_TYPE */ 9, '(')) {
  476.                     $type = Template::METHOD_CALL;
  477.                     foreach ($this->parseArguments() as $n) {
  478.                         $arguments->addElement($n);
  479.                     }
  480.                 }
  481.             } else {
  482.                 throw new SyntaxError('Expected name or number.', $lineno, $stream->getSourceContext());
  483.             }
  485.             if ($node instanceof NameExpression && null !== $this->parser->getImportedSymbol('template', $node->getAttribute('name'))) {
  486.                 if (!$arg instanceof ConstantExpression) {
  487.                     throw new SyntaxError(sprintf('Dynamic macro names are not supported (called on "%s").', $node->getAttribute('name')), $token->getLine(), $stream->getSourceContext());
  488.                 }
  490.                 $name = $arg->getAttribute('value');
  492.                 $node = new MethodCallExpression($node, 'macro_'.$name, $arguments, $lineno);
  493.                 $node->setAttribute('safe', true);
  495.                 return $node;
  496.             }
  497.         } else {
  498.             $type = Template::ARRAY_CALL;
  500.             // slice?
  501.             $slice = false;
  502.             if ($stream->test(/* Token::PUNCTUATION_TYPE */ 9, ':')) {
  503.                 $slice = true;
  504.                 $arg = new ConstantExpression(0, $token->getLine());
  505.             } else {
  506.                 $arg = $this->parseExpression();
  507.             }
  509.             if ($stream->nextIf(/* Token::PUNCTUATION_TYPE */ 9, ':')) {
  510.                 $slice = true;
  511.             }
  513.             if ($slice) {
  514.                 if ($stream->test(/* Token::PUNCTUATION_TYPE */ 9, ']')) {
  515.                     $length = new ConstantExpression(null, $token->getLine());
  516.                 } else {
  517.                     $length = $this->parseExpression();
  518.                 }
  520.                 $class = $this->getFilterNodeClass('slice', $token->getLine());
  521.                 $arguments = new Node([$arg, $length]);
  522.                 $filter = new $class($node, new ConstantExpression('slice', $token->getLine()), $arguments, $token->getLine());
  524.                 $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, ']');
  526.                 return $filter;
  527.             }
  529.             $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, ']');
  530.         }
  532.         return new GetAttrExpression($node, $arg, $arguments, $type, $lineno);
  533.     }
  535.     public function parseFilterExpression($node)
  536.     {
  537.         $this->parser->getStream()->next();
  539.         return $this->parseFilterExpressionRaw($node);
  540.     }
  542.     public function parseFilterExpressionRaw($node, $tag = null)
  543.     {
  544.         while (true) {
  545.             $token = $this->parser->getStream()->expect(/* Token::NAME_TYPE */ 5);
  547.             $name = new ConstantExpression($token->getValue(), $token->getLine());
  548.             if (!$this->parser->getStream()->test(/* Token::PUNCTUATION_TYPE */ 9, '(')) {
  549.                 $arguments = new Node();
  550.             } else {
  551.                 $arguments = $this->parseArguments(true, false, true);
  552.             }
  554.             $class = $this->getFilterNodeClass($name->getAttribute('value'), $token->getLine());
  556.             $node = new $class($node, $name, $arguments, $token->getLine(), $tag);
  558.             if (!$this->parser->getStream()->test(/* Token::PUNCTUATION_TYPE */ 9, '|')) {
  559.                 break;
  560.             }
  562.             $this->parser->getStream()->next();
  563.         }
  565.         return $node;
  566.     }
  568.     /**
  569.      * Parses arguments.
  570.      *
  571.      * @param bool $namedArguments Whether to allow named arguments or not
  572.      * @param bool $definition     Whether we are parsing arguments for a function definition
  573.      *
  574.      * @return Node
  575.      *
  576.      * @throws SyntaxError
  577.      */
  578.     public function parseArguments($namedArguments = false, $definition = false, $allowArrow = false)
  579.     {
  580.         $args = [];
  581.         $stream = $this->parser->getStream();
  583.         $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, '(', 'A list of arguments must begin with an opening parenthesis');
  584.         while (!$stream->test(/* Token::PUNCTUATION_TYPE */ 9, ')')) {
  585.             if (!empty($args)) {
  586.                 $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, ',', 'Arguments must be separated by a comma');
  587.             }
  589.             if ($definition) {
  590.                 $token = $stream->expect(/* Token::NAME_TYPE */ 5, null, 'An argument must be a name');
  591.                 $value = new NameExpression($token->getValue(), $this->parser->getCurrentToken()->getLine());
  592.             } else {
  593.                 $value = $this->parseExpression(0, $allowArrow);
  594.             }
  596.             $name = null;
  597.             if ($namedArguments && $token = $stream->nextIf(/* Token::OPERATOR_TYPE */ 8, '=')) {
  598.                 if (!$value instanceof NameExpression) {
  599.                     throw new SyntaxError(sprintf('A parameter name must be a string, "%s" given.', \get_class($value)), $token->getLine(), $stream->getSourceContext());
  600.                 }
  601.                 $name = $value->getAttribute('name');
  603.                 if ($definition) {
  604.                     $value = $this->parsePrimaryExpression();
  606.                     if (!$this->checkConstantExpression($value)) {
  607.                         throw new SyntaxError(sprintf('A default value for an argument must be a constant (a boolean, a string, a number, or an array).'), $token->getLine(), $stream->getSourceContext());
  608.                     }
  609.                 } else {
  610.                     $value = $this->parseExpression(0, $allowArrow);
  611.                 }
  612.             }
  614.             if ($definition) {
  615.                 if (null === $name) {
  616.                     $name = $value->getAttribute('name');
  617.                     $value = new ConstantExpression(null, $this->parser->getCurrentToken()->getLine());
  618.                 }
  619.                 $args[$name] = $value;
  620.             } else {
  621.                 if (null === $name) {
  622.                     $args[] = $value;
  623.                 } else {
  624.                     $args[$name] = $value;
  625.                 }
  626.             }
  627.         }
  628.         $stream->expect(/* Token::PUNCTUATION_TYPE */ 9, ')', 'A list of arguments must be closed by a parenthesis');
  630.         return new Node($args);
  631.     }
  633.     public function parseAssignmentExpression()
  634.     {
  635.         $stream = $this->parser->getStream();
  636.         $targets = [];
  637.         while (true) {
  638.             $token = $stream->expect(/* Token::NAME_TYPE */ 5, null, 'Only variables can be assigned to');
  639.             $value = $token->getValue();
  640.             if (\in_array(strtolower($value), ['true', 'false', 'none', 'null'])) {
  641.                 throw new SyntaxError(sprintf('You cannot assign a value to "%s".', $value), $token->getLine(), $stream->getSourceContext());
  642.             }
  643.             $targets[] = new AssignNameExpression($value, $token->getLine());
  645.             if (!$stream->nextIf(/* Token::PUNCTUATION_TYPE */ 9, ',')) {
  646.                 break;
  647.             }
  648.         }
  650.         return new Node($targets);
  651.     }
  653.     public function parseMultitargetExpression()
  654.     {
  655.         $targets = [];
  656.         while (true) {
  657.             $targets[] = $this->parseExpression();
  658.             if (!$this->parser->getStream()->nextIf(/* Token::PUNCTUATION_TYPE */ 9, ',')) {
  659.                 break;
  660.             }
  661.         }
  663.         return new Node($targets);
  664.     }
  666.     private function parseNotTestExpression(Node $node): NotUnary
  667.     {
  668.         return new NotUnary($this->parseTestExpression($node), $this->parser->getCurrentToken()->getLine());
  669.     }
  671.     private function parseTestExpression(Node $node): TestExpression
  672.     {
  673.         $stream = $this->parser->getStream();
  674.         list($name, $test) = $this->getTest($node->getTemplateLine());
  676.         $class = $this->getTestNodeClass($test);
  677.         $arguments = null;
  678.         if ($stream->test(/* Token::PUNCTUATION_TYPE */ 9, '(')) {
  679.             $arguments = $this->parseArguments(true);
  680.         }
  682.         return new $class($node, $name, $arguments, $this->parser->getCurrentToken()->getLine());
  683.     }
  685.     private function getTest(int $line): array
  686.     {
  687.         $stream = $this->parser->getStream();
  688.         $name = $stream->expect(/* Token::NAME_TYPE */ 5)->getValue();
  690.         if ($test = $this->env->getTest($name)) {
  691.             return [$name, $test];
  692.         }
  694.         if ($stream->test(/* Token::NAME_TYPE */ 5)) {
  695.             // try 2-words tests
  696.             $name = $name.' '.$this->parser->getCurrentToken()->getValue();
  698.             if ($test = $this->env->getTest($name)) {
  699.                 $stream->next();
  701.                 return [$name, $test];
  702.             }
  703.         }
  705.         $e = new SyntaxError(sprintf('Unknown "%s" test.', $name), $line, $stream->getSourceContext());
  706.         $e->addSuggestions($name, array_keys($this->env->getTests()));
  708.         throw $e;
  709.     }
  711.     private function getTestNodeClass(TwigTest $test): string
  712.     {
  713.         if ($test->isDeprecated()) {
  714.             $stream = $this->parser->getStream();
  715.             $message = sprintf('Twig Test "%s" is deprecated', $test->getName());
  717.             if (!\is_bool($test->getDeprecatedVersion())) {
  718.                 $message .= sprintf(' since version %s', $test->getDeprecatedVersion());
  719.             }
  720.             if ($test->getAlternative()) {
  721.                 $message .= sprintf('. Use "%s" instead', $test->getAlternative());
  722.             }
  723.             $src = $stream->getSourceContext();
  724.             $message .= sprintf(' in %s at line %d.', $src->getPath() ?: $src->getName(), $stream->getCurrent()->getLine());
  726.             @trigger_error($message, E_USER_DEPRECATED);
  727.         }
  729.         return $test->getNodeClass();
  730.     }
  732.     private function getFunctionNodeClass(string $name, int $line): string
  733.     {
  734.         if (false === $function = $this->env->getFunction($name)) {
  735.             $e = new SyntaxError(sprintf('Unknown "%s" function.', $name), $line, $this->parser->getStream()->getSourceContext());
  736.             $e->addSuggestions($name, array_keys($this->env->getFunctions()));
  738.             throw $e;
  739.         }
  741.         if ($function->isDeprecated()) {
  742.             $message = sprintf('Twig Function "%s" is deprecated', $function->getName());
  743.             if (!\is_bool($function->getDeprecatedVersion())) {
  744.                 $message .= sprintf(' since version %s', $function->getDeprecatedVersion());
  745.             }
  746.             if ($function->getAlternative()) {
  747.                 $message .= sprintf('. Use "%s" instead', $function->getAlternative());
  748.             }
  749.             $src = $this->parser->getStream()->getSourceContext();
  750.             $message .= sprintf(' in %s at line %d.', $src->getPath() ?: $src->getName(), $line);
  752.             @trigger_error($message, E_USER_DEPRECATED);
  753.         }
  755.         return $function->getNodeClass();
  756.     }
  758.     private function getFilterNodeClass(string $name, int $line): string
  759.     {
  760.         if (false === $filter = $this->env->getFilter($name)) {
  761.             $e = new SyntaxError(sprintf('Unknown "%s" filter.', $name), $line, $this->parser->getStream()->getSourceContext());
  762.             $e->addSuggestions($name, array_keys($this->env->getFilters()));
  764.             throw $e;
  765.         }
  767.         if ($filter->isDeprecated()) {
  768.             $message = sprintf('Twig Filter "%s" is deprecated', $filter->getName());
  769.             if (!\is_bool($filter->getDeprecatedVersion())) {
  770.                 $message .= sprintf(' since version %s', $filter->getDeprecatedVersion());
  771.             }
  772.             if ($filter->getAlternative()) {
  773.                 $message .= sprintf('. Use "%s" instead', $filter->getAlternative());
  774.             }
  775.             $src = $this->parser->getStream()->getSourceContext();
  776.             $message .= sprintf(' in %s at line %d.', $src->getPath() ?: $src->getName(), $line);
  778.             @trigger_error($message, E_USER_DEPRECATED);
  779.         }
  781.         return $filter->getNodeClass();
  782.     }
  784.     // checks that the node only contains "constant" elements
  785.     private function checkConstantExpression(Node $node): bool
  786.     {
  787.         if (!($node instanceof ConstantExpression || $node instanceof ArrayExpression
  788.             || $node instanceof NegUnary || $node instanceof PosUnary
  789.         )) {
  790.             return false;
  791.         }
  793.         foreach ($node as $n) {
  794.             if (!$this->checkConstantExpression($n)) {
  795.                 return false;
  796.             }
  797.         }
  799.         return true;
  800.     }
  801. }
  803. class_alias('Twig\ExpressionParser', 'Twig_ExpressionParser');