PHPackages                             spatie/flare-debug-sender - 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 & Profiling](/categories/debugging)
4. /
5. spatie/flare-debug-sender

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

spatie/flare-debug-sender
=========================

Debugging tool for Flare payloads

1.0.12(6mo ago)02.7k↓50%[1 PRs](https://github.com/spatie/flare-debug-sender/pulls)MITPHPPHP ^8.2CI passing

Since May 23Pushed 2mo agoCompare

[ Source](https://github.com/spatie/flare-debug-sender)[ Packagist](https://packagist.org/packages/spatie/flare-debug-sender)[ Docs](https://github.com/spatie/flare-debug-sender)[ GitHub Sponsors](https://github.com/spatie)[ RSS](/packages/spatie-flare-debug-sender/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (17)Used By (0)

Debugging tool for Flare payloads
=================================

[](#debugging-tool-for-flare-payloads)

[![Latest Version on Packagist](https://camo.githubusercontent.com/9f63f57e901bb6986fb91b3eb34124cb0418b2b5a735ad239043a69c000780f3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f666c6172652d64656275672d73656e6465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/flare-debug-sender)[![Tests](https://camo.githubusercontent.com/29ec50180bf2b97d1ae79d0cf2d59980d38a7c2cf04545cf2cd18f6d6b5375d5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7370617469652f666c6172652d64656275672d73656e6465722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/spatie/flare-debug-sender/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/b2fd84f41627d7a92e4b9ad5773e0f854a9002c2c7cf8423d2324d0e04815df4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f666c6172652d64656275672d73656e6465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/flare-debug-sender)

This is a debug sender for Flare payloads, mostly used for internal testing purposes.

Support us
----------

[](#support-us)

[![](https://camo.githubusercontent.com/ed9bfa8c811c5aa41736bc6133e46b351ec06145216bf1f214e6e248f4dd3376/68747470733a2f2f6769746875622d6164732e73332e65752d63656e7472616c2d312e616d617a6f6e6177732e636f6d2f666c6172652d64656275672d73656e6465722e6a70673f743d31)](https://spatie.be/github-ad-click/flare-debug-sender)

We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us).

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards).

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

[](#installation)

You can install the package via composer:

```
composer require spatie/flare-debug-sender
```

Usage
-----

[](#usage)

### For Laravel applications

[](#for-laravel-applications)

Ensure Flare's config file is published:

```
php artisan vendor:publish --tag=flare-config
```

Within your `flare.php` config file:

```
return [
    // Other contents ..

    'sender' => [
        'class' => \Spatie\FlareDebugSender\FlareDebugSender::class,
        'config' => [
            'passthrough_errors' => true,
            'passthrough_traces' => true,
            'passthrough_zipkin' => false,
            'replace_tracing_ids' => true,
            'replace_tracing_times' => true,
            'print_full_payload' => false,
            'print_endpoint' => false,
            'print_resource' => false,
            'channel' => \Spatie\FlareDebugSender\Channels\LaravelLogDebugChannel::class,
            'channel_config' => [],
            'sender' => CurlSender::class,
            'sender_config' => [
                'curl_options' => [
                    CURLOPT_SSL_VERIFYHOST => 0,
                    CURLOPT_SSL_VERIFYPEER => 0,
                ],
            ],
        ],
    ],
]
```

### General usage

[](#general-usage)

Within your Flare config:

```
$config->sendUsing(
    \Spatie\FlareDebugSender\FlareDebugSender::class,
    [
        'passthrough_errors' => true,
        'passthrough_traces' => true,
        'passthrough_zipkin' => false,
        'replace_tracing_ids' => true,
        'replace_tracing_times' => true,
        'print_full_payload' => false,
        'print_endpoint' => false,
        'print_resource' => false,
        'channel' => \Spatie\FlareDebugSender\Channels\FileDebugChannel::class,
        'channel_config' => [
            'file' => 'path/to/your/file.log',
        ],
        'sender' => CurlSender::class,
        'sender_config' => [
            'curl_options' => [
                CURLOPT_SSL_VERIFYHOST => 0,
                CURLOPT_SSL_VERIFYPEER => 0,
            ],
        ],
    ]
)
```

Open up Ray and start debugging!

### Ray usage

[](#ray-usage)

When using Ray you can use the following configuration:

```
return [
    // Other contents ...

    'sender' => [
        'class' => \Spatie\FlareDebugSender\FlareDebugSender::class,
        'config' => [
            'passthrough_errors' => true,
            'passthrough_traces' => true,
            'passthrough_zipkin' => false,
            'replace_tracing_ids' => true,
            'replace_tracing_times' => true,
            'print_full_payload' => false,
            'print_endpoint' => false,
            'print_resource' => false,
            'channel' => \Spatie\FlareDebugSender\Channels\RayDebugChannel::class,
            'channel_config' => [],
            'sender' => CurlSender::class,
            'sender_config' => [
                'curl_options' => [
                    CURLOPT_SSL_VERIFYHOST => 0,
                    CURLOPT_SSL_VERIFYPEER => 0,
                ],
            ],
        ],
    ],
]
```

### Options

[](#options)

- `passthrough_errors`: If set to `true`, errors will be passed through to the default sender.
- `passthrough_traces`: If set to `true`, traces will be passed through to the default sender.
- `passthrough_zipkin`: If set to `true`, traces will be sent to a local Zipkin instance.
- `replace_tracing_ids`: If set to `true`, the span ids will be replaced with a more readable version.
- `replace_tracing_times`: If set to `true`, the start and end times of the spans will be replaced with a more readable version.
- `print_full_payload`: If set to `true`, the full payload will be printed.
- `print_endpoint`: If set to `true`, the endpoint will be printed.
- `print_resource`: If set to `true`, the trace resource will be printed.
- `channel`: The channel to use for debugging. Defaults to `RayDebugChannel`.
- `channel_config`: The configuration for the channel. Defaults to an empty array.
- `sender`: The sender to use for sending the payload. Defaults to `CurlSender`.
- `sender_config`: The configuration for the sender.

### Channels

[](#channels)

By default, the `RayDebugChannel` is used. We also provide a few other channels that you can use:

#### LaravelLogDebugChannel

[](#laravellogdebugchannel)

Will write messages to the Laravel log. This is useful for debugging in a Laravel application.

#### FileDebugChannel

[](#filedebugchannel)

Will write messages to a file. This is useful for debugging in a non-Laravel application.

By default, the file will be written to `flare-debug-sender.log` in the root of your project. You can change this by setting the `file` option in the channel configuration:

```
    'channel' => FileDebugChannel::class,
    'channel_config' => [
        'file' => 'path/to/your/file.log',
    ],
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Ruben Van Assche](https://github.com/rubenvanassche)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance77

Regular maintenance activity

Popularity22

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 84.2% 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 ~16 days

Recently: every ~28 days

Total

14

Last Release

150d ago

Major Versions

1.0.12 → v2.x-dev2025-12-19

PHP version history (2 changes)1.0.0PHP ^8.4

1.0.2PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7535935?v=4)[Spatie](/maintainers/spatie)[@spatie](https://github.com/spatie)

---

Top Contributors

[![rubenvanassche](https://avatars.githubusercontent.com/u/619804?v=4)](https://github.com/rubenvanassche "rubenvanassche (32 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (2 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

spatieflare-debug-sender

###  Code Quality

TestsPest

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/spatie-flare-debug-sender/health.svg)

```
[![Health](https://phpackages.com/badges/spatie-flare-debug-sender/health.svg)](https://phpackages.com/packages/spatie-flare-debug-sender)
```

###  Alternatives

[symfony/stopwatch

Provides a way to profile code

2.8k387.2M918](/packages/symfony-stopwatch)[spatie/ignition

A beautiful error page for PHP applications.

511147.6M69](/packages/spatie-ignition)[spatie/backtrace

A better backtrace

433169.4M51](/packages/spatie-backtrace)[spatie/ray

Debug with Ray to fix problems faster

62242.5M758](/packages/spatie-ray)[spatie/laravel-web-tinker

Artisan Tinker in your browser

1.2k3.8M6](/packages/spatie-laravel-web-tinker)[spatie/laravel-ray

Easily debug Laravel apps

31738.4M2.8k](/packages/spatie-laravel-ray)

PHPackages © 2026

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