Класс 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|nullИстина, если ротация выполнена успешно, или ложь в случае ошибки. 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необязательно [] - Дополнительная информация для сообщения.
Возвращает
строкаМетоды, используемые из 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 Истина для рекурсивного объединения, «поверхностное» для простого объединения, ложь для перезаписи, по умолчанию ложь.
Выбрасывает
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 - Значение для установки.
- 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']);
Параметры
- строка|массив
$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При создании файлов журнала применяется маска. Если оставлено пустым, chmod не применяется.
[
'path' => null,
'file' => null,
'types' => null,
'levels' => [],
'scopes' => [],
'rotate' => 10,
'size' => 10485760, // 10MB
'mask' => null,
] $_sizesource
protected integer|null
Максимальный размер файла, используется для ротации файлов журнала.
© 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.FileLog.html