PHPackages                             bugadoz/bug-report - 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. [Utility & Helpers](/categories/utility)
4. /
5. bugadoz/bug-report

ActiveLibrary[Utility & Helpers](/categories/utility)

bugadoz/bug-report
==================

Biblioteca PHP para reportar bugs com vídeo e imagem diretamente do navegador.

v5.0(1y ago)02MITPHPPHP >=7.4

Since Apr 9Pushed 1y ago1 watchersCompare

[ Source](https://github.com/bugadoz/bug-report)[ Packagist](https://packagist.org/packages/bugadoz/bug-report)[ RSS](/packages/bugadoz-bug-report/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)DependenciesVersions (6)Used By (0)

🐞 Bugadoz - BugReport PHP
=========================

[](#-bugadoz---bugreport-php)

Relate automaticamente erros do seu sistema PHP com envio para a plataforma [bugadoz.dev](https://bugadoz.dev). Esta biblioteca permite capturar e reportar erros com facilidade e organização.

---

⚙️ Como usar
------------

[](#️-como-usar)

### Instalação

[](#instalação)

Você pode incluir a classe manualmente ou usar um autoloader compatível com PSR-4.

```
require_once 'BugReport.php'; // Ou use um autoloader
use Bugadoz\BugReport;
```

### Exemplo de uso

[](#exemplo-de-uso)

```
$bug = new BugReport('SUA_API_KEY', 'public', 'feedback');

// Reportando um bug manualmente
$bug->reportBug([
    'descricao' => 'Erro ao salvar usuário',
]);

// Captura automática de erros, exceções e fatal errors
$bug->inicializarCapturaAutomatica();
```

---

📥 Parâmetros Aceitos
--------------------

[](#-parâmetros-aceitos)

### `__construct(string $apiKey, string $privacy, string $type)`

[](#__constructstring-apikey-string-privacy-string-type)

ParâmetroTipoObrigatórioDescrição`apiKey`string✅ SimSua chave de autenticação gerada no painel da [bugadoz.dev](https://bugadoz.dev).`privacy`string✅ SimDefine se o relatório de erro será público ou privado. Valores aceitos: `public` ou `private`.`type`string✅ SimDefine o nível de visibilidade do caminho do arquivo no relatório.
Valores aceitos: `onlyme`, `feedback` ou `test`.---

### 🔐 Detalhes dos Parâmetros

[](#-detalhes-dos-parâmetros)

#### 🔑 apiKey

[](#-apikey)

Sua chave única de autenticação com a API da bugadoz.dev. É obrigatória para enviar qualquer relatório.

#### 🕶️ privacy

[](#️-privacy)

Define se o erro reportado poderá ser visualizado publicamente:

- `public` – Qualquer pessoa poderá visualizar o erro.
- `private` – Apenas você terá acesso ao erro no painel.

#### 📂 type

[](#-type)

Define quem poderá ver o **caminho do arquivo** que gerou o erro:

- `onlyme` – Apenas você poderá ver os caminhos dos arquivos (modo mais seguro).
- `feedback` – Caminhos são visíveis publicamente (para relatórios colaborativos).
- `test` – Modo de testes, pode ser usado em ambientes de desenvolvimento.

---

🧪 Captura Automática de Erros
-----------------------------

[](#-captura-automática-de-erros)

Use `inicializarCapturaAutomatica()` para ativar o envio automático de:

- Erros (`set_error_handler`)
- Exceções (`set_exception_handler`)
- Fatal errors (`register_shutdown_function`)

```
$bug->inicializarCapturaAutomatica();
```

---

📁 Armazenamento local de erros
------------------------------

[](#-armazenamento-local-de-erros)

Os erros são salvos automaticamente em arquivos `.txt` dentro da pasta `erros/`, caso não seja possível enviá-los para a API.

---

📬 Suporte
---------

[](#-suporte)

Acesse  para:

- Gerar sua API Key
- Acompanhar seus relatórios
- Compartilhar bugs com sua equipe

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance46

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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 ~1 days

Total

5

Last Release

400d ago

Major Versions

v1.0 → v2.02025-04-09

v2.0 → v3.02025-04-09

v3.0 → v4.02025-04-12

v4.0 → v5.02025-04-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/254af38b722137168e3ced31aadd00ebfb2c9f7278981ee2675e1cbff762f39f?d=identicon)[bugadoz](/maintainers/bugadoz)

---

Top Contributors

[![bigfatherdev](https://avatars.githubusercontent.com/u/115670953?v=4)](https://github.com/bigfatherdev "bigfatherdev (12 commits)")

### Embed Badge

![Health badge](/badges/bugadoz-bug-report/health.svg)

```
[![Health](https://phpackages.com/badges/bugadoz-bug-report/health.svg)](https://phpackages.com/packages/bugadoz-bug-report)
```

PHPackages © 2026

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