Ядро
класс Ядро реализует 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) | ||
| init() устаревший | ||
| __clone() | ||
| boot() Запускает текущее ядро. | ||
| terminate(Запрос $request, Ответ $response) Завершает цикл запроса/ответа. | ||
| shutdown() Выключает ядро. | ||
| Ответ | handle(Запрос $request, int $type = HttpKernelInterface::MASTER_REQUEST, bool $catch = true) Обрабатывает запрос, чтобы преобразовать его в ответ. | |
| Интерфейс пакета[] | getBundles() Получает зарегистрированные экземпляры пакетов. | |
| bool | isClassInActiveBundle(string $class) устаревший Проверяет, принадлежит ли данное имя класса активному пакету. | |
| Интерфейс пакета|Интерфейс пакета[] | getBundle(string $name, bool $first = true) Возвращает пакет и, необязательно, его потомков по его имени. | |
| string|массив | locateResource(string $name, string $dir = null, bool $first = true) Возвращает путь к файлу для заданного ресурса. | |
| string | getName() Получает имя ядра. | |
| string | getEnvironment() Получает среду. | |
| bool | isDebug() Проверяет, включен ли режим отладки. | |
| string | getRootDir() Получает корневой каталог приложения. | |
| Интерфейс контейнера | getContainer() Получает текущий контейнер. | |
| loadClassCache(string $name = 'classes', string $extension = '.php') Загружает кеш классов PHP. | ||
| setClassCache(array $classes) Используется внутри. | ||
| 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 | Включить отладку или нет |
init() устарело
устарело
__clone()
boot()
Запускает текущее ядро.
terminate(Запрос $request, Ответ $response)
Завершает цикл запроса/ответа.
Должен вызываться после отправки ответа и перед завершением работы ядра.
Параметры
| Запрос | $request | |
| Ответ | $response |
shutdown()
Завершает работу ядра.
Этот метод полезен в основном при функциональном тестировании.
Ответ handle(Запрос $request, int $type = HttpKernelInterface::MASTER_REQUEST, bool $catch = true)
Обрабатывает запрос для его преобразования в ответ.
Если $catch true, реализация должна перехватывать все исключения и по возможности преобразовывать их в экземпляр ответа.
Параметры
| Запрос | $request | Экземпляр запроса |
| int | $type | Тип запроса (HttpKernelInterface::MASTER_REQUEST или HttpKernelInterface::SUB_REQUEST) |
| bool | $catch | Перехватывать исключения или нет |
Значение результата
| Ответ | Экземпляр ответа |
Исключения
| Исключение | При возникновении исключения во время обработки |
BundleInterface[] getBundles()
Получает зарегистрированные экземпляры пакетов.
Значение результата
| BundleInterface[] | Массив зарегистрированных экземпляров пакетов |
bool isClassInActiveBundle(string $class) устарело
устарело
Проверяет, принадлежит ли заданное имя класса активному пакету.
Параметры
| string | $class | Имя класса |
Значение результата
| bool | true, если класс принадлежит активному пакету, false в противном случае |
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 |
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/2.8/Symfony/Component/HttpKernel/Kernel.html