summaryrefslogtreecommitdiff
path: root/vendor/phpunit/phpunit/src/Framework/MockObject/InvocationHandler.php
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/phpunit/phpunit/src/Framework/MockObject/InvocationHandler.php')
-rw-r--r--vendor/phpunit/phpunit/src/Framework/MockObject/InvocationHandler.php186
1 files changed, 186 insertions, 0 deletions
diff --git a/vendor/phpunit/phpunit/src/Framework/MockObject/InvocationHandler.php b/vendor/phpunit/phpunit/src/Framework/MockObject/InvocationHandler.php
new file mode 100644
index 000000000..b9d62610a
--- /dev/null
+++ b/vendor/phpunit/phpunit/src/Framework/MockObject/InvocationHandler.php
@@ -0,0 +1,186 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <[email protected]>
+ *
+ * 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 strtolower;
+use Exception;
+use PHPUnit\Framework\MockObject\Builder\InvocationMocker;
+use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
+use Throwable;
+
+/**
+ * @internal This class is not covered by the backward compatibility promise for PHPUnit
+ */
+final class InvocationHandler
+{
+ /**
+ * @var Matcher[]
+ */
+ private $matchers = [];
+
+ /**
+ * @var Matcher[]
+ */
+ private $matcherMap = [];
+
+ /**
+ * @var ConfigurableMethod[]
+ */
+ private $configurableMethods;
+
+ /**
+ * @var bool
+ */
+ private $returnValueGeneration;
+
+ /**
+ * @var Throwable
+ */
+ private $deferredError;
+
+ public function __construct(array $configurableMethods, bool $returnValueGeneration)
+ {
+ $this->configurableMethods = $configurableMethods;
+ $this->returnValueGeneration = $returnValueGeneration;
+ }
+
+ public function hasMatchers(): bool
+ {
+ foreach ($this->matchers as $matcher) {
+ if ($matcher->hasMatchers()) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Looks up the match builder with identification $id and returns it.
+ *
+ * @param string $id The identification of the match builder
+ */
+ public function lookupMatcher(string $id): ?Matcher
+ {
+ if (isset($this->matcherMap[$id])) {
+ return $this->matcherMap[$id];
+ }
+
+ return null;
+ }
+
+ /**
+ * Registers a matcher with the identification $id. The matcher can later be
+ * looked up using lookupMatcher() to figure out if it has been invoked.
+ *
+ * @param string $id The identification of the matcher
+ * @param Matcher $matcher The builder which is being registered
+ *
+ * @throws MatcherAlreadyRegisteredException
+ */
+ public function registerMatcher(string $id, Matcher $matcher): void
+ {
+ if (isset($this->matcherMap[$id])) {
+ throw new MatcherAlreadyRegisteredException($id);
+ }
+
+ $this->matcherMap[$id] = $matcher;
+ }
+
+ public function expects(InvocationOrder $rule): InvocationMocker
+ {
+ $matcher = new Matcher($rule);
+ $this->addMatcher($matcher);
+
+ return new InvocationMocker(
+ $this,
+ $matcher,
+ ...$this->configurableMethods
+ );
+ }
+
+ /**
+ * @throws Exception
+ * @throws RuntimeException
+ */
+ public function invoke(Invocation $invocation)
+ {
+ $exception = null;
+ $hasReturnValue = false;
+ $returnValue = null;
+
+ foreach ($this->matchers as $match) {
+ try {
+ if ($match->matches($invocation)) {
+ $value = $match->invoked($invocation);
+
+ if (!$hasReturnValue) {
+ $returnValue = $value;
+ $hasReturnValue = true;
+ }
+ }
+ } catch (Exception $e) {
+ $exception = $e;
+ }
+ }
+
+ if ($exception !== null) {
+ throw $exception;
+ }
+
+ if ($hasReturnValue) {
+ return $returnValue;
+ }
+
+ if (!$this->returnValueGeneration) {
+ $exception = new ReturnValueNotConfiguredException($invocation);
+
+ if (strtolower($invocation->getMethodName()) === '__tostring') {
+ $this->deferredError = $exception;
+
+ return '';
+ }
+
+ throw $exception;
+ }
+
+ return $invocation->generateReturnValue();
+ }
+
+ public function matches(Invocation $invocation): bool
+ {
+ foreach ($this->matchers as $matcher) {
+ if (!$matcher->matches($invocation)) {
+ return false;
+ }
+ }
+
+ return true;
+ }
+
+ /**
+ * @throws Throwable
+ */
+ public function verify(): void
+ {
+ foreach ($this->matchers as $matcher) {
+ $matcher->verify();
+ }
+
+ if ($this->deferredError) {
+ throw $this->deferredError;
+ }
+ }
+
+ private function addMatcher(Matcher $matcher): void
+ {
+ $this->matchers[] = $matcher;
+ }
+}