README

Resolves function and constructor parameters from a PSR-11 container by type.

Install

composer require respect/parameter

Usage

Resolve from a container

For each parameter the resolver tries, in order:

1. Positional argument of matching type
2. Container match by type (non-builtin)
3. Next positional argument
4. Default value
5. null

use Respect\Parameter\Resolver;

function notify(Mailer $mailer, Logger $logger, string $to, string $subject = 'Hi') {
    // ...
}

$resolver = new Resolver($container);
$args = $resolver->resolve(new ReflectionFunction('notify'), ['bob@example.com']);
// ['mailer' => Mailer, 'logger' => Logger, 'to' => 'bob@example.com', 'subject' => 'Hi']

Results are keyed by parameter name, so you can spread them with named arguments:

notify(...$args);

Resolve with named arguments

When arguments are keyed by name (e.g. from configuration):

$args = $resolver->resolveNamed(
    $constructor,
    ['username' => 'admin', 'password' => 'secret'],
);
// Named args take precedence, gaps filled from container by name and type

Reflect any callable

Convert any callable form into a ReflectionFunctionAbstract:

use Respect\Parameter\Resolver;

Resolver::reflectCallable(fn() => ...);                  // Closure
Resolver::reflectCallable([$obj, 'method']);             // Array callable
Resolver::reflectCallable(new Invocable());              // __invoke object
Resolver::reflectCallable('strlen');                     // Function name
Resolver::reflectCallable('DateTime::createFromFormat'); // Static method

Check accepted types

Resolver::acceptsType($reflection, LoggerInterface::class); // true/false

API

License

ISC. See LICENSE.