Spec-Zone.ru › CakePHP 3.7

Класс FileLog

Поток хранения файлов для регистрации. Записывает логи в разные файлы в зависимости от уровня лога.

Psr\Log\AbstractLogger
Extended by Cake\Log\Engine\BaseLog использует Cake\Core\InstanceConfigTrait
Extended by Cake\Log\Engine\FileLog
Пространство имен: Cake\Log\Engine
Расположение: Log/Engine/FileLog.php

Краткое описание свойств

  • $_defaultConfig protected
    array
    Значение конфигурации по умолчанию для данного класса
  • $_file protected
    string|null
    Имя файла для сохранения логов.
  • $_path protected
    string|null
    Путь для сохранения файлов логов.
  • $_size protected
    integer|null
    Максимальный размер файла, используется для ротации файлов логов.

Унаследованные свойства

  • _config, _configInitialized

Краткое описание методов

  • __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
END_OF_DOCUMENT_MARKER ```

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,
]

$_filesource

protected string|null

Имя файла для сохранения логов.

$_pathsource

protected string|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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API