README

Loggie è una libreria di logging moderna, flessibile e compatibile PSR-3, sviluppata in PHP con l'obiettivo di offrire una gestione dei log elegante e integrabile in ambienti reali. Supporta diversi tipi di handler e formatter per adattarsi a molteplici esigenze.

✨ Caratteristiche

• ✅ Compatibile PSR-3 (LoggerInterface)
• 📁 Log su file, database, console, Telegram, email, e null handler
• 🎨 Supporta formatter personalizzati (Interpolated, Line, Telegram)
• 💡 Estendibile con handler e formatter personalizzati
• 🐘 Richiede PHP >= 8.1

📦 Installazione

composer require alaureati-enerds/loggie

🧰 Esempio rapido

Logging su Console

use Loggie\Logger;
use Loggie\Handlers\ConsoleHandler;
use Loggie\Formatters\LineFormatter;
use Loggie\Utils\LoggieLevels;

$handler = new ConsoleHandler(STDOUT, LoggieLevels::DEBUG);
$handler->setFormatter(new LineFormatter());

$logger = new Logger([$handler]);
$logger->info("Applicazione avviata.");

Logging su Telegram

use Loggie\Logger;
use Loggie\Handlers\TelegramHandler;
use Loggie\Formatters\TelegramFormatter;

$logger = new Logger();
$telegram = new TelegramHandler('YOUR_BOT_TOKEN', 'YOUR_CHAT_ID', 'debug', new TelegramFormatter());
$logger->addHandler($telegram);

$logger->warning("Problema rilevato", ['file' => 'index.php']);

Logging via Email con PHPMailer

use Loggie\Handlers\EmailHandler;
use PHPMailer\PHPMailer\PHPMailer;

$mailer = new PHPMailer(true);
// ... configura SMTP ...

$emailHandler = new EmailHandler($mailer, 'admin@example.com', 'bot@example.com', 'Log di sistema');
$logger->addHandler($emailHandler);

🧱 Handler disponibili

• ConsoleHandler – Log a console (STDOUT/STDERR)
• FileHandler – Log su file
• DatabaseHandler – Log su MySQL
• TelegramHandler – Invio log via Telegram Bot
• EmailHandler – Invio log via email (PHPMailer)
• NullHandler – Ignora tutti i log

🎨 Formatter disponibili

• LineFormatter – Formattazione semplice [DATA] LIVELLO: messaggio
• InterpolatedFormatter – Supporta segnaposto come {user} con context
• TelegramFormatter – Formattazione compatibile Markdown V2 con emoji

🔧 Requisiti

• PHP >= 8.1
• Estensioni PHP: curl, pdo, mbstring
• Librerie:
  • phpmailer/phpmailer
  • psr/log

📂 Autoload

"autoload": {
    "psr-4": {
        "Loggie\\": "src/Loggie/"
    }
}

👤 Autore

Andrea Laureati – a.laureati@enerds.it
Sviluppato per eNerds Srl – enerds.it

📄 Licenza

Rilasciato sotto licenza MIT.