README

通用和可扩展的可调用执行器。

为什么？

谁不需要一个过度设计的 call_user_func()？

命名参数

这个 Silex 示例看起来熟悉吗？

$app->get('/project/{project}/issue/{issue}', function ($project, $issue) {
    // ...
});

或者这个使用 Silly 定义的命令？

$app->command('greet [name] [--yell]', function ($name, $yell) {
    // ...
});

在 Slim 中也有相同的模式

$app->get('/hello/:name', function ($name) {
    // ...
});

你明白了。这些框架使用类似于命名参数的方式来调用控制器/命令/处理器：无论参数的顺序如何，它们都通过名称进行匹配。

这个库允许以通用和可扩展的方式调用具有命名参数的可调用对象。

依赖注入

熟悉 AngularJS 的人都知道如何执行依赖注入

angular.controller('MyController', ['dep1', 'dep2', function(dep1, dep2) {
    // ...
}]);

在 PHP 中，我们在一些框架和 DI 容器中再次找到了这种模式，并提供了部分到全部的支持。例如，在 Silex 中，您可以对应用程序进行类型提示以获取注入，但它仅适用于 Silex\Application

$app->get('/hello/{name}', function (Silex\Application $app, $name) {
    // ...
});

在 Silly 中，它仅适用于 OutputInterface 以注入应用程序输出

$app->command('greet [name]', function ($name, OutputInterface $output) {
    // ...
});

PHP-DI 提供了一种方法，通过类型提示调用可调用对象并从容器中解析所有依赖关系

$container->call(function (Logger $logger, EntityManager $em) {
    // ...
});

这个库提供了清晰的扩展点，让框架实现它们想要的任何类型的依赖注入支持。

TL/DR

简而言之，这个库旨在成为调用带命名参数和/或依赖注入的函数的基本构建块。

安装

$ composer require PHP-DI/invoker

用法

默认行为

默认情况下，Invoker 可以使用命名参数进行调用

$invoker = new Invoker\Invoker;

$invoker->call(function () {
    echo 'Hello world!';
});

// Simple parameter array
$invoker->call(function ($name) {
    echo 'Hello ' . $name;
}, ['John']);

// Named parameters
$invoker->call(function ($name) {
    echo 'Hello ' . $name;
}, [
    'name' => 'John'
]);

// Use the default value
$invoker->call(function ($name = 'world') {
    echo 'Hello ' . $name;
});

// Invoke any PHP callable
$invoker->call(['MyClass', 'myStaticMethod']);

// Using Class::method syntax
$invoker->call('MyClass::myStaticMethod');

参数中的依赖注入受支持，但需要配置您的容器。如果您不耐烦，请阅读或跳转到 内置的依赖注入支持

此外，可调用对象也可以从您的容器中解析出来。如果您不耐烦，请阅读或跳转到 从容器解析可调用对象

参数解析器

通过实现 ParameterResolver 来扩展 Invoker 的行为很容易。

这已在参数解析器文档中进行了详细说明。

内置的依赖注入支持

而不是让您每次都重新实现不同容器的依赖注入支持，这个包提供了 2 个可选解析器

TypeHintContainerResolver

这个解析器将通过使用类型提示搜索类名来注入容器条目
```
$invoker->call(function (Psr\Logger\LoggerInterface $logger) {
    // ...
});
```
在这个例子中，它将从容器中 ->get('Psr\Logger\LoggerInterface') 并进行注入。

如果使用类（或接口）名称在容器中存储对象，则此解析器非常有用。例如，Silex 或 Symfony 将服务存储在自定义名称（例如 twig、db 等）下而不是类名：在这种情况下，请使用下面的解析器。
ParameterNameContainerResolver

这个解析器将通过搜索参数名称来注入容器条目
```
$invoker->call(function ($twig) {
    // ...
});
```
在这个例子中，它将从容器中 ->get('twig') 获取并注入。

这些解析器可以与任何符合 PSR-11 的依赖注入容器一起工作。

设置这些解析器非常简单

// $container must be an instance of Psr\Container\ContainerInterface
$container = ...

$containerResolver = new TypeHintContainerResolver($container);
// or
$containerResolver = new ParameterNameContainerResolver($container);

$invoker = new Invoker\Invoker;
// Register it before all the other parameter resolvers
$invoker->getParameterResolver()->prependResolver($containerResolver);

如果您愿意，还可以同时注册这两个解析器。实现对更复杂事物的支持也很容易，由您决定！

从容器中解析可调用对象

可以将 Invoker 连接到您的 DI 容器以解析可调用对象。

例如，对于可调用的类

class MyHandler
{
    public function __invoke()
    {
        // ...
    }
}

// By default this doesn't work: an instance of the class should be provided
$invoker->call('MyHandler');

// If we set up the container to use
$invoker = new Invoker\Invoker(null, $container);
// Now 'MyHandler' is resolved using the container!
$invoker->call('MyHandler');

对于类方法也是同样的效果

class WelcomeController
{
    public function home()
    {
        // ...
    }
}

// By default this doesn't work: home() is not a static method
$invoker->call(['WelcomeController', 'home']);

// If we set up the container to use
$invoker = new Invoker\Invoker(null, $container);
// Now 'WelcomeController' is resolved using the container!
$invoker->call(['WelcomeController', 'home']);
// Alternatively we can use the Class::method syntax
$invoker->call('WelcomeController::home');

该特性可以用作框架调度器的基石。

同样，任何符合 PSR-11 的容器都可以提供。

php-di / invoker

维护者

详细信息