The documentation you are viewing is for Dapr v1.12 which is an older version of Dapr. For up-to-date documentation, see the latest version.

App

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

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

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

<?php
// app.php

require_once __DIR__ . '/vendor/autoload.php';

$app = \Dapr\App::create(configure: fn(\DI\ContainerBuilder $builder) => $builder->addDefinitions('config.php'));

// add a controller for GET /test/{id} that returns the id
$app->get('/test/{id}', fn(string $id) => $id);

$app->start();

从控制器中返回

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

<?php
$app = \Dapr\App::create(configure: fn(\DI\ContainerBuilder $builder) => $builder->addDefinitions('config.php'));

// add a controller for GET /test/{id} that returns the id
$app->get('/test/{id}', 
    fn(
        string $id, 
        \Psr\Http\Message\ResponseInterface $response, 
        \Nyholm\Psr7\Factory\Psr17Factory $factory) => $response->withBody($factory->createStream($id)));

$app->start();

将应用程序作为客户端

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

<?php
// app.php

require_once __DIR__ . '/vendor/autoload.php';

$app = \Dapr\App::create(configure: fn(\DI\ContainerBuilder $builder) => $builder->enableCompilation(__DIR__));
$result = $app->run(fn(\Dapr\DaprClient $client) => $client->get('/invoke/other-app/method/my-method'));