App

在 PHP 中没有默认路由器。 因此，提供了 \Dapr\App 类。 它在内部使用Nikic的FastRoute。 然而，你可以自由地使用任何你喜欢的路由或框架。 只需查看 App 类中的 add_dapr_routes() 方法，即可了解如何实现 actor 和 订阅。

每个应用都应该以 App::create() 开头，它需要两个参数，第一个是现有的DI容器，如果您有一个，第二个是回调到 ContainerBuilder 并添加您自己的配置。

从那里，您应该定义您的路由，然后调用 $app->start() 来执行当前请求的路由。

  1. <?php
  2. // app.php
  4. require_once __DIR__ . '/vendor/autoload.php';
  6. $app = \Dapr\App::create(configure: fn(\DI\ContainerBuilder $builder) => $builder->addDefinitions('config.php'));
  8. // add a controller for GET /test/{id} that returns the id
  9. $app->get('/test/{id}', fn(string $id) => $id);
  11. $app->start();

从控制器返回

从控制器返回任何数据都会被序列化为 json 对象。 您也可以请求 Psr Response对象并返回该对象，允许您自定义 headers 并控制整个响应：

  1. <?php
  2. $app = \Dapr\App::create(configure: fn(\DI\ContainerBuilder $builder) => $builder->addDefinitions('config.php'));
  4. // add a controller for GET /test/{id} that returns the id
  5. $app->get('/test/{id}', 
  6.     fn(
  7.         string $id, 
  8.         \Psr\Http\Message\ResponseInterface $response, 
  9.         \Nyholm\Psr7\Factory\Psr17Factory $factory) => $response->withBody($factory->createStream($id)));
  11. $app->start();

将应用程序作为客户端

当你只想将Dapr作为客户端使用，比如在现有代码中，你可以调用$app->run()。 通常情况下，特别是在生产中不需要自定义配置，但您可能想使用编译的DI 容器：

  1. <?php
  2. // app.php
  4. require_once __DIR__ . '/vendor/autoload.php';
  6. $app = \Dapr\App::create(configure: fn(\DI\ContainerBuilder $builder) => $builder->enableCompilation(__DIR__));
  7. $result = $app->run(fn(\Dapr\DaprClient $client) => $client->get('/invoke/other-app/method/my-method'));

在其他框架中使用

一个 DaprClient 对象被提供，事实上，所有由 App 对象使用的功能都是基于 DaprClient 构建的。

  1. <?php
  3. require_once __DIR__ . '/vendor/autoload.php';
  5. $clientBuilder = \Dapr\Client\DaprClient::clientBuilder();
  7. // you can customize (de)serialization or comment out to use the default JSON serializers.
  8. $clientBuilder = $clientBuilder->withSerializationConfig($yourSerializer)->withDeserializationConfig($yourDeserializer);
  10. // you can also pass it a logger
  11. $clientBuilder = $clientBuilder->withLogger($myLogger);
  13. // and change the url of the sidecar, for example, using https
  14. $clientBuilder = $clientBuilder->useHttpClient('https://localhost:3800')

在调用之前，您可以调用几个函数