HEX
Server: Apache
System: Linux pdx1-shared-a1-38 6.6.104-grsec-jammy+ #3 SMP Tue Sep 16 00:28:11 UTC 2025 x86_64
User: mmickelson (3396398)
PHP: 8.1.31
Disabled: NONE
Upload Files
File: //usr/local/wp/vendor/behat/behat/src/Behat/Testwork/Argument/ConstructorArgumentOrganiser.php
<?php

/*
 * This file is part of the Behat Testwork.
 * (c) Konstantin Kudryashov <ever.zet@gmail.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Behat\Testwork\Argument;

use Behat\Testwork\Argument\Exception\UnknownParameterValueException;
use Behat\Testwork\Argument\Exception\UnsupportedFunctionException;
use ReflectionFunctionAbstract;
use ReflectionMethod;

/**
 * Organises constructor arguments.
 *
 * @author Konstantin Kudryashov <ever.zet@gmail.com>
 */
final class ConstructorArgumentOrganiser implements ArgumentOrganiser
{
    /**
     * @var ArgumentOrganiser
     */
    private $baseOrganiser;

    /**
     * Initializes organiser.
     *
     * @param ArgumentOrganiser $organiser
     */
    public function __construct(ArgumentOrganiser $organiser)
    {
        $this->baseOrganiser = $organiser;
    }

    /**
     * {@inheritdoc}
     */
    public function organiseArguments(ReflectionFunctionAbstract $constructor, array $arguments)
    {
        if (!$constructor instanceof ReflectionMethod) {
            throw new UnsupportedFunctionException(sprintf(
                'ConstructorArgumentOrganiser can only work with ReflectionMethod, but `%s` given.',
                get_class($constructor)
            ));
        }

        $organisedArguments = $this->baseOrganiser->organiseArguments(
            $constructor,
            $arguments
        );

        $this->validateArguments($constructor, $arguments, $organisedArguments);

        return $organisedArguments;
    }

    /**
     * Checks that all provided constructor arguments are present in the constructor.
     *
     * @param ReflectionMethod $constructor
     * @param mixed[]          $passedArguments
     * @param mixed[]          $organisedArguments
     *
     * @throws UnknownParameterValueException
     */
    private function validateArguments(
        ReflectionMethod $constructor,
        array $passedArguments,
        array $organisedArguments
    ) {
        foreach ($passedArguments as $key => $val) {
            if (array_key_exists($key, $organisedArguments)) {
                continue;
            }

            throw new UnknownParameterValueException(
                sprintf(
                    '`%s::__construct()` does not expect argument `$%s`.',
                    $constructor->getDeclaringClass()->getName(),
                    $key
                )
            );
        }
    }
}