PHPackages                             velpl/buggregator-profiler-bundle - 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. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. velpl/buggregator-profiler-bundle

ActiveLibrary[Debugging &amp; Profiling](/categories/debugging)

velpl/buggregator-profiler-bundle
=================================

Symfony bundle integrating Buggregator profiler

0.3.0(1mo ago)126↓94%MITPHPPHP ^8.3CI passing

Since Mar 22Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/velPL/buggregator-profiler-bundle)[ Packagist](https://packagist.org/packages/velpl/buggregator-profiler-bundle)[ RSS](/packages/velpl-buggregator-profiler-bundle/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)Dependencies (34)Versions (6)Used By (0)

A Buggregator profiler bundle for Symfony framework
===================================================

[](#a-buggregator-profiler-bundle-for-symfony-framework)

A Symfony bundle that integrates [Buggregator](https://buggregator.dev) into your Symfony application, enabling you to send profiling data to a running Buggregator server instance. See [Buggregator docs](https://docs.buggregator.dev/getting-started.html) to learn more about Buggregator itself and how to make the most out of it.

Requirements
------------

[](#requirements)

- **PHP:** 8.3, 8.4 or 8.5
- **Symfony:** 6.4 or 7.4 or 8.0+ (for Symfony 8 PHP 8.4+ is required)

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

[](#installation)

> ⚠️ Please mind this is a work in progress and not yet a stable release – breaking changes are possible. Please provide feedback, suggestions and bug reports using GitHub issues. Pull requests are very welcome!

The recommended way to install this bundle is as a **dev dependency**, since profiling is typically only needed during development:

```
composer require --dev velpl/buggregator-profiler-bundle
```

If you need profiling available in production environments as well, you can install it as a regular dependency:

```
composer require velpl/buggregator-profiler-bundle
```

Configuration
-------------

[](#configuration)

### Using Symfony Flex (recommended)

[](#using-symfony-flex-recommended)

This bundle ships with a [Symfony Flex](https://github.com/symfony/flex) recipe available in the [symfony/recipes-contrib](https://github.com/symfony/recipes-contrib) repository.

When installing the bundle via Composer with Flex enabled, you will be prompted to run the contrib recipe automatically. **Accepting it** will:

- Register the bundle in `config/bundles.php`
- Create a default configuration file at `config/packages/buggregator_profiler.yaml`
- Add buggregator service to Docker `compose.yaml` so you can run Buggregator server locally

If you choose **not** to run the recipe automatically, you can refer to the [symfony/recipes-contrib repository](https://github.com/symfony/recipes-contrib) for the recipe contents and apply the configuration manually (see the [Manual Configuration](#manual-configuration) section below).

### Manual Configuration

[](#manual-configuration)

If you are not using Flex or opted out of the recipe, register the bundle manually:

```
// config/bundles.php
return [
    // ...
    Velpl\BuggregatorProfilerBundle\BuggregatorProfilerBundle::class => ['all' => true],
];
```

Then create the configuration file:

```
# config/packages/buggregator_profiler.yaml
buggregator_profiler:
    enabled: false
    application_name: 'Symfony App'
    profiler_url: 'http://127.0.0.1:8000'
```

Set environment variables to configure the bundle (skips ones for which you want default values):

```
BUGGREGATOR_PROFILER_PORT=
BUGGREGATOR_PROFILER_URL=
BUGGREGATOR_BUNDLE_PROFILER_URL=${BUGGREGATOR_PROFILER_URL}:${BUGGREGATOR_PROFILER_PORT}
BUGGREGATOR_BUNDLE_SMTP_PORT=
BUGGREGATOR_BUNDLE_VARDUMPER_PORT=
BUGGREGATOR_BUNDLE_MONOLOG_PORT=
BUGGREGATOR_BUNDLE_CONTAINER_NAME=
BUGGREGATOR_BUNDLE_IMAGE_TAG=
```

It's highly recommended to set `BUGGREGATOR_BUNDLE_IMAGE_TAG` to a specific version of the Buggregator server image to avoid unexpected behavior. You can find the available versions on [Buggregator server versions on GitHub](https://github.com/buggregator/server/pkgs/container/server/versions).

And finally add the Buggregator service to your Docker `compose.yaml`:

```
  buggregator-profiler:
    image: ghcr.io/buggregator/server:${BUGGREGATOR_BUNDLE_IMAGE_TAG:-latest}
    container_name: ${BUGGREGATOR_BUNDLE_CONTAINER_NAME:-buggregator-profiler}
    ports:
      - "${BUGGREGATOR_PROFILER_PORT}:8000"
      - "${BUGGREGATOR_BUNDLE_SMTP_PORT}:1025"
      - "${BUGGREGATOR_BUNDLE_VARDUMPER_PORT}:9912"
      - "${BUGGREGATOR_BUNDLE_MONOLOG_PORT}:9913"
    restart: unless-stopped
```

Configuration Reference
-----------------------

[](#configuration-reference)

OptionTypeDefaultDescription`enabled`bool`false`Whether profiling is active. Set to `true` to start sending data.`application_name`string`'Symfony App'`A label used to identify your application in Buggregator.`profiler_url`string`'http://127.0.0.1:8000'`The URL of your running Buggregator server instance.> **Note:** The bundle is disabled by default. Set `enabled: true` (or control it via an environment variable) to activate profiling.

License
-------

[](#license)

MIT

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance91

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

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

Total

4

Last Release

43d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/97a3d84cab16e7282803fcc335825a1573903fd54d0865d2b65c3bb70bdcaabf?d=identicon)[velPL](/maintainers/velPL)

---

Top Contributors

[![velPL](https://avatars.githubusercontent.com/u/739623?v=4)](https://github.com/velPL "velPL (43 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/velpl-buggregator-profiler-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/velpl-buggregator-profiler-bundle/health.svg)](https://phpackages.com/packages/velpl-buggregator-profiler-bundle)
```

###  Alternatives

[maantje/xhprof-buggregator-laravel

Xhprof buggregator integration for Laravel

48380.0k](/packages/maantje-xhprof-buggregator-laravel)[proget-hq/phpstan-yii2

Yii2 extension for PHPStan

52614.0k7](/packages/proget-hq-phpstan-yii2)[upscale/swoole-blackfire

Blackfire profiler integration for Swoole web-server

22126.6k13](/packages/upscale-swoole-blackfire)[fjogeleit/prometheus-messenger-middleware

Prometheus Middleware for the Symfony Messenger Component

2255.2k](/packages/fjogeleit-prometheus-messenger-middleware)

PHPackages © 2026

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