A PHP library to inject arguments to callables based on type hints and arguments' names
MIT License
This lightweight library helps to automatically call a callable (function, method or closure) with a list of available arguments. The developer of the callable can then use type hinting and/or specific variable names to chose which arguments (s)he wants.
The suggested installation method is via composer:
composer require sroze/argument-resolver
The argument resolver can be created easily using the ArgumentResolverFactory
class:
use ArgumentResolver\ArgumentResolverFactory;
$argumentResolver = ArgumentResolverFactory::create();
The resolveArguments
method returns an ordered array of resolved arguments for the given callable. The method's arguments
are:
Here's an example of how it can be used to have arguments of some closures based on a set of available arguments:
$closures = [
function(MyClass $object) {
return $object instanceof MyClass;
},
function($bar, array $list) {
return count($list);
}
];
foreach ($closures as $callable) {
$arguments = $argumentResolver->resolveArguments($callable, [
'classObject' => new MyClass(),
'bar' => 'foo',
'list' => ['an', 'array']
]);
// ...
}
More than argument identification with type hinting, you can also use names:
class Foo
{
public function method($foo, $bar)
{
}
}
$argumentResolver->resolveArguments([new Foo(), 'method'], [
'bar' => 1,
'foo' => 2,
'baz' => 3
]);
// Which returns: [2, 1]
To prevent possible conflicts, the library follow priorities and constraints described in the Rules chapter.
Because when you've resolved the needed arguments of a given callable it's often to call it, the library comes with a
CallableRunner
class that will do everything for you:
$runner = new CallableRunner($argumentResolver);
$runner->run($callable, $availableArguments);
Sometimes, you would like to instantiate an object with a set of arguments. Here's the Instanciator
usage:
$instantiator = new Instantiator($argumentResolver);
$instantiator->instantiate(YourClassName::class, $availableArguments);
These are the resolution priorities for the arguments:
The following constraints applies: