Yiisoft\Files\PathMatcher\CompositeMatcher

Complexity

Total Complexity

11

Size/Duplication

Total Lines	57
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

4 Methods

Rating	Name	Duplication	Size	Complexity
B	match()	0	23	8
A	any()	0	3	1
A	all()	0	3	1
A	__construct()	0	5	1

<?php

declare(strict_types=1);

namespace Yiisoft\Files\PathMatcher;

/**
 * Composite matcher allows combining several matchers.
 */
final class CompositeMatcher implements PathMatcherInterface
{
    /**
     * @var PathMatcherInterface[]
     */
    private array $matchers;

    private function __construct(
        private bool $matchAny,
        PathMatcherInterface ...$matchers
    ) {
        $this->matchers = $matchers;
    }

    /**
     * Get an instance of composite matcher that gives a match if any of sub-matchers match.
     *
     * @param PathMatcherInterface ...$matchers Matchers to check.
     */
    public static function any(PathMatcherInterface ...$matchers): self
    {
        return new self(true, ...$matchers);
    }

    /**
     * Get an instance of composite matcher that gives a match only if all of sub-matchers match.
     *
     * @param PathMatcherInterface ...$matchers Matchers to check.
     */
    public static function all(PathMatcherInterface ...$matchers): self
    {
        return new self(false, ...$matchers);
    }

    public function match(string $path): ?bool
    {
        $allNulls = true;

        foreach ($this->matchers as $matcher) {
            $match = $matcher->match($path);

            if ($match === null) {
                continue;
            }

            $allNulls = false;

            if ($this->matchAny && $match) {
                return true;
            }

            if (!$this->matchAny && !$match) {
                return false;
            }
        }

        return $allNulls ? null : !$this->matchAny;
    }
}