Класс ErrorHandlerMiddleware
Обработка ошибок middleware.
Перехватывает исключения и преобразует их в HTML или соответствующие страницы ошибок с помощью CakePHP ExceptionRenderer.
Краткое описание свойств
- $_config protected
arrayКонфигурация выполнения
- $_configInitialized protected
boolУказывает, была ли конфигурация свойства уже настроена с параметрами по умолчанию
- $_defaultConfig protected
arrayЗначения конфигурации по умолчанию.
- $errorHandler protected
Cake\Error\ErrorHandler|nullЭкземпляр обработчика ошибок.
Краткое описание методов
-
__construct() public
Конструктор
-
_configDelete() protected
Удаляет единственный ключ конфигурации.
-
_configRead() protected
Читает ключ конфигурации.
-
_configWrite() protected
Записывает ключ конфигурации.
-
configShallow() public
Объединяет предоставленную конфигурацию с существующей. В отличие от
config(), которая выполняет рекурсивное объединение для вложенных ключей, этот метод выполняет простое объединение. -
getConfig() public
Возвращает конфигурацию.
-
getConfigOrFail() public
Возвращает конфигурацию для данного ключа.
-
getErrorHandler() protected
Получить экземпляр обработчика ошибок
-
handleException() public
Обрабатывает исключение и генерирует ответ об ошибке
-
handleInternalError() protected
Обрабатывает внутренние ошибки.
-
handleRedirect() public
Преобразует исключение перенаправления в ответ.
-
process() public
Оборачивает оставшиеся средства обработки с обработкой ошибок.
-
setConfig() public
Устанавливает конфигурацию.
Подробное описание методов
__construct() public
__construct(Cake\Error\ErrorHandler|array $errorHandler = [])
Конструктор
Параметры
-
Cake\Error\ErrorHandler|array$errorHandler optional Экземпляр обработчика ошибок или массив конфигурации.
Исключения
InvalidArgumentException_configDelete() protected
_configDelete(string $key): void
Удаляет единственный ключ конфигурации.
Параметры
-
string$key Ключ для удаления.
Возвращаемое значение
voidИсключения
Cake\Core\Exception\CakeExceptionпри попытке перезаписи существующей конфигурации
_configRead() protected
_configRead(string|null $key): mixed
Читает ключ конфигурации.
Параметры
-
string|null$key Ключ для чтения.
Возвращаемое значение
mixed_configWrite() protected
_configWrite(string|array $key, mixed $value, bool|string $merge = false): void
Записывает ключ конфигурации.
Параметры
-
string|array$key Ключ для записи.
-
mixed$value Значение для записи.
-
bool|string$merge optional True для рекурсивного объединения, 'shallow' для простого объединения, false для перезаписи, по умолчанию false.
Возвращаемое значение
voidИсключения
Cake\Core\Exception\CakeExceptionпри попытке перезаписи существующей конфигурации
configShallow() public
configShallow(string|array $key, mixed|null $value = null): $this
Объединяет предоставленную конфигурацию с существующей. В отличие от config(), которая выполняет рекурсивное объединение для вложенных ключей, этот метод выполняет простое объединение.
Установка конкретного значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
-
string|array$key Ключ для установки или полный массив конфигураций.
-
mixed|null$value optional Значение для установки.
Возвращаемое значение
$thisgetConfig() public
getConfig(string|null $key = null, mixed $default = null): mixed
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определенного значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
-
string|null$key optional Ключ для получения или null для всей конфигурации.
-
mixed$default optional Возвращаемое значение, когда ключ не существует.
Возвращаемое значение
mixedgetConfigOrFail() public
getConfigOrFail(string $key): mixed
Возвращает конфигурацию для данного ключа.
Значение конфигурации для данного ключа должно существовать, оно никогда не может быть null.
Параметры
-
string$key Ключ для получения.
Возвращаемое значение
mixedИсключения
InvalidArgumentExceptiongetErrorHandler() protected
getErrorHandler(): Cake\Error\ErrorHandler
Получить экземпляр обработчика ошибок
Возвращаемое значение
Cake\Error\ErrorHandlerhandleException() public
handleException(Throwable $exception, Psr\Http\Message\ServerRequestInterface $request): Psr\Http\Message\ResponseInterface
Обрабатывает исключение и генерирует ответ об ошибке
Параметры
-
Throwable$exception Исключение для обработки.
-
Psr\Http\Message\ServerRequestInterface$request Запрос.
Возвращаемое значение
Psr\Http\Message\ResponseInterfacehandleInternalError() protected
handleInternalError(): Psr\Http\Message\ResponseInterface
Обрабатывает внутренние ошибки.
Возвращаемое значение
Psr\Http\Message\ResponseInterfacehandleRedirect() public
handleRedirect(Cake\Http\Exception\RedirectException $exception): Psr\Http\Message\ResponseInterface
Преобразует исключение перенаправления в ответ.
Параметры
-
Cake\Http\Exception\RedirectException$exception Исключение для обработки
Возвращаемое значение
Psr\Http\Message\ResponseInterfaceprocess() public
process(ServerRequestInterface $request, RequestHandlerInterface $handler): Psr\Http\Message\ResponseInterface
Оборачивает оставшиеся средства обработки с обработкой ошибок.
Обрабатывает входящий серверный запрос, чтобы создать ответ. Если не удается создать ответ, он может делегировать задачу обработчику запросов.
Параметры
-
ServerRequestInterface$request Запрос.
-
RequestHandlerInterface$handler Обработчик запросов.
Возвращаемое значение
Psr\Http\Message\ResponseInterfacesetConfig() public
setConfig(string|array $key, mixed|null $value = null, bool $merge = true): $this
Устанавливает конфигурацию.
Использование
Установка конкретного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
-
string|array$key Ключ для установки или полный массив конфигураций.
-
mixed|null$value optional Значение для установки.
-
bool$merge optional Выполнять рекурсивное объединение или перезапись существующей конфигурации, по умолчанию true.
Возвращаемое значение
$thisИсключения
Cake\Core\Exception\CakeExceptionпри попытке установить недопустимый ключ.
Подробное описание свойств
$_config protected
Конфигурация во время выполнения
Тип
array$_configInitialized protected
Указывает, была ли свойству config уже задана конфигурация по умолчанию
Тип
bool$_defaultConfig protected
Значения конфигурации по умолчанию.
Игнорируется, если конструктору передан экземпляр ErrorHandler.
-
logВключить логирование исключений. -
skipLogСписок исключений, которые следует пропустить при логировании. Исключения, которые расширяют одно из перечисленных исключений, также не будут регистрироваться. Пример:
'skipLog' => ['Cake\Error\NotFoundException', 'Cake\Error\UnauthorizedException']
-
traceДолжны ли журналы ошибок включать трассировки стека? -
exceptionRendererЭкземпляр или имя класса рендерера, который следует использовать, или вызываемый фабричный метод, возвращающий экземпляр \Cake\Error\ExceptionRendererInterface. По умолчанию \Cake\Error\ExceptionRenderer
Тип
array$errorHandler protected
Экземпляр обработчика ошибок.
Тип
Cake\Error\ErrorHandler|null
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.2/class-Cake.Error.Middleware.ErrorHandlerMiddleware.html