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.2.1(3mo ago)118↓89.1%MITPHPPHP ^8.3CI passing

Since Mar 22Pushed 3mo 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 4w ago

READMEChangelog (3)Dependencies (17)Versions (4)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 or 8.4
- **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

37

—

LowBetter than 81% of packages

Maintenance82

Actively maintained with recent releases

Popularity9

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

Total

3

Last Release

91d 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 (40 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

46326.5k](/packages/maantje-xhprof-buggregator-laravel)[spatie/craft-ray

Easily debug CraftCMS projects

1638.4k](/packages/spatie-craft-ray)

PHPackages © 2026

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