src/Symfony/Component/CssSelector/XPath/XPathExpr.php - 8.2 - githubmirror/symfony

src/Symfony/Component/CssSelector/XPath/XPathExpr.php
122 строки3 KB
Nicolas Grekas
[CssSelector] Various fixes and hardenings
18 май 2026, 18:02
18 май 2026, 18:02f94efd5
<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\CssSelector\XPath;

/**
 * XPath expression translator interface.
 *
 * This component is a port of the Python cssselect library,
 * which is copyright Ian Bicking, @see https://github.com/SimonSapin/cssselect.
 *
 * @author Jean-François Simon <jeanfrancois.simon@sensiolabs.com>
 *
 * @internal
 */
class XPathExpr
{
    public function __construct(
        private string $path = '',
        private string $element = '*',
        private string $condition = '',
        bool $starPrefix = false,
    ) {
        if ($starPrefix) {
            $this->addStarPrefix();
        }
    }

    public function getElement(): string
    {
        return $this->element;
    }

    /**
     * @return $this
     */
    public function addCondition(string $condition, string $operator = 'and'): static
    {
        $this->condition = $this->condition ? \sprintf('(%s) %s (%s)', $this->condition, $operator, $condition) : $condition;

        return $this;
    }

    public function getCondition(): string
    {
        return $this->condition;
    }

    /**
     * @return $this
     */
    public function addNameTest(): static
    {
        if ('*' !== $this->element) {
            $this->addCondition('name() = '.Translator::getXpathLiteral($this->element));
            $this->element = '*';
        }

        return $this;
    }

    /**
     * @return $this
     */
    public function addStarPrefix(): static
    {
        $this->path .= '*/';

        return $this;
    }

    /**
     * Joins another XPathExpr with a combiner.
     *
     * When $hasInnerConditions is true, $expr->condition is folded into $expr->element as a
     * "[...]" predicate rather than onto $this->condition, so subsequent addCondition() calls
     * on $this are not AND'd with it. Needed for relative selectors inside :has().
     *
     * @return $this
     */
    public function join(string $combiner, self $expr, ?string $closingCombiner = null, bool $hasInnerConditions = false): static
    {
        $path = $this->__toString().$combiner;

        if ('*/' !== $expr->path) {
            $path .= $expr->path;
        }

        $this->path = $path;

        if (!$hasInnerConditions) {
            $this->element = $expr->element.($closingCombiner ?? '');
            $this->condition = $expr->condition;
        } else {
            $this->element = $expr->element;
            if ($expr->condition) {
                $this->element .= '['.$expr->condition.']';
            }
            if ($closingCombiner) {
                $this->element .= $closingCombiner;
            }
        }

        return $this;
    }

    public function __toString(): string
    {
        $path = $this->path.$this->element;
        $condition = '' === $this->condition ? '' : '['.$this->condition.']';

        return $path.$condition;
    }
}