hellpers / error
Перехват и логирование ошибок и исключений
Requires
- php: >=7.3.0
- hellpers/logger: 1.1.0
This package is auto-updated.
Last update: 2024-03-29 03:30:38 UTC
README
hellpers/error - Перехват и логирование ошибок и исключений.
Установка:
composer require hellpers/error
Пример:
/* |------------------------------------------------------------------------------- | Пример |------------------------------------------------------------------------------- | | Устанавливаем перехватчик ошибок и исключений вызовом статичного метода | Error::catch(). | | Метод Error::catch() принимает четыре параметра: | 1. Строка. Абсолютный путь к корню приложения; | 2. Строка. Относительный путь к папке для хранения логов внутри приложения; | 3. Строка. Имя для файла, в который будет происходить запись логов; | 4. Число. Уровень перехвата ошибок. Например: E_ALL & ~E_NOTICE. По умолчанию | обрабатываются все возможные ошибки. | | При задании имени файла был использован метод Error::d(). Этот метод позволяет | передать строку, спецсимволы которой будут преобразованы стандартным PHP | методом DateTime::format(). Таким образом имя файла будет содержать текущую | дату. | */ Error::catch( __DIR__, 'temp/errors', Error::d('Y-m-d') . '.txt', E_ALL & ~E_DEPRECATED ); throw new Exception('Исключение');
Документация ко всем методам:
Класс Error реализует шаблон singleton инициализирующим методом которого
является catch(). Возвращаемый объект обладает рядом методов, позволяющих
настроить поведение перехватчика, ниже их описание.
d(string $string): string
Создать шаблон для преобразования методом DateTime::format().
Статический метод.
Порой очень удобно создавать файлы и/или папки, имена которых содержали бы
элементы даты. Например, для записи логов. Передавать уже готовое название не
всегда практично, т.к. если скрипт работает продолжительное время и переходит
из одних суток в другие, тогда название продолжает соответствовать дню
предыдущему.
Метод принимает шаблон результирующей строки, как и метод - DateTime::format()
и возвращает этот же шаблон но обернутый в специальный внутриклассовый, его
уже можно использовать давая названия папкам и файлам, т.к. обрабатываться
методом DateTime::format() название будет непосредтвенно в момент создания,
т.е. будет всегда актуальным.
errors(int $number, string $text, string $file, int $line): void
и
throwables($exception): void
Не предназначены для ручного вызова. Реализуют методы-перехватчики для PHP
функций: set_error_handler() и set_exception_handler(). Если необходимо
изменить формат отображение информации об ошибке, их можно переопределить.
stop(bool $switch): self
Остановливать или нет выполнение скрипта при перехвате ошибки или исключения.
date(string $template): self
Строка, которая преобразовывается стандартным PHP методом DateTime::format().
Позволяет установить необходимый формат отображения времени, когда был сделан
лог.
timezone(int $hours): self
Принимает целое число (как отрицательное, так и положительное). Позволяет
установить псевдо временную зону. Прибавляет указанное число к часам метода
date().
show(bool $switch): self
Включить/отключить вывод логов в консоль.
write(bool $switch): self
Включить/отключить логирование в файл
mail(string $mail, string $from, string $subject): self
Позволяет настроить отправку уведомлений на электронную почту. При рассылки
используется нативная PHP функция - mail().
before(string $str): self и after(string $str): self
Позволяет изменить строки, которыми обрамлено сообщение в начале и конце
текста. Удобно, если необходимо разделять каждое сообщение лога, например
переносами строк: \n, PHP_EOL и т.д.