Класс Log

Log::setConfig('my_log', ['className' => 'FileLog']);

Log::setConfig('default', [
    'className' => 'File',
    'path' => LOGS,
    'levels' => ['error', 'critical', 'alert', 'emergency']
]);

Log::setConfig('payments', [
    'className' => 'File',
    'scopes' => ['payment', 'order']
]);

Log::error('Something horrible happened');
Log::write(LOG_ERR, 'Something horrible happened');

_init()source protected static

_init( )

Инициализация реестра и конфигураций

_loadConfig()source protected static

_loadConfig( )

Загрузка определенной конфигурации и создание всех определенных адаптеров логгирования.

alert()source public static

alert( string $message , string|array $context = [] )

Метод для удобства записи сообщений об уведомлениях

Параметры

строка $message

сообщение лога

строка|массив $context необязательно []

Дополнительные данные, используемые для записи сообщения. Специальный ключ scope может быть передан для дальнейшей фильтрации движков логов. Если передана строка или массивная переменная с индексами, она будет обработана как ключ scope. Дополнительную информацию о областях логгирования см. в Cake\Log\Log::setConfig().

Возвращаемое значение

boolean
Успех

critical()source public static

critical( string $message , string|array $context = [] )

Метод для удобства записи критических сообщений

Параметры

строка $message

сообщение лога

строка|массив $context необязательно []

Дополнительные данные, используемые для записи сообщения. Специальный ключ scope может быть передан для дальнейшей фильтрации движков логов. Если передана строка или массивная переменная с индексами, она будет обработана как ключ scope. Дополнительную информацию о областях логгирования см. в Cake\Log\Log::setConfig().

Возвращаемое значение

boolean
Успех

debug()source public static

debug( string $message , string|array $context = [] )

Метод для удобства записи сообщений отладки

Параметры

строка $message

сообщение лога

строка|массив $context необязательно []

Дополнительные данные, используемые для записи сообщения. Специальный ключ scope может быть передан для дальнейшей фильтрации движков логов. Если передана строка или массивная переменная с индексами, она будет обработана как ключ scope. Дополнительную информацию о областях логгирования см. в Cake\Log\Log::setConfig().

Возвращаемое значение

boolean
Успех

emergency()source public static

emergency( string $message , string|array $context = [] )

Метод для записи сообщений об аварийных ситуациях.

Параметры

строка $message

сообщение журнала

строка|массив $context необязательно []

Дополнительные данные для записи сообщения. Специальный ключ scope может быть передан для дальнейшей фильтрации используемых лог-движков. Если передается строка или массив с числовыми индексами, он будет интерпретирован как ключ scope. См. Cake\Log\Log::setConfig() для получения дополнительной информации о разделах журнала.

Возвращает

boolean
Успех

engine()source public static

engine( string $name )

Получение лог-движка.

Параметры

строка $name

Имя ключа настроенного адаптера для получения.

Возвращает

Cake\Log\Engine\BaseLog|false
Экземпляр BaseLog или false, если не найден

error()source public static

error( string $message , string|array $context = [] )

Метод для записи сообщений об ошибках.

Параметры

строка $message

сообщение журнала

строка|массив $context необязательно []

Дополнительные данные для записи сообщения. Специальный ключ scope может быть передан для дальнейшей фильтрации используемых лог-движков. Если передается строка или массив с числовыми индексами, он будет интерпретирован как ключ scope. См. Cake\Log\Log::setConfig() для получения дополнительной информации о разделах журнала.

Возвращает

boolean
Успех

info()source public static

info( string $message , string|array $context = [] )

Метод для записи информационных сообщений.

Параметры

строка $message

сообщение журнала

строка|массив $context необязательно []

Дополнительные данные для записи сообщения. Специальный ключ scope может быть передан для дальнейшей фильтрации используемых лог-движков. Если передается строка или массив с числовыми индексами, он будет интерпретирован как ключ scope. См. Cake\Log\Log::setConfig() для получения дополнительной информации о разделах журнала.

Возвращает

boolean
Успех

levels()source public static

levels( )

Получение уровней журнала.

Вызовите этот метод для получения текущей конфигурации уровней.

Возвращает

массив
активные уровни журнала

notice()source public static

notice( string $message , string|array $context = [] )

Метод для записи сообщений о замечаниях.

Параметры

строка $message

сообщение журнала

строка|массив $context необязательно []

