Разрешимые аргументы

Замыкание, возвращённое из фронт-контроллера, может иметь 0 или более аргументов:

1
2
3
4
5
6
7
8
9
10

<?php
// public/index.php
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) {
    // ...
};

Следующие аргументы поддерживаются 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. Однако, поддерживается ряд различных приложений:

1
2
3
4
5
6
7
8
9

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

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

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

SymfonyRuntime может работать с такими приложениями:

HttpKernelInterface

Приложение будет запущено с HttpKernelRunner, как и "стандартное" приложение Symfony.

Response

Ответ будет выведен ResponseRunner:

1
2
3
4
5
6
7
8
9

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

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

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

Command

Для написания приложений одной строки. Это будет использовать ConsoleApplicationRunner:

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

<?php

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 function (Command $command) {
    $command->setCode(function (InputInterface $input, OutputInterface $output) {
        $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
20
21

<?php

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 function (array $context) {
    $command = new Command('hello');
    $command->setCode(function (InputInterface $input, OutputInterface $output) {
        $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
16

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

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

return function () {
    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
13
14

<?php
// public/index.php

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

return function () {
    $app = function() {
        echo 'Hello World';

        return 0;
    };

    return $app;
};

void

Если вызываемое ничего не возвращает, SymfonyRuntime предположит, что все хорошо:

1
2
3
4
5
6
7

<?php

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

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

Использование опций

Некоторое поведение сред исполнения можно изменять с помощью их опций. Они могут быть установлены, используя переменную окружения APP_RUNTIME_OPTIONS:

1
2
3
4
5
6
7
8
9

<?php

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

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

// ...

Вы также можете сконфигурировать extra.runtime.options в composer.json:

1
2
3
4
5
6
7
8
9
10

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

Следующие опции поддерживаются SymfonyRuntime:

env (по умолчанию: переменная окружения APP_ENV или "dev")

Для определения названия окружения, в котором выполняется приложение.

disable_dotenv (по умолчанию: false)

Для отключения поиска файлов .env.

dotenv_path (по умолчанию: .env)

Для определения пути файлов dot-env.

dotenv_overload (default: false)

Чтобы сообщить Dotenv, надо ли переопределять переменные .env на .env.local (или другие файлы .env.*)

use_putenv

Для указания Dotenv установить переменные окружения, используя putenv() (НЕ РЕКОМЕНДУЕТСЯ).

prod_envs (по умолчанию: ["prod"])

Для определения названий окружений производства.

test_envs (по умолчанию: ["test"])

Для определения названий тестовых окружений.

Кроме этого, GenericRuntime и SymfonyRuntime также поддерживают такие опции:

debug (по умолчанию: значение переменной окружения, определенной опцией

debug_var_name (обычно - APP_DEBUG), или true, если такая переменная окружения не определена) Переключает режим отладки приложений Symfony (например, чтобы отображать ошибки)

runtimes

Маршрутизирует "типы приложений" к реализации GenericRuntime, которая знает, как работать с каждым из них.

error_handler (по умолчанию: BasicErrorHandler или SymfonyErrorHandler для SymfonyRuntime)

Определяет класс, который нужно использовать для обработки PHP-ошибок.

env_var_name (по умолчанию: "APP_ENV")

Определяет имя переменной окружения, которая хранит имя окружения конфигурации environment , чтобы использовать при запуске приложения.

debug_var_name (по умолчанию: "APP_DEBUG")

Определяет имя переменной окружения, которая хранит значение флажка режима отладки , чтобы использовать при запуске приложения.