Класс SyslogLog
Поток syslog для ведения журналов. Записывает журналы в системный логгер
- Psr\Log\AbstractLogger
-
Cake\Log\Engine\BaseLog использует Cake\Core\InstanceConfigTrait
-
Cake\Log\Engine\SyslogLog
Краткое описание свойств
-
$_defaultConfigprotectedЗначение конфигурации по умолчанию для данного классаarray -
$_levelMapprotectedИспользуется для сопоставления строковых имён с их константами LOG_*int[] -
$_openprotectedОткрыто ли соединение с логгеромboolean
Наследованные свойства
Краткое описание методов
- __destruct() publicЗакрывает соединение с логгером
- _open() protected
Извлекает вызов openlog() для проведения юнит-тестирования. Эта функция инициализирует соединение с системным логгером
- _write() protected
Извлекает вызов syslog() для проведения юнит-тестирования. Эта функция выполняет фактическое запись в системный логгер
- log() publicЗаписывает сообщение в syslog
Подробное описание методов
_open()source protected
_open( string $ident , integer $options , integer $facility )
Извлекает вызов openlog() для проведения юнит-тестирования. Эта функция инициализирует соединение с системным логгером
Параметры
- строка
$ident - префикс, добавляемый ко всем записываемым сообщениям
- целое число
$options - флаги опций, используемые для записываемых сообщений
- целое число
$facility - поток или механизм для записи в лог
_write()source protected
_write( integer $priority , string $message )
Извлекает вызов syslog() для проведения юнит-тестирования. Эта функция выполняет фактическое запись в системный логгер
Параметры
- целое число
$priority - Приоритет сообщения.
- строка
$message - Сообщение для записи.
Возвращает
booleanlog()source public
log( string $level , string $message , array $context [] )
Записывает сообщение в syslog
Преобразует $level в значение LOG_, разбивает многострочные сообщения на несколько сообщений в логе, пропускает все сообщения через формат, определенный в конфигурации
Параметры
- строка
$level - Уровень серьезности лога.
- строка
$message - Сообщение, которое нужно записать в лог.
- массив
$contextнеобязательно [] - Дополнительная информация о записываемом сообщении
Возвращает
booleanуспех записи.
Методы, унаследованные от Cake\Log\Engine\BaseLog
__construct()source public
__construct( array $config [] )
Метод __construct
Параметры
- массив
$configнеобязательно [] - Массив конфигурации
_format()source protected
_format( mixed $data , array $context [] )
Преобразует предоставленные данные в строку для записи в журнал. Контекст может быть использован лог-движками для интерполяции переменных или добавления дополнительной информации к записываемому сообщению.
Параметры
- смешанное
$data - Данные, которые нужно преобразовать в строку и записать в журнал.
- массив
$contextнеобязательно [] - Дополнительная информация для записи сообщения.
Возвращает
строкаМетоды, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаляет единственный ключ конфигурации.
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionесли пытаетесь перезаписать существующую конфигурацию
_configRead()source protected
_configRead( string|null $key )
Читает ключ конфигурации.
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
смешанное_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Записывает ключ конфигурации.
Параметры
- строка|массив
$key - Ключ для записи.
- смешанное
$value - Значение для записи.
- булево|строка
$mergeнеобязательно false True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключения
Cake\Core\Exception\Exceptionесли пытаетесь перезаписать существующую конфигурацию
config()source public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Получает/устанавливает конфигурацию.
Использование
Чтение всей конфигурации:
$this->config();
Чтение определенного значения:
$this->config('key'); Чтение вложенного значения:
$this->config('some.nested.key'); Установка определенного значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Устарело
3.4.0 использовать setConfig()/getConfig() вместо этого.Параметры
- строка|массив|null
$keyнеобязательно null - Ключ для получения/установки или полный массив конфигураций.
- смешанное|null
$valueнеобязательно null - Значение для установки.
- булево
$mergeнеобязательно true - Рекурсивно сливать или перезаписывать существующую конфигурацию, по умолчанию true.
Возвращает
смешанноеЗначение конфигурации, которое читается, или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недействительный ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Объединить предоставленную конфигурацию с существующей. В отличие от config(), которая выполняет рекурсивное объединение для вложенных ключей, этот метод выполняет простое объединение.
Установка определённого значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или массив настроек.
- mixed|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key null , mixed $default null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определённого значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- string|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultнеобязательно null - Значение по умолчанию, если ключ не найден.
Возвращает
mixedЗначение конфигурации.
setConfig()source public
setConfig( string|array $key , mixed|null $value null , boolean $merge true )
Устанавливает конфигурацию.
Использование
Установка определённого значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или массив настроек.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Выполнять рекурсивное объединение или перезаписывать существующую конфигурацию, по умолчанию true.
Возвращает
$this
Исключение
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробное описание свойств
$_defaultConfigsource
protected array
Конфигурация по умолчанию для этого класса
По умолчанию сообщения форматируются как: уровень: сообщение
Для переопределения формата логов (например, для добавления собственной информации) определите ключ формата при настройке этого логгера
Если вы хотите добавить префикс ко всем сообщениям, например, для идентификации приложения или веб-сервера, используйте опцию префикса. Помните, что префикс общий для всех потоков, использующих syslog, так как он зависит от работающего процесса. Для локального префикса, используемого только одним потоком, вы можете использовать ключ формата.
Пример:
Log::config('error', ]
'engine' => 'Syslog',
'levels' => ['emergency', 'alert', 'critical', 'error'],
'format' => "%s: My-App - %s",
'prefix' => 'Web Server 01'
]); [
'levels' => [],
'scopes' => [],
'format' => '%s: %s',
'flag' => LOG_ODELAY,
'prefix' => '',
'facility' => LOG_USER
] $_levelMapsource
protected int[]
Используется для сопоставления строковых названий с константами LOG_*
[
'emergency' => LOG_EMERG,
'alert' => LOG_ALERT,
'critical' => LOG_CRIT,
'error' => LOG_ERR,
'warning' => LOG_WARNING,
'notice' => LOG_NOTICE,
'info' => LOG_INFO,
'debug' => LOG_DEBUG
]
© 2005–2017 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/3.4/class-Cake.Log.Engine.SyslogLog.html