Download the PHP package igancev/log without Composer
On this page you can find all versions of the php package igancev/log. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package log
Short Description Composer package by igancev for record log in file, and delete their
License
Homepage https://github.com/igancev/log
Informations about the package log
log - логирование в файлы на PHP
Библиотека для логирования всевозможных данных в файлы, их структурированного хранения, а также их очистки по истечении срока жизни. Удобный инструмент для записи логов периодических и не только операций, и автоматического своевременного удаления устаревших файлов с диска.
Установка
log доступен на Packagist (igancev/log) и устанавливается через Composer.
или
добавлением igancev/log в require section вашего composer.json file:
Использование
Запись лога в одну строку
Запись лога с кастомизированными настройками:
- относительную от корня сайта директорию хранения логов вида "/path/to/dir/" (при отсутствии создается автоматически, по умолчанию "/log/")
- имя файла (по умолчанию "log")
- расширение файла (по умолчанию "txt")
- сортировку записи. Log::SORT_ASC - запись новых данных в конец файла, Log::SORT_DESC - запись новых данных в начало файла (по умолчанию Log::SORT_ASC)
- время жизни файла в днях (по умолчанию не задано)
- текст лога
Результатом работы будет файл /my/auto/creating/dir/myFileName-dd.mm.yyyy-lifetime-10.txt, где dd.mm.yyyy - текущая дата. Таким образом каждый день будет создаваться новый файл. В течение дня все данные будут записываться в текущий файл в зависимости от указанной сортировки. Содержимое файла:
Автоматическое удаление устаревших файлов
Со временем файлы логов, особенно при периодических операциях, накапливаются, занимая драгоценное место на диске. Устанавливая при создании объекта метку lifetime методом $log->setLifeTime($daysCount), мы оставляем тем самым для себя возможность в дальнейшем чистить устаревшие файлы (с истекшим "сроком действия" lifetime), установив на периодическое выполнение (например cron) метод:
- первый параметр - путь путь директории для поиска и удаления устаревших файлов
- второй параметр - рекурсивность. По умолчанию true. При установке в значение false удалит устаревшие файлы только в заданной директории, не производя поиск во вложенных разделах.