Дополнительные данные для записи сообщения. Специальный ключ scope может быть передан для дальнейшей фильтрации используемых лог-движков. Если передается строка или массив с числовыми индексами, он будет интерпретирован как ключ scope. См. Cake\Log\Log::setConfig() для получения дополнительной информации о разделах журнала.

Возвращает

boolean
Успех

reset()source public static

reset( )

Сброс всех подключенных логгеров. Это полезно при изменении конфигурации журналов или во время тестирования, когда требуется сбросить внутреннее состояние класса Log.

Сбрасывает настроенные адаптеры журналов, а также любые пользовательские уровни журналов. Это также очистит данные конфигурации.

setConfig()source public static

setConfig( string|array $key , array|null $config = null )

Этот метод может использоваться для определения адаптеров журналов для приложения или чтения существующей конфигурации.

Чтобы изменить конфигурацию адаптера во время выполнения, сначала удалите адаптер, а затем переконфигурируйте его.

Логгеры не будут созданы до первого записи сообщения журнала.

Использование

Настройка движка кэша.

Log::setConfig('default', $settings);

Вставка построенного адаптера:

Log::setConfig('default', $instance);

Использование функции-фабрики для получения адаптера:

Log::setConfig('default', function () { return new FileLog(); });

Настройка нескольких адаптеров одновременно:

Log::setConfig($arrayOfConfig);

Параметры

строка|массив $key

Имя конфигурации логгера или массив с несколькими конфигурациями.

массив|null $config необязательно null

Массив данных конфигурации адаптера по имени.

Выбрасывает

BadMethodCallException
При попытке изменить существующую конфигурацию.

warning()source public static

warning( string $message , string|array $context = [] )

Метод для записи предупреждающих сообщений.

Параметры

строка $message

сообщение журнала

строка|массив $context необязательно []

Дополнительные данные для записи сообщения. Специальный ключ scope может быть передан для дальнейшей фильтрации используемых лог-движков. Если передается строка или массив с числовыми индексами, он будет интерпретирован как ключ scope. См. Cake\Log\Log::setConfig() для получения дополнительной информации о разделах журнала.

Возвращает

boolean
Успех

write()source public static

write( integer|string $level , mixed $message , string|array $context = [] )

Запись указанного сообщения и типа во все настроенные адаптеры журналов. Настроенные адаптеры получают как переменную $level, так и переменную $message. $level — одна из следующих строк/значений.

Уровни:

• LOG_EMERG => 'emergency',
• LOG_ALERT => 'alert',
• LOG_CRIT => 'critical',
• LOG_ERR => 'error',
• LOG_WARNING => 'warning',
• LOG_NOTICE => 'notice',
• LOG_INFO => 'info',
• LOG_DEBUG => 'debug',

Базовое использование

Запись сообщения 'warning' в журналы:

Log::write('warning', 'Stuff is broken here');

Использование разделов

При записи сообщения журнала вы можете определить один или несколько разделов для сообщения. Это позволяет обрабатывать сообщения по-разному в зависимости от раздела/функции приложения.

Log::write('warning', 'Payment failed', ['scope' => 'payment']);

При настройке логгеров вы можете настроить разделы, которые будет обрабатывать конкретный логгер. При использовании разделов вы должны убедиться, что уровень сообщения и раздел сообщения пересекаются с определенными уровнями и разделами для логгера.

Необработанные сообщения журнала

Если ни один из настроенных логгеров не может обработать сообщение журнала (из-за ограничений уровня или раздела), то записанное сообщение будет проигнорировано и молча удалено. Вы можете проверить, произошло ли это, проверив возвращаемое значение write(). Если false, сообщение не было обработано.

Параметры

целое число|строка $level

Уровень серьезности записываемого сообщения. Значение должно быть целым числом или строкой, соответствующей известному уровню.

смешанный $message

Содержимое сообщения для записи в журнал

строка|массив $context необязательно []

Дополнительные данные для записи сообщения. Специальный ключ scope может быть передан для дальнейшей фильтрации используемых лог-движков. Если передается строка или массив с числовыми индексами, он будет интерпретирован как ключ scope. См. Cake\Log\Log::setConfig() для получения дополнительной информации о разделах журнала.

Возвращает

boolean
Успех

Выбрасывает

InvalidArgumentException
Если передан неверный уровень.

config()source public static deprecated

config( string|array $key , array|null $config = null )

Этот метод можно использовать для определения адаптеров конфигурации для приложения или чтения существующей конфигурации.

