PHPackages toropyga/flog - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. toropyga/flog ActiveLibrary[Logging & Monitoring](/categories/logging) toropyga/flog ============= Libraries for logging from Toropyga v4.0.1(2w ago)0918MITPHPPHP >=7.4 Since Aug 10Pushed 2w ago1 watchersCompare [ Source](https://github.com/Toropyga/FLog)[ Packagist](https://packagist.org/packages/toropyga/flog)[ RSS](/packages/toropyga-flog/feed)WikiDiscussions master Synced 1w ago READMEChangelogDependencies (4)Versions (21)Used By (0) FLog ==== [](#flog) Класс логирования [![License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)[![Version](https://camo.githubusercontent.com/985bd305e4815d757a10878c171422997ea3a654069a376498aa8dfb7c17f98f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d76342e302e312d626c75652e737667)](https://camo.githubusercontent.com/985bd305e4815d757a10878c171422997ea3a654069a376498aa8dfb7c17f98f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d76342e302e312d626c75652e737667)[![PHP](https://camo.githubusercontent.com/da7f9a9360ffe8c074def37035c40930c6bbdab829456c0e8e3215380ff50526/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d76372e345f2d2d5f76382d626c756576696f6c65742e737667)](https://camo.githubusercontent.com/da7f9a9360ffe8c074def37035c40930c6bbdab829456c0e8e3215380ff50526/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d76372e345f2d2d5f76382d626c756576696f6c65742e737667) Содержание ---------- [](#содержание) - [Общее описание](#%D0%9E%D0%B1%D1%89%D0%B5%D0%B5-%D0%BE%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5) - [Установка](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0) - [Настройка](#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0) - [Описание работы](#%D0%BE%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B) - [Подключение файла класса](#%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0-%D0%BA%D0%BB%D0%B0%D1%81%D1%81%D0%B0) - [Инициализация класса](#%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D0%BA%D0%BB%D0%B0%D1%81%D1%81%D0%B0) - [Настройка параметров](#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%BE%D0%B2) - [Сохранение строки логов](#%D0%A1%D0%BE%D1%85%D1%80%D0%B0%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D1%82%D1%80%D0%BE%D0%BA%D0%B8-%D0%BB%D0%BE%D0%B3%D0%BE%D0%B2) - [Сохранение массива логов](#%D0%A1%D0%BE%D1%85%D1%80%D0%B0%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BC%D0%B0%D1%81%D1%81%D0%B8%D0%B2%D0%B0-%D0%BB%D0%BE%D0%B3%D0%BE%D0%B2) Общее описание -------------- [](#общее-описание) Класс FLog предназначен для сохранения переданных данных в файл. Для работы необходимо наличие PHP версии 7.1 и выше. Есть возможность настройки размера конечного файла и времени хранения файлов. Файлы логов не будут превышать указанного размера и не будут хранится дольше указанного времени хранения. Установка --------- [](#установка) Рекомендуемый способ установки библиотеки FLog с использованием [Composer](http://getcomposer.org/): ``` composer require toropyga/flog ``` Настройка --------- [](#настройка) Предварительная настройка параметров по умолчанию может осуществляться или непосредственно в самом классе, или с помощью именованных констант. Именованные константы при необходимости объявляются до вызова класса, например, в конфигурационном файле, и определяют параметры по умолчанию. - LOG\_ROOT\_PATH - путь к корневой директории сайта, по умолчанию - текущая директория; - LOG\_PATH - имя директории в которой создаётся директория логов; - LOG\_DIR - имя директории логов; - LOG\_NAME - имя файла логов; - LOG\_SIZE - максимальный размер файла логов в мегабайтах (Мб); - LOG\_TIME - количество дней на протяжении которых сохраняются логи; - LOG\_LEVEL - уровень лога по умолчанию (debug, info, notice, warning, error, critical, alert, emergency); - LOG\_SAVE\_NOW - сохранять строку лога сразу в файл или сохранить пакетом по окончании работы; Описание работы --------------- [](#описание-работы) ### Подключение файла класса [](#подключение-файла-класса) ``` require_once("Base.php"); require_once("FLog.php"); ``` или с использованием composer ``` require_once("vendor/autoload.php"); ``` --- ### Инициализация класса [](#инициализация-класса) ``` $LOG = new Toropyga\FLog(); ``` --- ### Настройка параметров [](#настройка-параметров) Настройка объёма служебной информации в логе. Может принимать значения: - **simple** - date, level, uri - **advanced** - ip, date, level, uri - **full** - ip, date, level, uri, user agent ``` $LOG->setSystemInfo('advanced'); ``` --- Установка уровня логов. Может принимать значения: emergency, alert, critical, error, warning, notice, info, debug ``` $LOG->setLogLevel('error'); ``` --- Установка имени файла для записи логов ``` $LOG->setName ($file); ``` --- Установка способа сохранения логов. На вход может принимать на вход числа от 0 до 6 или строку (file - в файл, stdout - система, db - база данных) Числа: - 0 - сохранять в файл - 1 - сохранять в STDOUT - 2 - сохранять в БД - 3 - сохранять в файл и STDOUT - 4 - сохранять в файл и БД - 5 - сохранять в STDOUT и БД - 6 - сохранять в файл, STDOUT и БД Если на вход подаётся не число, а строка, то в ней может быть казано несколько типов, разделённых запятой в любом порядке ('file, db') По умолчанию сохраняет только в файл. ``` $LOG->setSaveType(4); ``` или ``` $LOG->setSaveType('file,db'); ``` --- Подключение базы данных для записи логов в базу данных ``` use Toropyga\DB; $DB = new DB\MySQL(); $LOG->setDB($DB); ``` --- ### Сохранение строки логов [](#сохранение-строки-логов) Предварительные данные лога. *В тексте лога возможна подстановка. Подстановочная переменная выделяется фигурными скобками. Подстановка осуществляется значениями из массива context по ключу, соответствующему имени подстановочной переменной без фигурных скобок. ([см. документацию п.1.2](https://www.php-fig.org/psr/psr-3/))* ``` $message = "log text for {user}"; $context = array("user" => "you", "other" => "Other information"); // необязательный параметр ``` Лог уровня **debug** ``` $LOG->debug($message, $context); ``` Лог уровня **info** ``` $LOG->info($message, $context); ``` Лог уровня **notice** ``` $LOG->notice($message, $context); ``` Лог уровня **warning** ``` $LOG->warning($message, $context); ``` Лог уровня **error** ``` $LOG->error($message, $context); ``` Лог уровня **critical** ``` $LOG->critical($message, $context); ``` Лог уровня **alert** ``` $LOG->alert($message, $context); ``` Лог уровня **emergency** ``` $LOG->emergency($message, $context); ``` --- Также возможен общий вариант с указанием уровня логов ``` $level = "debug"; $message = "log text for {user}"; $context = array("user" => "you"); // необязательный параметр $LOG->log($level, $message, $context); // сохраняем лог ``` --- Можно использовать устаревший вариант ``` $message = "log text"; $file = "file_log_name"; $LOG->set2Log($message, $file); // сохраняем лог ``` --- ### Сохранение массива логов [](#сохранение-массива-логов) ``` $LOG->setLevel('debug'); // устанавливаем, если необходимо, уровень логов $logs = array(); $logs['log'][] = "log text line 1"; $logs['log'][] = "log text line 2"; $logs['log'][] = "log text line 3"; $logs['file'] = "file_log_name"; $LOG->setArray2Log($logs); // сохраняем лог ``` ### Health Score 48 — FairBetter than 94% of packages Maintenance96 Actively maintained with recent releases Popularity16 Limited adoption so far Community7 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~95 days Recently: every ~372 days Total 20 Last Release 20d ago Major Versions v2.2.2 → v3.0.02022-03-21 v3.0.7 → v4.0.02026-07-29 PHP version history (4 changes)v2.0.0PHP >=5.1.0 v2.2.2PHP >=7.1 v3.0.0PHP ^7.4 v3.0.3PHP >=7.4 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/57900903?v=4)[Toropyga](/maintainers/Toropyga)[@Toropyga](https://github.com/Toropyga) --- Top Contributors [![Toropyga](https://avatars.githubusercontent.com/u/57900903?v=4)](https://github.com/Toropyga "Toropyga (34 commits)") ### Embed Badge ![Health badge](/badges/toropyga-flog/health.svg) ``` [![Health](https://phpackages.com/badges/toropyga-flog/health.svg)](https://phpackages.com/packages/toropyga-flog) ``` ### Alternatives [psr/log Common interface for logging libraries 10.4k1.2B12.8k](/packages/psr-log)[open-telemetry/api API for OpenTelemetry PHP. 2044.7M351](/packages/open-telemetry-api)[open-telemetry/sdk SDK for OpenTelemetry PHP. 2430.8M433](/packages/open-telemetry-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)