ArgumentsResolver allows you to determine the arguments to pass to a function or method.

Fund package maintenance!

v0.6.2 2021-06-22 13:40 UTC

This package is auto-updated.

Last update: 2023-01-10 02:17:51 UTC


Quality Assurance Scrutinizer Code Quality Code Coverage

ArgumentsResolver allows you to determine the arguments to pass to a function or method.


The recommended way to install ArgumentsResolver is through Composer:

composer require rybakit/arguments-resolver

Usage example

use ArgumentsResolver\InDepthArgumentsResolver;

$greet = function ($username, DateTime $date, $greeting = 'Hello %s!') {
    // ...

$parameters = [
    'Welcome %s!',
    new DateTime(),
    'username' => 'Stranger',

$arguments = (new InDepthArgumentsResolver($greet))->resolve($parameters);

The above example will output:

    [0] => Stranger
    [1] => DateTime Object (...)
    [2] => Welcome %s!


The library ships with two resolvers, the InDepthArgumentsResolver and NamedArgumentsResolver. They both expect a function to be supplied as a single constructor argument. The function can be any callable, a string representing a class method or an instance of ReflectionFunctionAbstract:

new InDepthArgumentsResolver(['MyClass', 'myMethod']);
new InDepthArgumentsResolver([new MyClass(), 'myMethod']);
new InDepthArgumentsResolver(['MyClass', 'myStaticMethod']);
new InDepthArgumentsResolver('MyClass::myStaticMethod');
new InDepthArgumentsResolver('MyClass::__construct');
new InDepthArgumentsResolver(['MyClass', '__construct']);
new InDepthArgumentsResolver(new MyInvokableClass());
new InDepthArgumentsResolver(function ($foo) {});
new InDepthArgumentsResolver('MyNamespace\my_function');
new InDepthArgumentsResolver(new ReflectionMethod('MyClass', 'myMethod'));
new InDepthArgumentsResolver(new ReflectionFunction('MyNamespace\my_function'));

There is also an utility class which helps in creating a reflection instance:

use ArgumentsResolver\ReflectionFactory;

$reflection = ReflectionFactory::create('MyClass::__construct');
$resolver = new InDepthArgumentsResolver($reflection);


In the InDepthArgumentsResolver, the decision about whether an argument matched the parameter value or not is influenced by multiple factors, namely the argument's type, the class hierarchy (if it's an object), the argument name and the argument position.

To clarify, consider each circumstance in turn:

Argument type

function foo(array $array, stdClass $object, callable $callable) {}

(new InDepthArgumentsResolver('foo'))->resolve([
    function () {},    // $callable
    new stdClass(),    // $object
    [42],              // $array

Class hierarchy

function foo(Exception $e, RuntimeException $re) {}

(new InDepthArgumentsResolver('foo'))->resolve([
    new RuntimeException(),    // $re
    new Exception(),           // $e

Argument name

function foo($a, $b) {}

(new InDepthArgumentsResolver('foo'))->resolve([
    'c' => 3,
    'b' => 2,    // $b
    'a' => 1,    // $a

Argument position

function foo($a, $b) {}

(new InDepthArgumentsResolver('foo'))->resolve([
    1,   // $a
    2,   // $b


The NamedArgumentsResolver is a very simple resolver which does the matching only by the argument name. Therefore this requires parameters to be an associative array:

function foo($a, array $b, $c = null) {}

(new NamedArgumentsResolver('foo'))->resolve([
    'b' => [],       // $b
    'a' => 1,        // $a
    'c' => 'bar',    // $c


ArgumentsResolver uses PHPUnit for unit testing. In order to run the tests, you'll first need to setup the test suite using composer:

composer install

You can then run the tests:



ArgumentsResolver is released under the MIT License. See the bundled LICENSE file for details.