Yiisoft\Files\PathMatcher\CompositeMatcher

Complexity

Total Complexity

11

Size/Duplication

Total Lines	63
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

4 Methods

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

<?php

declare(strict_types=1);

namespace Yiisoft\Files\PathMatcher;

use InvalidArgumentException;
use function get_class;
use function is_object;

/**
 * Composite matcher allows combining several matchers.
 */
final class CompositeMatcher implements PathMatcherInterface
{
    private bool $matchAny;

    /**
     * @var array PathMatcherInterface[]
     */
    private array $matchers;

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

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

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

        /** @var PathMatcherInterface $matcher */
        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;
    }
}