Класс 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необязательно [] - Дополнительная информация о записи в журнал.
Возвращаемое значение
строкаlevels()source public
levels( )
Получить уровни, к которым заинтересован этот логгер.
Возвращаемое значение
массивscopes()source public
scopes( )
Получить области, к которым заинтересован этот логгер.
Возвращаемое значение
массивМетоды, используемые из 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 - Значение для записи.
- boolean|строка
$mergeнеобязательно false Истинно для рекурсивного объединения, 'shallow' для простого объединения, ложно для перезаписи, по умолчанию ложно.
Исключения
Cake\Core\Exception\Exceptionесли попытка перезаписи существующей конфигурации
config()source public deprecated
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 - Значение для установки.
- boolean
$mergeнеобязательно 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Данные конфигурации по указанному ключу или null, если ключ не существует.
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–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/3.8/class-Cake.Log.Engine.SyslogLog.html