class Parser
Same name in this branch
- 11.1.x vendor/open-telemetry/api/Baggage/Propagation/Parser.php \OpenTelemetry\API\Baggage\Propagation\Parser
- 11.1.x vendor/sebastian/cli-parser/src/Parser.php \SebastianBergmann\CliParser\Parser
- 11.1.x vendor/sebastian/diff/src/Parser.php \SebastianBergmann\Diff\Parser
- 11.1.x vendor/egulias/email-validator/src/Parser.php \Egulias\EmailValidator\Parser
- 11.1.x vendor/twig/twig/src/Parser.php \Twig\Parser
- 11.1.x vendor/symfony/yaml/Parser.php \Symfony\Component\Yaml\Parser
- 11.1.x vendor/mck89/peast/lib/Peast/Selector/Parser.php \Peast\Selector\Parser
- 11.1.x vendor/mck89/peast/lib/Peast/Syntax/Parser.php \Peast\Syntax\Parser
CSS selector parser.
This component is a port of the Python cssselect library, which is copyright Ian Bicking, @author Jean-François Simon <jeanfrancois.simon@sensiolabs.com>
@internal
Hierarchy
- class \Symfony\Component\CssSelector\Parser\Parser implements \Symfony\Component\CssSelector\Parser\ParserInterface
Expanded class hierarchy of Parser
See also
https://github.com/scrapy/cssselect.
2 files declare their use of Parser
- FunctionExtension.php in vendor/
symfony/ css-selector/ XPath/ Extension/ FunctionExtension.php - Translator.php in vendor/
symfony/ css-selector/ XPath/ Translator.php
File
-
vendor/
symfony/ css-selector/ Parser/ Parser.php, line 28
Namespace
Symfony\Component\CssSelector\ParserView source
class Parser implements ParserInterface {
private Tokenizer $tokenizer;
public function __construct(?Tokenizer $tokenizer = null) {
$this->tokenizer = $tokenizer ?? new Tokenizer();
}
public function parse(string $source) : array {
$reader = new Reader($source);
$stream = $this->tokenizer
->tokenize($reader);
return $this->parseSelectorList($stream);
}
/**
* Parses the arguments for ":nth-child()" and friends.
*
* @param Token[] $tokens
*
* @throws SyntaxErrorException
*/
public static function parseSeries(array $tokens) : array {
foreach ($tokens as $token) {
if ($token->isString()) {
throw SyntaxErrorException::stringAsFunctionArgument();
}
}
$joined = trim(implode('', array_map(fn(Token $token) => $token->getValue(), $tokens)));
$int = function ($string) {
if (!is_numeric($string)) {
throw SyntaxErrorException::stringAsFunctionArgument();
}
return (int) $string;
};
switch (true) {
case 'odd' === $joined:
return [
2,
1,
];
case 'even' === $joined:
return [
2,
0,
];
case 'n' === $joined:
return [
1,
0,
];
case !str_contains($joined, 'n'):
return [
0,
$int($joined),
];
}
$split = explode('n', $joined);
$first = $split[0] ?? null;
return [
$first ? '-' === $first || '+' === $first ? $int($first . '1') : $int($first) : 1,
isset($split[1]) && $split[1] ? $int($split[1]) : 0,
];
}
private function parseSelectorList(TokenStream $stream, bool $isArgument = false) : array {
$stream->skipWhitespace();
$selectors = [];
while (true) {
if ($isArgument && $stream->getPeek()
->isDelimiter([
')',
])) {
break;
}
$selectors[] = $this->parserSelectorNode($stream, $isArgument);
if ($stream->getPeek()
->isDelimiter([
',',
])) {
$stream->getNext();
$stream->skipWhitespace();
}
else {
break;
}
}
return $selectors;
}
private function parserSelectorNode(TokenStream $stream, bool $isArgument = false) : Node\SelectorNode {
[
$result,
$pseudoElement,
] = $this->parseSimpleSelector($stream, false, $isArgument);
while (true) {
$stream->skipWhitespace();
$peek = $stream->getPeek();
if ($peek->isFileEnd() || $peek->isDelimiter([
',',
]) || $isArgument && $peek->isDelimiter([
')',
])) {
break;
}
if (null !== $pseudoElement) {
throw SyntaxErrorException::pseudoElementFound($pseudoElement, 'not at the end of a selector');
}
if ($peek->isDelimiter([
'+',
'>',
'~',
])) {
$combinator = $stream->getNext()
->getValue();
$stream->skipWhitespace();
}
else {
$combinator = ' ';
}
[
$nextSelector,
$pseudoElement,
] = $this->parseSimpleSelector($stream, false, $isArgument);
$result = new Node\CombinedSelectorNode($result, $combinator, $nextSelector);
}
return new Node\SelectorNode($result, $pseudoElement);
}
/**
* Parses next simple node (hash, class, pseudo, negation).
*
* @throws SyntaxErrorException
*/
private function parseSimpleSelector(TokenStream $stream, bool $insideNegation = false, bool $isArgument = false) : array {
$stream->skipWhitespace();
$selectorStart = \count($stream->getUsed());
$result = $this->parseElementNode($stream);
$pseudoElement = null;
while (true) {
$peek = $stream->getPeek();
if ($peek->isWhitespace() || $peek->isFileEnd() || $peek->isDelimiter([
',',
'+',
'>',
'~',
]) || $isArgument && $peek->isDelimiter([
')',
])) {
break;
}
if (null !== $pseudoElement) {
throw SyntaxErrorException::pseudoElementFound($pseudoElement, 'not at the end of a selector');
}
if ($peek->isHash()) {
$result = new Node\HashNode($result, $stream->getNext()
->getValue());
}
elseif ($peek->isDelimiter([
'.',
])) {
$stream->getNext();
$result = new Node\ClassNode($result, $stream->getNextIdentifier());
}
elseif ($peek->isDelimiter([
'[',
])) {
$stream->getNext();
$result = $this->parseAttributeNode($result, $stream);
}
elseif ($peek->isDelimiter([
':',
])) {
$stream->getNext();
if ($stream->getPeek()
->isDelimiter([
':',
])) {
$stream->getNext();
$pseudoElement = $stream->getNextIdentifier();
continue;
}
$identifier = $stream->getNextIdentifier();
if (\in_array(strtolower($identifier), [
'first-line',
'first-letter',
'before',
'after',
])) {
// Special case: CSS 2.1 pseudo-elements can have a single ':'.
// Any new pseudo-element must have two.
$pseudoElement = $identifier;
continue;
}
if (!$stream->getPeek()
->isDelimiter([
'(',
])) {
$result = new Node\PseudoNode($result, $identifier);
if ('Pseudo[Element[*]:scope]' === $result->__toString()) {
$used = \count($stream->getUsed());
if (!(2 === $used || 3 === $used && $stream->getUsed()[0]
->isWhiteSpace() || $used >= 3 && $stream->getUsed()[$used - 3]
->isDelimiter([
',',
]) || $used >= 4 && $stream->getUsed()[$used - 3]
->isWhiteSpace() && $stream->getUsed()[$used - 4]
->isDelimiter([
',',
]))) {
throw SyntaxErrorException::notAtTheStartOfASelector('scope');
}
}
continue;
}
$stream->getNext();
$stream->skipWhitespace();
if ('not' === strtolower($identifier)) {
if ($insideNegation) {
throw SyntaxErrorException::nestedNot();
}
[
$argument,
$argumentPseudoElement,
] = $this->parseSimpleSelector($stream, true, true);
$next = $stream->getNext();
if (null !== $argumentPseudoElement) {
throw SyntaxErrorException::pseudoElementFound($argumentPseudoElement, 'inside ::not()');
}
if (!$next->isDelimiter([
')',
])) {
throw SyntaxErrorException::unexpectedToken('")"', $next);
}
$result = new Node\NegationNode($result, $argument);
}
elseif ('is' === strtolower($identifier)) {
$selectors = $this->parseSelectorList($stream, true);
$next = $stream->getNext();
if (!$next->isDelimiter([
')',
])) {
throw SyntaxErrorException::unexpectedToken('")"', $next);
}
$result = new Node\MatchingNode($result, $selectors);
}
elseif ('where' === strtolower($identifier)) {
$selectors = $this->parseSelectorList($stream, true);
$next = $stream->getNext();
if (!$next->isDelimiter([
')',
])) {
throw SyntaxErrorException::unexpectedToken('")"', $next);
}
$result = new Node\SpecificityAdjustmentNode($result, $selectors);
}
else {
$arguments = [];
$next = null;
while (true) {
$stream->skipWhitespace();
$next = $stream->getNext();
if ($next->isIdentifier() || $next->isString() || $next->isNumber() || $next->isDelimiter([
'+',
'-',
])) {
$arguments[] = $next;
}
elseif ($next->isDelimiter([
')',
])) {
break;
}
else {
throw SyntaxErrorException::unexpectedToken('an argument', $next);
}
}
if (!$arguments) {
throw SyntaxErrorException::unexpectedToken('at least one argument', $next);
}
$result = new Node\FunctionNode($result, $identifier, $arguments);
}
}
else {
throw SyntaxErrorException::unexpectedToken('selector', $peek);
}
}
if (\count($stream->getUsed()) === $selectorStart) {
throw SyntaxErrorException::unexpectedToken('selector', $stream->getPeek());
}
return [
$result,
$pseudoElement,
];
}
private function parseElementNode(TokenStream $stream) : Node\ElementNode {
$peek = $stream->getPeek();
if ($peek->isIdentifier() || $peek->isDelimiter([
'*',
])) {
if ($peek->isIdentifier()) {
$namespace = $stream->getNext()
->getValue();
}
else {
$stream->getNext();
$namespace = null;
}
if ($stream->getPeek()
->isDelimiter([
'|',
])) {
$stream->getNext();
$element = $stream->getNextIdentifierOrStar();
}
else {
$element = $namespace;
$namespace = null;
}
}
else {
$element = $namespace = null;
}
return new Node\ElementNode($namespace, $element);
}
private function parseAttributeNode(Node\NodeInterface $selector, TokenStream $stream) : Node\AttributeNode {
$stream->skipWhitespace();
$attribute = $stream->getNextIdentifierOrStar();
if (null === $attribute && !$stream->getPeek()
->isDelimiter([
'|',
])) {
throw SyntaxErrorException::unexpectedToken('"|"', $stream->getPeek());
}
if ($stream->getPeek()
->isDelimiter([
'|',
])) {
$stream->getNext();
if ($stream->getPeek()
->isDelimiter([
'=',
])) {
$namespace = null;
$stream->getNext();
$operator = '|=';
}
else {
$namespace = $attribute;
$attribute = $stream->getNextIdentifier();
$operator = null;
}
}
else {
$namespace = $operator = null;
}
if (null === $operator) {
$stream->skipWhitespace();
$next = $stream->getNext();
if ($next->isDelimiter([
']',
])) {
return new Node\AttributeNode($selector, $namespace, $attribute, 'exists', null);
}
elseif ($next->isDelimiter([
'=',
])) {
$operator = '=';
}
elseif ($next->isDelimiter([
'^',
'$',
'*',
'~',
'|',
'!',
]) && $stream->getPeek()
->isDelimiter([
'=',
])) {
$operator = $next->getValue() . '=';
$stream->getNext();
}
else {
throw SyntaxErrorException::unexpectedToken('operator', $next);
}
}
$stream->skipWhitespace();
$value = $stream->getNext();
if ($value->isNumber()) {
// if the value is a number, it's casted into a string
$value = new Token(Token::TYPE_STRING, (string) $value->getValue(), $value->getPosition());
}
if (!($value->isIdentifier() || $value->isString())) {
throw SyntaxErrorException::unexpectedToken('string or identifier', $value);
}
$stream->skipWhitespace();
$next = $stream->getNext();
if (!$next->isDelimiter([
']',
])) {
throw SyntaxErrorException::unexpectedToken('"]"', $next);
}
return new Node\AttributeNode($selector, $namespace, $attribute, $operator, $value->getValue());
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
Parser::$tokenizer | private | property | ||
Parser::parse | public | function | Parses given selector source into an array of tokens. | Overrides ParserInterface::parse |
Parser::parseAttributeNode | private | function | ||
Parser::parseElementNode | private | function | ||
Parser::parserSelectorNode | private | function | ||
Parser::parseSelectorList | private | function | ||
Parser::parseSeries | public static | function | Parses the arguments for ":nth-child()" and friends. | |
Parser::parseSimpleSelector | private | function | Parses next simple node (hash, class, pseudo, negation). | |
Parser::__construct | public | function |