运行时组件

可解析的参数

从前端控制器返回的闭包可以有零个或多个参数

1
2
3
4
5
6
7
8
9
10

// public/index.php
use Symfony\Bundle\FrameworkBundle\Console\Application;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';

return function (InputInterface $input, OutputInterface $output): Application {
    // ...
};

以下参数受 SymfonyRuntime 支持

Request

从全局变量创建的请求。

InputInterface

用于读取选项和参数的输入。

OutputInterface

用于使用样式打印到 CLI 的控制台输出。

Application

用于创建 CLI 应用程序的应用程序。

Command

用于创建单行命令 CLI 应用程序（使用 Command::setCode()）。

以下参数同时受 SymfonyRuntime 和 GenericRuntime 支持（类型和变量名都很重要）

array $context

这与 $_SERVER + $_ENV 相同。

array $argv

传递给命令的参数（与 $_SERVER['argv'] 相同）。

array $request

具有键 query、body、files 和 session。

可解析的应用程序

以下闭包返回的应用程序是 Symfony Kernel。但是，支持多种不同的应用程序

1
2
3
4
5
6
7
8

// public/index.php
use App\Kernel;

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';

return static function (): Kernel {
    return new Kernel('prod', false);
};

SymfonyRuntime 可以处理以下应用程序

HttpKernelInterface

应用程序将使用 HttpKernelRunner 运行，就像“标准” Symfony 应用程序一样。

Response

Response 将由 ResponseRunner 打印

1
2
3
4
5
6
7
8

// public/index.php
use Symfony\Component\HttpFoundation\Response;

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';

return static function (): Response {
    return new Response('Hello world');
};

Command

用于编写单命令应用程序。这将使用 ConsoleApplicationRunner

1
2
3
4
5
6
7
8
9
10
11
12
13

use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';

return static function (Command $command): Command {
    $command->setCode(static function (InputInterface $input, OutputInterface $output): void {
        $output->write('Hello World');
    });

    return $command;
};

Application

对于具有多个命令的控制台应用程序很有用。这将使用 ConsoleApplicationRunner

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

use Symfony\Component\Console\Application;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';

return static function (array $context): Application {
    $command = new Command('hello');
    $command->setCode(static function (InputInterface $input, OutputInterface $output): void {
        $output->write('Hello World');
    });

    $app = new Application();
    $app->add($command);
    $app->setDefaultCommand('hello', true);

    return $app;
};

GenericRuntime 和 SymfonyRuntime 也支持以下通用应用程序

RunnerInterface

RunnerInterface 是一种将自定义应用程序与通用 Runtime 一起使用的方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

// public/index.php
use Symfony\Component\Runtime\RunnerInterface;

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';

return static function (): RunnerInterface {
    return new class implements RunnerInterface {
        public function run(): int
        {
            echo 'Hello World';

            return 0;
        }
    };
};

callable

您的“应用程序”也可以是 callable。第一个可调用对象将返回“应用程序”，而第二个可调用对象是“应用程序”本身

1
2
3
4
5
6
7
8
9
10
11
12

// public/index.php
require_once dirname(__DIR__).'/vendor/autoload_runtime.php';

return static function (): callable {
    $app = static function(): int {
        echo 'Hello World';

        return 0;
    };

    return $app;
};

void

如果可调用对象不返回任何内容，则 SymfonyRuntime 将假定一切正常

1
2
3
4
5

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';

return function (): void {
    echo 'Hello world';
};

使用选项

Runtimes 的某些行为可以通过运行时选项进行修改。它们可以使用 APP_RUNTIME_OPTIONS 环境变量进行设置

1
2
3
4
5
6
7

$_SERVER['APP_RUNTIME_OPTIONS'] = [
    'project_dir' => '/var/task',
];

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';

// ...

您还可以在 composer.json 中配置 extra.runtime

1
2
3
4
5
6
7
8
9
10

{
    "require": {
        "...": "..."
    },
    "extra": {
        "runtime": {
            "project_dir": "/var/task"
        }
    }
}

然后，更新您的 Composer 文件（例如，运行 composer dump-autoload），以便使用新选项重新生成 vendor/autoload_runtime.php 文件。

以下选项受 SymfonyRuntime 支持

env (默认值：APP_ENV 环境变量，或 "dev")

用于定义应用程序运行所在环境的名称。

disable_dotenv (默认值：false)

用于禁用查找 .env 文件。

dotenv_path (默认值：.env)

用于定义 dot-env 文件的路径。

dotenv_overload (默认值：false)

告诉 Dotenv 是否使用 .env.local（或其他 .env.* 文件）覆盖 .env 变量

use_putenv

告诉 Dotenv 使用 putenv() 设置环境变量（不推荐）。

prod_envs (默认值：["prod"])

用于定义生产环境的名称。

test_envs (默认值：["test"])

用于定义测试环境的名称。

除了这些之外，GenericRuntime 和 SymfonyRuntime 还支持以下选项

debug (默认值：由 debug_var_name 选项定义的环境变量的值

（通常为 APP_DEBUG），如果未定义此类环境变量，则为 true) 切换 Symfony 应用程序的 debug 模式（例如，显示错误）

runtimes

将“应用程序类型”映射到知道如何处理每种类型的 GenericRuntime 实现。

error_handler (默认值：BasicErrorHandler 或 SymfonyErrorHandler 用于 SymfonyRuntime)

定义用于处理 PHP 错误的类。

env_var_name (默认值："APP_ENV")

定义存储 配置环境 名称的环境变量的名称，该名称在运行应用程序时使用。

debug_var_name (默认值："APP_DEBUG")

定义存储 debug 模式 标志值的环境变量的名称，该标志值在运行应用程序时使用。