babaev-an / ANB PHP COMPONENTS PACK

log_handlers/FileHandler.md

Класс FileHandler

Пространство имён: goodboyalex\php_components_pack\log_handlers
Версия: 1.0
Доступно с: 1.3

Описание

Класс реализует базовый обработчик системы журналирования для вывода сообщений в файл. Обеспечивает простую запись логов без дополнительных функций буферизации или ротации.

Основные характеристики

  • Простая запись: прямое сохранение сообщений в файл
  • Конфигурация: через параметр файла
  • Форматирование: использует установленный форматер
  • Режим записи: добавление в конец файла

Свойства класса

  • formatter: объект форматера сообщений
  • config: массив конфигурации

Методы класса

Основные методы

  • handle(): обработка и запись сообщения
  • setFile(): установка пути к файлу

Конфигурация

Пример настроек:

$config = [
    'file' => 'c:\logs\my_log.log'
];

Примеры использования

// Создание обработчика
$formatter = new DefaultLogFormatter();
$handler = new FileHandler();
$handler->formatter = $formatter;
$handler->setFile('app.log');

// Обработка сообщения
$handler->handle(
    MessageType::INFO,
    'Операция выполнена',
    ['user_id' => 123]
);

Особенности реализации

  • Простая архитектура: минимум зависимостей
  • Прямой доступ: непосредственная запись в файл
  • Режим добавления: файлы не перезаписываются
  • Минимальные требования: подходит для простых сценариев

Рекомендации по использованию

  1. Настройка файла:

    • Укажите корректный путь к файлу
    • Проверьте права доступа

  2. Обработка ошибок:

    • Добавьте проверку существования директории
      • Обработайте возможные ошибки записи

Ограничения

  • Производительность: прямая запись может снижать производительность
  • Размер файла: нет автоматической ротации
  • Безопасность: требуется контроль прав доступа

На главную | Содержание

Назад