PHPackages                             php-bug-catcher/bug-catcher - 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. php-bug-catcher/bug-catcher

ActiveSymfony-bundle

php-bug-catcher/bug-catcher
===========================

Catch all bugs from all your applications in one place

1.2.3(3mo ago)3801[1 issues](https://github.com/php-bug-catcher/bug-catcher/issues)1MITPHPPHP &gt;=8.3CI passing

Since Jun 1Pushed 3mo ago1 watchersCompare

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

READMEChangelog (1)Dependencies (46)Versions (27)Used By (1)

[![Tests](https://github.com/php-bug-catcher/bug-catcher/actions/workflows/symfony.yml/badge.svg)](https://github.com/php-bug-catcher/bug-catcher/actions/workflows/symfony.yml/badge.svg)[![Coverage Status](https://camo.githubusercontent.com/a9e3e6e59e4c5dea1aab726bc0a196bbef8ec5e538986b6ddce3ed90985d224a/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f7068702d6275672d636174636865722f6275672d636174636865722f62616467652e7376673f6272616e63683d6d61696e)](https://coveralls.io/github/php-bug-catcher/bug-catcher?branch=main)

Catch every bug in all your PHP applications in one place
=========================================================

[](#catch-every-bug-in-all-your-php-applications-in-one-place)

[![](docs/logo/default/horizontal.svg)](docs/logo/default/horizontal.svg)

[![](docs/bug_catcher_01.png)](docs/bug_catcher_01.png)

[![](docs/stacktrace.png)](docs/stacktrace.png)

Installation
------------

[](#installation)

### By composer

[](#by-composer)

```
composer create-project php-bug-catcher/skeleton your-project-name
```

### Manual

[](#manual)

see [skeleton/readme.md](https://raw.githubusercontent.com/php-bug-catcher/skeleton/main/README.md)

Features
--------

[](#features)

- **Ping collector**. Ping Your projects in defined intervals to see if they are up and running.
- **Log viewer** with stack trace, code preview and history of all errors.
- **Custom records**. Create custom records to track any data you want.
- **Configurable Notification**. Get notified with favicon, sound email or sms if error count reaches configured threshold.
- **Access controll** Create users with acces to specific projects and its logs. You can add access to your client to see only specific part og logs.
- **Customizable**. You can add your own components to the dashboard.
- **Easy to use**. Just add a few lines of code to your project and you are ready to go.
- **Withholding**. You can hide errors until they reach a configured threshold.
- **Automatic cleanup**. Stack trace is optional and is cleaned up after the error is fixed.

### Roadmap

[](#roadmap)

- Make it work
- Create notification system
- Create basic tests
- Make more tests
- Autoconfiguration
- Create installer
- Release first version
- Email notification component
- Ping history graph component
- Errors history graph component

First Run
---------

[](#first-run)

**Create database**

```
# .env.local
APP_ENV=dev
DATABASE_URL=mysql://user:password@localhost:3306/bug_catcher
```

```
php bin/console doctrine:database:create
php bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrate
php bin/console app:create-user username password
yarn install
yarn build
```

**Start the built-in web server**

You can use Nginx or Apache, but the built-in web server works great:

```
php bin/console server:run

```

Now check out the site at `http://localhost:8000`

**Setup cron for collection status codes**

```
# /etc/crontab
* * * * * www-data php /var/www/bug-catcher/bin/console app:ping-collector > /dev/null 2>&1
#optimize records by grouping them by 5 minutes older than 1 day
0 * * * * www-data php /var/www/bug-catcher/bin/console app:record-optimizer --past=1 --precision=5
#optimize records by grouping them by 60 minutes older than 7 days
0 0 * * * www-data php /var/www/bug-catcher/bin/console app:record-optimizer --past=7 --precision=60

```

Enable Logging
--------------

[](#enable-logging)

**Setup your Symfony applications**

See package [php-bug-catcher/bug-catcher-reporter-bundle](https://github.com/php-bug-catcher/bug-catcher-reporter-bundle)

**Setup plain PHP applications**

See package [php-bug-catcher/bug-catcher-curl-reporter](https://github.com/php-bug-catcher/bug-catcher-curl-reporter)

Modifications
-------------

[](#modifications)

See [docs/extending.md](docs/extending.md) for more information on how to extend the dashboard.

See [docs/custom\_record.md](docs/custom_record.md) for more information on how to create custom record items.

See [docs/notifiers.md](docs/notifiers.md) for more information on how to create custom notifiers.

Have Ideas, Feedback or an Issue?
---------------------------------

[](#have-ideas-feedback-or-an-issue)

If you have suggestions or questions, please feel free to open an issue on this repository.

Have fun!

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance73

Regular maintenance activity

Popularity13

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity66

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

Total

21

Last Release

108d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3d6d558226302620ec462f64672e9dc81609227626923a808005641e76e8c38f?d=identicon)[tito10047](/maintainers/tito10047)

---

Top Contributors

[![tito10047](https://avatars.githubusercontent.com/u/11459248?v=4)](https://github.com/tito10047 "tito10047 (273 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/php-bug-catcher-bug-catcher/health.svg)

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

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[forumify/forumify-platform

121.8k11](/packages/forumify-forumify-platform)[chameleon-system/chameleon-base

The Chameleon System core.

1026.5k3](/packages/chameleon-system-chameleon-base)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[easycorp/easyadmin-demo

EasyAdmin Demo Application

145.7k](/packages/easycorp-easyadmin-demo)

PHPackages © 2026

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