Класс 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 - Имя файла журнала
Возвращает
boolean|nullTrue, если вращение выполнено успешно, или false в случае ошибки. Null, если файл не нуждается во вращении.
log()source public
log( string $level , string $message , array $context = [] )
Реализует запись в файлы журнала.
Параметры
- строка
$level Уровень серьёзности сообщения, записываемого. См. Cake\Log\Log::$_levels для списка возможных уровней.
- строка
$message - Сообщения, которые вы хотите записать в журнал.
- массив
$contextнеобязательный [] - Дополнительная информация о сообщении, записываемом в журнал
Возвращает
booleanУспех записи.
Наследованные методы от 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 - Значение для записи.
- boolean|строка
$mergeнеобязательный false True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключения
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 - Рекурсивно сливать или перезаписывать существующую конфигурацию, по умолчанию 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Данные конфигурации по указанному ключу или 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
Конфигурация по умолчанию для этого класса
-
levelsСтрока или массив, уровни, которые интересуют движок -
scopesСтрока или массив, области, которые интересуют движок -
fileИмя файла журнала -
pathПуть для сохранения журналов. -
sizeИспользуется для реализации базовой ротации файлов журнала. Если размер файла журнала достигает заданного размера, существующий файл переименовывается путём добавления отметки времени к имени файла, и создаётся новый файл журнала. Может быть значением целого числа в байтах или удобочитаемой строкой, например, '10MB', '100KB' и т. д. -
rotateФайлы журнала поворачиваются указанное количество раз перед удалением. Если значение равно 0, старые версии удаляются, а не поворачиваются. -
maskМаска применяется при создании файлов журнала. Если поле пусто, chmod не выполняется.
[
'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.8/class-Cake.Log.Engine.FileLog.html