Чтобы изменить конфигурацию адаптера во время выполнения, сначала удалите адаптер, а затем переконфигурируйте его.

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

Использование

Предполагая, что имя класса Cache , поддерживаются следующие сценарии:

Чтение данных конфигурации обратно:

Cache::config('default');

Настройка движка кеша.

Cache::config('default', $settings);

Вставка созданного адаптера:

Cache::config('default', $instance);

Настройка нескольких адаптеров одновременно:

Cache::config($arrayOfConfig);

Устарело

3.4.0 Используйте setConfig()/getConfig() вместо этого.

Параметры

string|array $key

Имя конфигурации или массив нескольких конфигураций.

array|null $config optional null

Массив пар имя => данные конфигурации для адаптера.

Возвращает

array|null
Null при добавлении конфигурации или массив данных конфигурации при чтении.

Выбрасывает

BadMethodCallException
При попытке изменить существующую конфигурацию.

configured()source public static

configured( )

Возвращает массив, содержащий именованные конфигурации.

Возвращает

string[]
Массив конфигураций.

drop()source public static

drop( string $config )

Удаляет созданный адаптер.

Если вы хотите изменить существующую конфигурацию, вы должны удалить ее, изменить конфигурацию, а затем повторно добавить ее.

Если реализующие объекты поддерживают объект $_registry , именованная конфигурация также будет загружена из реестра.

Параметры

string $config

Существующая конфигурация, которую вы хотите удалить.

Возвращает

boolean
Успех удаления, возвращает false, когда конфигурация не существует.

dsnClassMap()source public static deprecated

dsnClassMap( array $map = null )

Возвращает или обновляет карту классов DSN для этого класса.

Устарело

3.4.0 Используйте setDsnClassMap()/getDsnClassMap() вместо этого.

Параметры

array $map optional null

Добавления/изменения в карту классов для применения.

Возвращает

array

getConfig()source public static

getConfig( string $key )

Читает существующую конфигурацию.

Параметры

string $key

Имя конфигурации.

Возвращает

mixed
Данные конфигурации по указанному ключу или null, если ключ не существует.

getDsnClassMap()source public static

getDsnClassMap( )

Возвращает карту классов DSN для этого класса.

Возвращает

array

parseDsn()source public static

parseDsn( string $dsn )

Парсит DSN в корректную конфигурацию соединения.

Этот метод позволяет задать DSN с помощью формата, аналогичного тому, который используется в PEAR::DB. Вот пример его использования:

$dsn = 'mysql://user:pass@localhost/database?';
$config = ConnectionManager::parseDsn($dsn);

$dsn = 'Cake\Log\Engine\FileLog://?types=notice,info,debug&file=debug&path=LOGS';
$config = Log::parseDsn($dsn);

$dsn = 'smtp://user:secret@localhost:25?timeout=30&client=null&tls=null';
$config = Email::parseDsn($dsn);

$dsn = 'file:///?className=\My\Cache\Engine\FileEngine';
$config = Cache::parseDsn($dsn);

$dsn = 'File://?prefix=myapp_cake_core_&serialize=true&duration=+2 minutes&path=/tmp/persistent/';
$config = Cache::parseDsn($dsn);

Для всех классов значение scheme устанавливается как значение и className, если не указано иное.

Обратите внимание, что аргументы строки запроса также анализируются и устанавливаются как значения в возвращаемой конфигурации.

Параметры

string $dsn

Строка DSN для преобразования в массив конфигурации.

Возвращает

array
Массив конфигурации, который будет сохранён после анализа DSN

Выбрасывает

InvalidArgumentException
Если не передан строковый параметр или передан недопустимый строковый параметр

setDsnClassMap()source public static

setDsnClassMap( array $map )

Обновляет карту классов DSN для этого класса.

Параметры

array $map

Добавления/изменения в карту классов для применения.

false

[
    'console' => 'Cake\Log\Engine\ConsoleLog',
    'file' => 'Cake\Log\Engine\FileLog',
    'syslog' => 'Cake\Log\Engine\SyslogLog',
]

[
    'emergency' => LOG_EMERG,
    'alert' => LOG_ALERT,
    'critical' => LOG_CRIT,
    'error' => LOG_ERR,
    'warning' => LOG_WARNING,
    'notice' => LOG_NOTICE,
    'info' => LOG_INFO,
    'debug' => LOG_DEBUG,
]

[
    'emergency',
    'alert',
    'critical',
    'error',
    'warning',
    'notice',
    'info',
    'debug'
]