maantje/xhprof-buggregator-laravel

Xhprof buggregator integration for Laravel

v0.3.0 2024-04-03 20:06 UTC

Requires

• php: ^8.1
• illuminate/contracts: ^10.0|^11.0
• spiral-packages/profiler: ^1.0

Requires (Dev)

• laravel/pint: ^1.0
• orchestra/testbench: ^8.8|^9.0
• pestphp/pest: ^2.20

MIT

• Jamie Schouten

• xhprof
• laravel
• maantje
• buggregator

README

Welcome to the Xhprof integration package for buggregator in Laravel. This repository allows you to effortlessly enable Xhprof support for buggregator in your Laravel application.

Installation

To get started, install the package via composer:

composer require --dev maantje/xhprof-buggregator-laravel

Usage

Set the buggregator endpoint in your environment file, the displayed value is the default value:

PROFILER_ENDPOINT=http://127.0.0.1:8000/api/profiler/store

Toggle Xhprof in your environment file as needed, but remember to disable it when not in use to avoid performance impact

XHPROF_ENABLED=true

Alternatively, you can include the X-Xhprof-Enabled header in your request to explicitly enable or disable profiling for that specific call. When this header is present, it takes precedence over the environment variable.

Enabled values: true 1 on yes
Disabled values: false 0 off no

This feature works great with a browser extension like ModHeader. It lets you switch profiling on and off right from your browser.

Usage with Sail

Add the buggregator service to your docker-compose file:

buggregator:
    image: ghcr.io/buggregator/server:dev
    ports:
        - 8000:8000
        - 1025:1025
        - 9912:9912
        - 9913:9913
    networks:
        - sail

Set the profiler endpoint in your environment file:

PROFILER_ENDPOINT=http://buggregator:8000/api/profiler/store

License

The MIT License (MIT). Please see License File for more information.