Розвʼязувані аргументи

Замикання, повернене з фронт-контролера, може мати 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 - це спосіб використовувати користувацький додаток зі спільним Рантаймом:

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 (за замовчуванням: 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")

Визначає імʼя змінної середовища, яка зберігає імʼя середовища конфігурації , щоб викоритати при запуску додатку.

debug_var_name (за замовчуванням: "APP_DEBUG")

Визначає імʼя змінної середовища, яка зберігає значення прапорця режиму налагодження , щоб викоритати при запуску додатку.