Класс ArrayLog
Журнализатор массивов.
Собирает сообщения журнала в памяти. Предназначен в основном для использования в тестировании, где использование моков было бы затруднено. Но также может использоваться в сценариях, где необходимо захватывать журналы в коде приложения.
Краткое описание свойств
- $_config protected
array<string, mixed>Конфигурация во время выполнения
- $_configInitialized protected
boolБыла ли конфигурация уже настроена по умолчанию
- $_defaultConfig protected
array<string, mixed>Конфигурация по умолчанию для данного класса
- $content protected
array<string>Захваченные сообщения
- $formatter protected
Cake\Log\Formatter\AbstractFormatter
Краткое описание методов
-
__construct() public
Метод __construct
-
_configDelete() protected
Удаляет один ключ конфигурации.
-
_configRead() protected
Читает ключ конфигурации.
-
_configWrite() protected
Записывает ключ конфигурации.
-
_format() protected deprecated
Форматирует сообщение для записи в журнал.
-
alert() public
Требуются немедленные действия.
-
clear() public
Сброс внутренней памяти.
-
configShallow() public
Объединяет предоставленную конфигурацию с существующей. В отличие от
config(), которая выполняет рекурсивное объединение для вложенных ключей, этот метод выполняет простое объединение. -
critical() public
Критические условия.
-
debug() public
Подробная отладочная информация.
-
emergency() public
Система непригодна для использования.
-
error() public
Ошибки выполнения, которые не требуют немедленных действий, но обычно должны регистрироваться и отслеживаться.
-
getConfig() public
Возвращает конфигурацию.
-
getConfigOrFail() public
Возвращает конфигурацию для данного ключа.
-
info() public
Интересные события.
-
interpolate() protected
Заменяет плейсхолдеры в строке сообщения значениями контекста.
-
levels() public
Получение уровней, которые интересуют данный журнализатор.
-
log() public
Реализация записи в внутреннее хранилище.
-
notice() public
Обычные, но значимые события.
-
read() public
Чтение из внутреннего хранилища.
-
scopes() public
Получение областей, которые интересуют данный журнализатор.
-
setConfig() public
Устанавливает конфигурацию.
-
warning() public
Исключительные ситуации, которые не являются ошибками.
Краткое описание методов
__construct() public
__construct(array<string, mixed> $config = [])
Метод __construct
Параметры
-
array<string, mixed>$config optional Массив конфигурации
_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(array<string, mixed>|string $key, mixed $value, string|bool $merge = false): void
Записывает ключ конфигурации.
Параметры
-
array<string, mixed>|string$key Ключ для записи.
-
mixed$value Значение для записи.
-
string|bool$merge optional True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Возвращает
voidВызывает исключение
Cake\Core\Exception\CakeExceptionпри попытке перезаписать существующую конфигурацию
_format() protected
_format(string $message, array $context = []): string
Форматирует сообщение для логирования.
Контекст может опционально использоваться механизмами логирования для интерполяции переменных или добавления дополнительной информации к логгируемому сообщению.
Параметры
-
string$message Сообщение для форматирования.
-
array$context optional Дополнительная информация для логирования сообщения.
Возвращает
stringalert() public
alert(string $message, mixed[] $context = array()): void
Требуются немедленные действия.
Пример: Веб-сайт полностью недоступен, база данных недоступна и т.д. Это должно активировать SMS-оповещения и разбудить вас.
Параметры
-
string$message -
mixed[]$context optional
Возвращает
voidclear() public
clear(): void
Сброс внутреннего хранилища.
Возвращает
voidconfigShallow() public
configShallow(array<string, mixed>|string $key, mixed|null $value = null): $this
Слияние предоставленной конфигурации с существующей конфигурацией. В отличие от config() который выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка конкретного значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
-
array<string, mixed>|string$key Ключ для установки или полный массив конфигураций.
-
mixed|null$value optional Значение для установки.
Возвращает
$thiscritical() public
critical(string $message, mixed[] $context = array()): void
Критические условия.
Пример: Компонент приложения недоступен, неожиданное исключение.
Параметры
-
string$message -
mixed[]$context optional
Возвращает
voiddebug() public
debug(string $message, mixed[] $context = array()): void
Подробная информация отладки.
Параметры
-
string$message -
mixed[]$context optional
Возвращает
voidemergency() public
emergency(string $message, mixed[] $context = array()): void
Система непригодна для использования.
Параметры
-
string$message -
mixed[]$context optional
Возвращает
voiderror() public
error(string $message, mixed[] $context = array()): void
Ошибки времени выполнения, которые не требуют немедленных действий, но обычно должны регистрироваться и отслеживаться.
Параметры
-
string$message -
mixed[]$context optional
Возвращает
voidgetConfig() 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Вызывает исключение
InvalidArgumentExceptioninfo() public
info(string $message, mixed[] $context = array()): void
Интересные события.
Пример: Пользователь вошёл в систему, журналы SQL.
Параметры
-
string$message -
mixed[]$context optional
Возвращает
voidinterpolate() protected
interpolate(string $message, array $context = []): string
Заменяет заполнители в строке сообщения значениями контекста.
Параметры
-
string$message Форматированная строка
-
array$context optional Контекст для значений заполнителей.
Возвращает
stringlevels() public
levels(): array<string>
Получить уровни, которые интересуют этот регистратор.
Возвращает
array<string>log() public
log(mixed $level, string $message, mixed[] $context = []): void
Реализует запись во внутреннее хранилище.
Параметры
-
mixed$level Уровень серьезности лога, который вы создаете.
-
string$message Сообщение, которое вы хотите занести в лог.
-
mixed[]$context optional Дополнительная информация о занесенном в лог сообщении
Возвращает
voidСм. также
notice() public
notice(string $message, mixed[] $context = array()): void
Обычные, но значимые события.
Параметры
-
string$message -
mixed[]$context optional
Возвращает
voidread() public
read(): array<string>
Чтение внутреннего хранилища
Возвращает
array<string>scopes() public
scopes(): array<string>|false
Получение областей, в которых заинтересован этот логгер.
Возвращает
array<string>|falsesetConfig() public
setConfig(array<string, mixed>|string $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']);
Параметры
-
array<string, mixed>|string$key Ключ для установки или полный массив конфигураций.
-
mixed|null$value необязательно Значение для установки.
-
bool$merge необязательно Выполнять рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию значение true.
Возвращает
$thisВыбрасывает
Cake\Core\Exception\CakeExceptionПри попытке установить недопустимый ключ.
warning() public
warning(string $message, mixed[] $context = array()): void
Исключительные ситуации, которые не являются ошибками.
Пример: Использование устаревших API, плохое использование API, нежелательные действия, которые не обязательно являются ошибками.
Параметры
-
string$message -
mixed[]$context необязательно
Возвращает
voidПодробное описание свойств
$_config protected
Конфигурация во время выполнения
Тип
array<string, mixed>$_configInitialized protected
Указывает, была ли конфигурация уже настроена с помощью значений по умолчанию
Тип
bool$_defaultConfig protected
Конфигурация по умолчанию для этого класса
Тип
array<string, mixed>$content protected
Захваченные сообщения
Тип
array<string>$formatter protected
Тип
Cake\Log\Formatter\AbstractFormatter
© 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.4/class-Cake.Log.Engine.ArrayLog.html