PHPackages                             william-moura/advanced-logger - 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 &amp; Monitoring](/categories/logging)
4. /
5. william-moura/advanced-logger

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

william-moura/advanced-logger
=============================

A lightweight, extensible logging library for PHP with multi-handler support

00PHP

Since Jul 22Pushed 9mo agoCompare

[ Source](https://github.com/william-moura/advanced-logger)[ Packagist](https://packagist.org/packages/william-moura/advanced-logger)[ RSS](/packages/william-moura-advanced-logger/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Advanced Logger for PHP | Registro Avançado em PHP
==================================================

[](#advanced-logger-for-php--registro-avançado-em-php)

[![PHP Version](https://camo.githubusercontent.com/7535257ca228724c93658bd52583d4e47a9bab02c356abf6e54c1d575f2151e6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d626c75652e737667)](https://php.net)[![PSR-3 Compliant](https://camo.githubusercontent.com/b94d3768e0aed5e335e8951a83e34dbaa15f3fd9998286990ea81a68bf5b9c51/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5053522d2d332d636f6d706c69616e742d626c756576696f6c65742e737667)](https://www.php-fig.org/psr/psr-3/)[![License: GPL v3](https://camo.githubusercontent.com/48bf9b56d44f38db53ce21294cf0b9487d0a3734ab3ba1fe4c69858ae20db2c1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c76332d626c75652e737667)](https://www.gnu.org/licenses/gpl-3.0)

A lightweight, extensible logging library for PHP with multi-handler support.
Uma biblioteca de registro (logging) leve e extensível para PHP com suporte a múltiplos handlers.

---

🌟 Features | Funcionalidades
----------------------------

[](#-features--funcionalidades)

- **Multiple Handlers**: Log to files, databases, Telegram, Discord, and more.
    **Múltiplos Handlers**: Registre em arquivos, bancos de dados, Telegram, Discord, etc.
- **PSR-3 Compliance**: Compatible with any PSR-3 logger.
    **Conformidade PSR-3**: Integrável com qualquer biblioteca PSR-3.
- **Custom Formatters**: JSON, plain text, and colored CLI output.
    **Formatadores Personalizados**: JSON, texto simples e saída colorida (CLI).
- **Context Support**: Rich metadata (user ID, IP, exceptions).
    **Suporte a Contexto**: Metadados avançados (ID do usuário, IP, exceções).

---

🚀 Installation | Instalação
---------------------------

[](#-installation--instalação)

```
composer require william-moura/advanced-logger
```

📖 Basic Usage | Uso Básico
--------------------------

[](#-basic-usage--uso-básico)

```
use AdvancedLogger\Logger;
use AdvancedLogger\Handlers\FileHandler;
use AdvancedLogger\Handlers\TelegramHandler;

$logger = new Logger([
    new FileHandler('/var/log/app.log'),
    new TelegramHandler('YOUR_TELEGRAM_BOT_TOKEN', 'CHAT_ID'),
]);

$logger->info('User logged in', ['user_id' => 42]);
$logger->error('Failed to connect to API', ['exception' => $e->getMessage()]);

```

🔧 Available Handlers | Handlers Disponíveis
-------------------------------------------

[](#-available-handlers--handlers-disponíveis)

### Handler Description

[](#handlerdescription)

```
| FileHandler Logs to files (supports rotation). |
| TelegramHandler | Sends logs to Telegram.
| Envia logs para o Telegram. |
| DatabaseHandler | Stores logs in MySQL/PostgreSQL.
| Armazena logs em MySQL/PostgreSQL. |
| DiscordHandler | Posts logs to Discord webhooks.
| Envia logs para webhooks do Discord. |

```

⚙️ Advanced Configuration | Configuração Avançada
-------------------------------------------------

[](#️-advanced-configuration--configuração-avançada)

### Custom Formatter Example | Exemplo de Formatador Personalizado

[](#custom-formatter-example--exemplo-de-formatador-personalizado)

```
use AdvancedLogger\Formatters\JsonFormatter;

$fileHandler = new FileHandler('/var/log/app.json');
$fileHandler->setFormatter(new JsonFormatter());

```

🤝 Contributing | Contribuição
-----------------------------

[](#-contributing--contribuição)

1.Fork the project | Faça um fork do projeto

2.Create a branch: git checkout -b feat/awesome-feature Crie uma branch: git checkout -b feat/nova-funcionalidade

3.Commit changes: git commit -m 'Add awesome feature' Faça o commit: git commit -m 'Adiciona nova funcionalidade'

4.Push: git push origin feat/awesome-feature Envie: git push origin feat/nova-funcionalidade

5.Open a Pull Request | Abra um Pull Request

📜 License | Licença
-------------------

[](#-license--licença)

GPL-3.0 License - See LICENSE for details.

📬 Contact | Contato
-------------------

[](#-contact--contato)

Email:

GitHub: [@william-moura](https://github.com/william-moura)

Issues: [Report a bug](https://github.com/william-moura/advanced-logger/issues)

☕ Support the Project | Apoie o Projeto
---------------------------------------

[](#-support-the-project--apoie-o-projeto)

English: If this library helped you in your projects, consider buying me a coffee to keep the development alive! Your support helps me create more open-source tools and maintain existing ones.

Português: Se esta biblioteca te ajudou em seus projetos, considere me pagar um café para manter o desenvolvimento ativo! Seu apoio me ajuda a criar mais ferramentas open-source e manter as existentes.

[![Buy me a coffee](https://camo.githubusercontent.com/d89a005d80051c4d0f0dab4afaacea27c0045dff2029932b8f48ded7a03feaf1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4275795f4d655f615f436f666665652d4646444430303f7374796c653d666f722d7468652d6261646765266c6f676f3d6275792d6d652d612d636f66666565266c6f676f436f6c6f723d626c61636b)](https://buymeacoffee.com/williammoura)

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance40

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/ceb66a8323b9b8c4ebb12ce5d62ed571e103b91c1898e61cbc07f853b1c2fb4b?d=identicon)[william-moura](/maintainers/william-moura)

---

Top Contributors

[![william-moura](https://avatars.githubusercontent.com/u/26871722?v=4)](https://github.com/william-moura "william-moura (1 commits)")

### Embed Badge

![Health badge](/badges/william-moura-advanced-logger/health.svg)

```
[![Health](https://phpackages.com/badges/william-moura-advanced-logger/health.svg)](https://phpackages.com/packages/william-moura-advanced-logger)
```

###  Alternatives

[psr/log

Common interface for logging libraries

10.4k1.2B9.2k](/packages/psr-log)[itsgoingd/clockwork

php dev tools in your browser

5.9k27.6M94](/packages/itsgoingd-clockwork)[graylog2/gelf-php

A php implementation to send log-messages to a GELF compatible backend like Graylog2.

41838.2M138](/packages/graylog2-gelf-php)[bugsnag/bugsnag-psr-logger

Official Bugsnag PHP PSR Logger.

32132.5M2](/packages/bugsnag-bugsnag-psr-logger)[consolidation/log

Improved Psr-3 / Psr\\Log logger based on Symfony Console components.

15462.2M7](/packages/consolidation-log)[datadog/php-datadogstatsd

An extremely simple PHP datadogstatsd client

19124.6M15](/packages/datadog-php-datadogstatsd)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
