Spec-Zone.ru › Symfony 3.2

Ядро

класс Kernel реализует KernelInterface, TerminableInterface

Ядро — сердце системы Symfony.

Оно управляет средой, состоящей из пакетов.

Константы

VERSION
VERSION_ID
MAJOR_VERSION
MINOR_VERSION
RELEASE_VERSION
EXTRA_VERSION
END_OF_MAINTENANCE
END_OF_LIFE

Методы

__construct(string $environment, bool $debug)

Конструктор.

__clone()
boot()

Запускает текущее ядро.

terminate(Request $request, Response $response)

Завершает цикл запроса/ответа.

shutdown()

Выключает ядро.

Response handle(Request $request, int $type = HttpKernelInterface::MASTER_REQUEST, bool $catch = true)

Обрабатывает запрос для преобразования его в ответ.

BundleInterface[] getBundles()

Получает зарегистрированные экземпляры пакетов.

BundleInterface|BundleInterface[] getBundle(string $name, bool $first = true)

Возвращает пакет и, необязательно, его потомков по его имени.

string|array locateResource(string $name, string $dir = null, bool $first = true)

Возвращает путь к файлу для данного ресурса.

string getName()

Получает имя ядра.

string getEnvironment()

Получает среду.

bool isDebug()

Проверяет, включен ли режим отладки.

string getRootDir()

Получает корневую директорию приложения.

ContainerInterface getContainer()

Получает текущий контейнер.

loadClassCache(string $name = 'classes', string $extension = '.php')

Загружает кеш PHP-классов.

setClassCache(array $classes)
setAnnotatedClassCache(array $annotatedClasses)
int getStartTime()

Получает время начала запроса (не доступно, если отладка отключена).

string getCacheDir()

Получает директорию кеша.

string getLogDir()

Получает директорию логов.

string getCharset()

Получает кодировку приложения.

static string stripComments(string $source)

Удаляет комментарии из строки PHP-кода.

serialize()
unserialize($data)

Подробности

__construct(string $environment, bool $debug)

Конструктор.

Параметры

string $environment Среда
bool $debug Включить отладку или нет

__clone()

boot()

Запускает текущее ядро.

terminate(Request $request, Response $response)

Завершает цикл запроса/ответа.

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

Параметры

Request $request Объект Request
Response $response Объект Response

shutdown()

Завершает работу ядра.

Этот метод полезен, в основном, при функциональном тестировании.

Response handle(Request $request, int $type = HttpKernelInterface::MASTER_REQUEST, bool $catch = true)

Обрабатывает запрос, преобразуя его в ответ.

Если $catch равен true, реализация должна перехватывать все исключения и постараться преобразовать их в объект Response.

Параметры

Request $request Объект Request
int $type Тип запроса (HttpKernelInterface::MASTER_REQUEST или HttpKernelInterface::SUB_REQUEST)
bool $catch Перехватывать исключения или нет

Значение результата

Response Объект Response

Исключения

Exception При возникновении исключения во время обработки

BundleInterface[] getBundles()

Возвращает зарегистрированные экземпляры пакетов.

Значение результата

BundleInterface[] Массив зарегистрированных экземпляров пакетов

BundleInterface|BundleInterface[] getBundle(string $name, bool $first = true)

Возвращает пакет и (по желанию) его потомков по имени.

Параметры

string $name Имя пакета
bool $first Возвращать только первый пакет или вместе с его потомками

Значение результата

BundleInterface|BundleInterface[] Экземпляр BundleInterface или массив экземпляров BundleInterface, если $first равен false

Исключения

InvalidArgumentException если пакет не включён

string|array locateResource(string $name, string $dir = null, bool $first = true)

Возвращает путь к файлу для данного ресурса.

Ресурс может быть файлом или директорией.

Имя ресурса должно соответствовать следующему шаблону:

"@BundleName/path/to/a/file.something"

где BundleName — имя пакета, а оставшаяся часть — относительный путь в пакете.

Если передан $dir, и первый сегмент пути — "Resources", этот метод будет искать файл с именем:

$dir/<BundleName>/path/without/Resources

перед поиском в папке ресурсов пакета.

Параметры

string $name Имя ресурса для поиска
string $dir Директория, в которой сначала следует искать ресурс
bool $first Возвращать первый путь или пути для всех соответствующих пакетов

Значение результата

string|array Абсолютный путь к ресурсу или массив, если $first равен false

Исключения

InvalidArgumentException если файл не найден или имя некорректно
RuntimeException если имя содержит недопустимые/небезопасные символы

string getName()

Возвращает имя ядра.

Значение результата

string Имя ядра

string getEnvironment()

Возвращает среду.

Значение результата

string Текущая среда

bool isDebug()

Проверяет, включен ли режим отладки.

Значение результата

bool true, если режим отладки включён, иначе false

string getRootDir()

Возвращает корневую директорию приложения.

Значение результата

string Корневая директория приложения

ContainerInterface getContainer()

Возвращает текущий контейнер.

Значение результата

ContainerInterface Экземпляр ContainerInterface

loadClassCache(string $name = 'classes', string $extension = '.php')

Загружает кэш классов PHP.

Этот метод лишь регистрирует необходимость загрузки кэша классов. Сам кэш загрузится только при запуске ядра.

Эта оптимизация полезна, в основном, при использовании класса HttpCache, в котором кэш классов не загружается, если ответ находится в кэше.

Параметры

string $name Префикс имени кэша
string $extension Расширение файла результата

setClassCache(array $classes)

Параметры

array $classes

setAnnotatedClassCache(array $annotatedClasses)

Параметры

array $annotatedClasses

int getStartTime()

Возвращает время начала запроса (не доступно, если отладка отключена).

Значение результата

int Маркер времени начала запроса

string getCacheDir()

Возвращает директорию кэша.

Значение результата

string Директория кэша

string getLogDir()

Возвращает директорию логов.

Значение результата

string Директория логов

string getCharset()

Возвращает кодировку приложения.

Значение результата

string Кодировка

static string stripComments(string $source)

Удаляет комментарии из строки PHP-кода.

Мы не используем функцию PHP php_strip_whitespace(), так как хотим, чтобы содержимое было читабельным и отформатированным.

Параметры

string $source Строка PHP-кода

Значение результата

string Строка PHP-кода без комментариев

serialize()

unserialize($data)

Параметры

$data

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.2/Symfony/Component/HttpKernel/Kernel.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API