Admin

name	type	size	perms	modified	actions
[parent directory]
Api/	dir	-	0755	2026-07-06 14:50:35
Builder/	dir	-	0755	2026-07-06 14:50:35
Interface/	dir	-	0755	2026-07-06 14:50:35
Rule/	dir	-	0755	2026-07-06 14:50:35
Stub/	dir	-	0755	2026-07-06 14:50:35
Invocation.php	file	3,970 B	0644	2026-07-06 14:50:35	edit
InvocationHandler.php	file	3,986 B	0644	2026-07-06 14:50:35	edit
Matcher.php	file	6,493 B	0644	2026-07-06 14:50:35	edit
MethodNameConstraint.php	file	1,078 B	0644	2026-07-06 14:50:35	edit
ReturnValueGenerator.php	file	7,628 B	0644	2026-07-06 14:50:35	edit

editing: Matcher.php

<?php declare(strict_types=1);
/*
 * This file is part of PHPUnit.
 *
 * (c) Sebastian Bergmann <sebastian@phpunit.de>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace PHPUnit\Framework\MockObject;

use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Rule\AnyInvokedCount;
use PHPUnit\Framework\MockObject\Rule\AnyParameters;
use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
use PHPUnit\Framework\MockObject\Rule\InvokedAtMostCount;
use PHPUnit\Framework\MockObject\Rule\InvokedCount;
use PHPUnit\Framework\MockObject\Rule\MethodName;
use PHPUnit\Framework\MockObject\Rule\ParametersRule;
use PHPUnit\Framework\MockObject\Stub\Stub;
use PHPUnit\Util\ThrowableToStringMapper;

/**
 * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
 *
 * @internal This class is not covered by the backward compatibility promise for PHPUnit
 */
final class Matcher
{
    private readonly InvocationOrder $invocationRule;
    private ?string $afterMatchBuilderId    = null;
    private ?MethodName $methodNameRule     = null;
    private ?ParametersRule $parametersRule = null;
    private ?Stub $stub                     = null;

public function __construct(InvocationOrder $rule)
    {
        $this->invocationRule = $rule;
    }

public function hasMatchers(): bool
    {
        return !$this->invocationRule instanceof AnyInvokedCount;
    }

public function hasMethodNameRule(): bool
    {
        return $this->methodNameRule !== null;
    }

public function methodNameRule(): MethodName
    {
        return $this->methodNameRule;
    }

public function setMethodNameRule(MethodName $rule): void
    {
        $this->methodNameRule = $rule;
    }

public function hasParametersRule(): bool
    {
        return $this->parametersRule !== null;
    }

public function setParametersRule(ParametersRule $rule): void
    {
        $this->parametersRule = $rule;
    }

public function setStub(Stub $stub): void
    {
        $this->stub = $stub;
    }

public function setAfterMatchBuilderId(string $id): void
    {
        $this->afterMatchBuilderId = $id;
    }

/**
     * @throws Exception
     * @throws ExpectationFailedException
     * @throws MatchBuilderNotFoundException
     * @throws MethodNameNotConfiguredException
     * @throws RuntimeException
     */
    public function invoked(Invocation $invocation): mixed
    {
        if ($this->methodNameRule === null) {
            throw new MethodNameNotConfiguredException;
        }

if ($this->afterMatchBuilderId !== null) {
            $matcher = $invocation->object()
                ->__phpunit_getInvocationHandler()
                ->lookupMatcher($this->afterMatchBuilderId);

if (!$matcher) {
                throw new MatchBuilderNotFoundException($this->afterMatchBuilderId);
            }
        }

$this->invocationRule->invoked($invocation);

try {
            $this->parametersRule?->apply($invocation);
        } catch (ExpectationFailedException $e) {
            throw new ExpectationFailedException(
                sprintf(
                    "Expectation failed for %s when %s\n%s",
                    $this->methodNameRule->toString(),
                    $this->invocationRule->toString(),
                    $e->getMessage(),
                ),
                $e->getComparisonFailure(),
            );
        }

if ($this->stub) {
            return $this->stub->invoke($invocation);
        }

return $invocation->generateReturnValue();
    }

/**
     * @throws ExpectationFailedException
     * @throws MatchBuilderNotFoundException
     * @throws MethodNameNotConfiguredException
     * @throws RuntimeException
     */
    public function matches(Invocation $invocation): bool
    {
        if ($this->afterMatchBuilderId !== null) {
            $matcher = $invocation->object()
                ->__phpunit_getInvocationHandler()
                ->lookupMatcher($this->afterMatchBuilderId);

if (!$matcher) {
                throw new MatchBuilderNotFoundException($this->afterMatchBuilderId);
            }

if (!$matcher->invocationRule->hasBeenInvoked()) {
                return false;
            }
        }

if ($this->methodNameRule === null) {
            throw new MethodNameNotConfiguredException;
        }

if (!$this->invocationRule->matches($invocation)) {
            return false;
        }

try {
            if (!$this->methodNameRule->matches($invocation)) {
                return false;
            }
        } catch (ExpectationFailedException $e) {
            throw new ExpectationFailedException(
                sprintf(
                    "Expectation failed for %s when %s\n%s",
                    $this->methodNameRule->toString(),
                    $this->invocationRule->toString(),
                    $e->getMessage(),
                ),
                $e->getComparisonFailure(),
            );
        }

return true;
    }

/**
     * @throws ExpectationFailedException
     * @throws MethodNameNotConfiguredException
     */
    public function verify(): void
    {
        if ($this->methodNameRule === null) {
            throw new MethodNameNotConfiguredException;
        }

try {
            $this->invocationRule->verify();

if ($this->parametersRule === null) {
                $this->parametersRule = new AnyParameters;
            }

$invocationIsAny    = $this->invocationRule instanceof AnyInvokedCount;
            $invocationIsNever  = $this->invocationRule instanceof InvokedCount && $this->invocationRule->isNever();
            $invocationIsAtMost = $this->invocationRule instanceof InvokedAtMostCount;

if (!$invocationIsAny && !$invocationIsNever && !$invocationIsAtMost) {
                $this->parametersRule->verify();
            }
        } catch (ExpectationFailedException $e) {
            throw new ExpectationFailedException(
                sprintf(
                    "Expectation failed for %s when %s.\n%s",
                    $this->methodNameRule->toString(),
                    $this->invocationRule->toString(),
                    ThrowableToStringMapper::map($e),
                ),
            );
        }
    }
}

cancel