Ядро
класс Ядро реализует Интерфейс ядра, Интерфейс перезапуска, Интерфейс завершения
Ядро — это сердце системы 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() Запускает текущее ядро. | ||
| reboot(string|null $warmupDir) Перезапускает ядро. | ||
| terminate(Запрос $request, Response $response) Завершает цикл запроса/ответа. | ||
| shutdown() Выключает ядро. | ||
| Response | handle(Запрос $request, int $type = HttpKernelInterface::MASTER_REQUEST, bool $catch = true) Обрабатывает запрос для преобразования в ответ. | |
| Интерфейс пакета[] | getBundles() Получает зарегистрированные экземпляры пакетов. | |
| Интерфейс пакета | getBundle(string $name) Возвращает пакет. | |
| string|array | locateResource(string $name, string $dir = null, bool $first = true) Возвращает путь к файлу для данного ресурса. | |
| string | getName() Получает имя ядра. | |
| string | getEnvironment() Получает среду. | |
| bool | isDebug() Проверяет, включен ли режим отладки. | |
| string | getRootDir() Получает корневой каталог приложения (путь к классу Kernel проекта). | |
| string | getProjectDir() Получает корневой каталог приложения (путь к файлу composer проекта). | |
| Интерфейс контейнера | getContainer() Получает текущий контейнер. | |
| 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()
Запускает текущее ядро.
reboot(string|null $warmupDir)
Перезапускает ядро.
Метод getCacheDir() перезапускаемого ядра не должен вызываться во время построения контейнера. Используйте параметр %kernel.cache_dir% вместо этого.
Параметры
| string|null | $warmupDir | передайте null, чтобы перезапустить в обычном каталоге кэша |
terminate(Request $request, Response $response)
Завершает цикл запроса/ответа.
Должен вызываться после отправки ответа и перед завершением работы ядра.
Параметры
| Request | $request | |
| 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 getBundle(string $name)
Возвращает пакет.
Параметры
| string | $name | Имя пакета |
Возвращаемое значение
| BundleInterface | Экземпляр BundleInterface |
Исключения
| 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 | Корневой каталог ядра |
string getProjectDir()
Получает корневой каталог приложения (путь к файлу composer проекта).
Возвращаемое значение
| string | Корневой каталог проекта |
ContainerInterface getContainer()
Получает текущий контейнер.
Возвращаемое значение
| ContainerInterface | Экземпляр ContainerInterface |
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/4.0/Symfony/Component/HttpKernel/Kernel.html