Класс FileLog
Поток хранения файлов для регистрации. Записывает логи в разные файлы в зависимости от уровня лога.
- Psr\Log\AbstractLogger
-
Cake\Log\Engine\BaseLog использует Cake\Core\InstanceConfigTrait
-
Cake\Log\Engine\FileLog
Краткое описание свойств
-
$_defaultConfigprotectedЗначение конфигурации по умолчанию для данного классаarray -
$_fileprotectedИмя файла для сохранения логов.string|null -
$_pathprotectedПуть для сохранения файлов логов.string|null -
$_sizeprotectedМаксимальный размер файла, используется для ротации файлов логов.integer|null
Унаследованные свойства
Краткое описание методов
- __construct() publicУстанавливает защищенные свойства на основе предоставленной конфигурации
- _getFilename() protectedПолучение имени файла
- _rotateFile() protected
Производит ротацию файла логов, если достигается размер, указанный в конфигурации. Также, если
rotateколичество достигает предела, удаляется самый старый файл. - log() publicРеализует запись в файлы логов.
Подробное описание методов
__construct()source public
__construct( array $config = [] )
Устанавливает защищенные свойства на основе предоставленной конфигурации
Параметры
- массив
$configнеобязательно [] - Массив конфигурации
Переопределяет
Cake\Log\Engine\BaseLog::__construct() _getFilename()source protected
_getFilename( string $level )
Получение имени файла
Параметры
- строка
$level - Уровень лога.
Возвращает
строкаИмя файла
_rotateFile()source protected
_rotateFile( string $filename )
Производит ротацию файла логов, если достигается размер, указанный в конфигурации. Также, если rotate количество достигает предела, удаляется самый старый файл.
Параметры
- строка
$filename - Имя файла лога
Возвращает
логическое значение|nullИстина, если ротация выполнена успешно, или ложь в случае ошибки. Нуль, если файл не нуждается в ротации.
log()source public
log( string $level , string $message , array $context = [] )
Реализует запись в файлы логов.
Параметры
- строка
$level Уровень серьезности сообщения, которое записывается. См. Cake\Log\Log::$_levels для списка возможных уровней.
- строка
$message - Сообщение, которое вы хотите записать в лог.
- массив
$contextнеобязательно [] - Дополнительная информация о записанном сообщении
Возвращает
логическое значениеРезультат записи.
Методы, унаследованные от Cake\Log\Engine\BaseLog
_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 - Значение для записи.
- логическое значение|строка
$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 - Значение для установки.
- логическое значение
$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']);
Параметры
- строка|массив
$key - Ключ для установки, или весь массив конфигураций.
- смешанный|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
Конфигурация по умолчанию для этого класса
-
levelsстрока или массив, уровни, которые интересуют движок -
scopesстрока или массив, области, которые интересуют движок -
fileИмя файла логов -
pathПуть для сохранения логов. -
sizeИспользуется для реализации базовой ротации файлов логов. Если размер файла логов достигнет заданного размера, существующий файл переименовывается с добавлением отметки времени к имени файла, и создается новый файл логов. Может быть целочисленным значением в байтах или удобочитаемым строковым значением, например, '10MB', '100KB' и т. д. -
rotateФайлы логов ротируются заданное количество раз перед удалением. Если значение равно 0, старые версии удаляются, а не ротируются. -
maskПри создании файлов логов применяется маска. Если поле пусто, изменение прав доступа не выполняется.
[
'path' => null,
'file' => null,
'types' => null,
'levels' => [],
'scopes' => [],
'rotate' => 10,
'size' => 10485760, // 10MB
'mask' => null,
] $_sizesource
protected integer|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/3.7/class-Cake.Log.Engine.FileLog.html