NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #270 most downloaded on Packagist
Send PHP errors to Flare
Latest stable
3.6.1
Last release 9 days ago
13 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
90 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Stop calling Guzzle helpers that 8.5 deprecates by @GrahamCampbell in #118
Full Changelog: 3.6.0...3.6.1
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.6.0...3.6.1
Nested body censoring, cookie censoring by name, cache and database connection events, and a fix for forked processes resending the parent's data.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nested body censoring, cookie censoring by name, cache and database connection events, and a fix for forked processes resending the parent's data.
A body field like password was only censored at the top level, so {"user": {"password": "..."}} reached Flare as-is. A field name without a dot now matches that key at any depth, so the default password and password_confirmation fields also cover nested JSON bodies. Dot notation paths like user.password keep matching only that exact path, and a bare * still censors every top-level field.
Existing installs will see more censoring after upgrading: a configured name like email now also hides address.email and items.*.email. Use a dotted path if you want one exact key.
Thanks @mattiasgeniar.
Cookies could only be censored all or nothing. Either Flare got every cookie, or censorCookies() dropped them all. You can now censor specific cookies by name, next to the existing header and body field lists:
FlareConfig::make('api-key')
->censorCookieNames('PHPSESSID', 'remember_*');Censored cookies keep their key, so you still see they were there. Names match case insensitively, a dot in a cookie name is taken literally, and a segment ending in * matches every key with that prefix. Body fields get the prefix wildcard too, for example censorBodyFields('pass*', 'user.api_*').
Thanks @rubenvanassche.
Cookie and Set-Cookie headers (#114)Cookie names were only censored in the parsed http.request.cookies array. When the Cookie or Set-Cookie headers were removed from censorHeaders(), the raw headers still carried the values. The redactor now censors matching name=value pairs inside both headers as well.
The Symfony request and response providers also joined multi-value headers without a separator, which glued a Laravel response's two Set-Cookie lines into one string. They now join with a comma.
Thanks @rubenvanassche.
After pcntl_fork() the child got a copy of the open trace, the buffered logs and the queued reports, and sent all of it again on exit. Fork three children and Flare received the same spans four times (#99).
A child now behaves like a separate service continuing the parent's trace. It keeps the trace id, uses the span that was open at the fork as its parent, and only sends what it created itself. The new ForkedProcess class detects the fork right before anything is buffered or sent, and Tracer, Logger and Api reset their buffers when it fires. Api, Tracer and Logger gained a ForkedProcess constructor argument, which only matters if you construct them yourself.
Thanks @rubenvanassche and @tareq-halaby.
The CacheRecorder only recorded successful operations. It now has recordKeyWriteFailed() and recordKeyForgetFailed() for a store that refuses writes, and recordFlushed() and recordFlushFailed() for a cache being wiped. Flush is part of the default operations, since a flush is rare and high signal.
Every recording method also accepts array $tags = [], which lands in a cache.tags attribute. A tagged flush only clears part of a store, so without the tags it would look like a full flush. The failover event that #97 introduced was removed again in #115 before this release.
Thanks @rubenvanassche.
A new DatabaseConnectionRecorder records a "Database connection" span around the moment a connection is opened, with the php_database_connection span type. Integrations call recordStart(), recordEnd() and recordFailed() around their own connect call. The recorder is registered with the query recorder and follows its with_traces setting, and connection spans only show up in traces.
Thanks @rubenvanassche.
ReportTrimmer::needsToBeTrimmed() encoded the whole payload with json_encode before every trimming strategy. A report with a big request body could push the process past its memory limit while reporting an error, and the report was lost.
The trimmer now first sums the length of all strings in the payload. JSON encoding never makes a string shorter, so when that sum is already over the limit it skips the encode and lets the strategies cut the large strings first. Trimming a payload with a 50 MB string used about 50 MB of extra memory before. It now stays small.
Thanks @AlexVanderbist.
When Flare's exception handler was the only one registered, it reported the exception and then swallowed it. PHP never saw it as uncaught, so the request ended with an empty 200, nothing reached the error log, and error_get_last() stayed empty. That broke apps like WordPress, which show their recovery page from a shutdown function.
handleException() now rethrows the exception when there is no previous handler, so PHP returns a 500 and logs the error. The exception is still reported only once.
Thanks @AlexVanderbist.
recordEndFromGlobals to record request attributes in plain PHP apps (#107)Plain PHP apps that ended a request with recordEndFromDefined() never got the request attributes such as http.request.method and url.full, so Flare could not group those requests into routes. recordEndFromGlobals() is the counterpart of recordStartFromGlobals() and reads the request from $_SERVER and the response from http_response_code() and headers_list().
PhpResponseAttributesProvider now falls back to those globals when no status code or headers are passed, so recordEndFromDefined() picks them up as well.
Thanks @AlexVanderbist.
max_items_with_errors configuration for view collection (#103)The view recorder ignored the max_items_with_errors option, so an error report could carry every rendered view (#101). collectViews() now has a maxItemsWithErrors parameter, defaulting to 100 like the other recorders, and forwards it to the recorder.
The new parameter sits before $extra. A call that passed the extra options array as the third positional argument must switch to a named argument.
Thanks @Menna-Baligh.
OTLP/JSON leaves out empty and default fields, so a valid client can send an attribute without a value or key, or an empty list as {"arrayValue": {}}. The mapper read those keys directly and threw a TypeError or raised an undefined key warning. Those fields now fall back to a default: an attribute without a value is skipped, one without a key is stored under an empty string, and an empty list becomes an empty array.
Thanks @rubenvanassche.
Full Changelog: 3.5.1...3.6.0
Send the pretty package version as the telemetry SDK version by @rubenvanassche in #96
Full Changelog: 3.5.0...3.5.1
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.5.0...3.5.1
Fix external HTTP spans leaking and missing error information by @rubenvanassche in #94
Full Changelog: 3.4.4...3.5.0
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.4.4...3.5.0
Dump the Flare configuration when running the tester in debug verbosity by @rubenvanassche in #93
Full Changelog: 3.4.3...3.4.4
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.4.3...3.4.4
Check whether an entity is enabled before running its pre-checks in flare:test by @rubenvanassche in #92
Full Changelog: 3.4.2...3.4.3
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.4.2...3.4.3
Always end the trace when a subtask ends by @rubenvanassche in #91
Full Changelog: 3.4.0...3.4.2
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.4.0...3.4.2
Rerelease due to tagging conflict
Rerelease due to tagging conflict
Add ability to skip cache keys in the CacheRecorder by @rubenvanassche in #87
Full Changelog: 3.3.1...3.4.0
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.3.1...3.4.0
Add support for Guzzle 8 by @GrahamCampbell in https://github.com/spatie/flare-client-php/pull/86
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.3.0...3.3.1
Trim large span attributes at record time to bound trace memory by @rubenvanassche in https://github.com/spatie/flare-client-php/pull/85
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.2.1...3.3.0
Add expectAttributeIf test helper by @rubenvanassche in https://github.com/spatie/flare-client-php/pull/83
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.2.0...3.2.1
Support PHP 8.1 by @rubenvanassche in https://github.com/spatie/flare-client-php/pull/82
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.1.2...3.2.0
Strip embedded credentials from git remote URL by @rubenvanassche in https://github.com/spatie/flare-client-php/pull/81
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.1.1...3.1.2
Fix previous throwable stacktrace using the wrong exception's frames by @rubenvanassche in https://github.com/spatie/flare-client-php/pull/79
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.1.0...3.1.1
Attach trace and span id to error reports by @rubenvanassche in https://github.com/spatie/flare-client-php/pull/77
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.0.1...3.1.0
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.0.0...3.0.1
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.0.0...3.0.1
Dedicated logging: new first-class logger on $flare->log() that records messages in the OpenTelemetry log format, replacing reportMessage(). Log level
Logs, logs, logs and more:
$flare->log() that records messages in the OpenTelemetry log format, replacing reportMessage(). Log levels now use Monolog's Level enum. See Logs.DynamicSampler with SamplingRule definitions, letting you sample per entry point (e.g. health checks at 0%, checkout flows at 100%) without writing a custom sampler. See Sampling.?bool $parentSampled and can honor (or override) the inherited decision.JobRecorder and QueueRecorder as part of the standard recorder pipeline. See Jobs and queues.EntryPoint value object resolved via EntryPointResolver, replacing the loose entryPointClass arguments and array context passed to samplers.RequestAttributesProvider, ResponseAttributesProvider, RouteAttributesProvider, CommandAttributesProvider, JobAttributesProvider, and UserAttributesProvider contracts, replacing ad-hoc recorder arguments. See Attribute providers.Lifecycle class on $flare->lifecycle that owns flushing, resets, and internal state previously exposed on Flare. See Application lifecycle.DaemonSender ships with the client and routes errors, traces, and logs through the local Flare daemon, with curl fallback when it's unreachable.Flare accessors are now properties: $flare->tracer, $flare->backTracer, $flare->sentReports, $flare->ids, $flare->time, $flare->lifecycle, $flare->logger, $flare->reporter are public readonly properties.collectSolutions(), withSolutionProvider(), AddSolutions middleware, the spatie/error-solutions dependency).reportMessage(), includeStackTraceWithMessages(), MessageLevels enum, sendReportsImmediately(), Flare::reset(), $flare->application().collectLogs() → collectLogsWithErrors(), ignoreLogs() → ignoreLogsWithErrors(), Tracer::addRawSpan() → addSpan().Full upgrade notes in UPGRADING.md.
Make Tester extensible and framework-aware by @rubenvanassche in https://github.com/spatie/flare-client-php/pull/72
Full Changelog: https://github.com/spatie/flare-client-php/compare/3.0.0-rc.2...3.0.0-rc.3
Added flare-daemon as default dependency
flare-daemon as default dependencyFull Changelog: https://github.com/spatie/flare-client-php/compare/3.0.0-rc.1...3.0.0-rc.2
RC for the new Flare package, don't use this in production!
RC for the new Flare package, don't use this in production!
Handle non-JSON API responses gracefully in senders
Full Changelog: https://github.com/spatie/flare-client-php/compare/2.10.1...2.10.2
fix deprecation warnings for PHP 8.5
Full Changelog: https://github.com/spatie/flare-client-php/compare/2.10.0...2.10.1
Add new FullStacktraceAndExceptionClassAndCode grouping override
FullStacktraceAndExceptionClassAndCode grouping overrideFull Changelog: https://github.com/spatie/flare-client-php/compare/2.9.0...2.10.0
Allow censoring cookies and sessions
Allow configuring the Request and Console attribute providers
Add exception code to report by @AlexVanderbist in https://github.com/spatie/flare-client-php/pull/60
code to report by @AlexVanderbist in https://github.com/spatie/flare-client-php/pull/60Full Changelog: https://github.com/spatie/flare-client-php/compare/2.6.0...2.7.0
send testtrace function for flare:test command by @Marcel-Wil in https://github.com/spatie/flare-client-php/pull/59
Full Changelog: https://github.com/spatie/flare-client-php/compare/2.5.3...2.6.0
Fix for composer format by @YasserB94 in https://github.com/spatie/flare-client-php/pull/57
Full Changelog: https://github.com/spatie/flare-client-php/compare/2.5.2...2.5.3
Allow body field censoring using dot and wildcard syntax
Fix an issue where the disabled Flare infrastructure wasn't working propertly
Full Changelog: https://github.com/spatie/flare-client-php/compare/2.5.0...2.5.1
Add support for better trace context recording
Update the Git Collector to be more performant
Use local data to determine the telemetry sdk version
Fix attribute key for span type in FilesystemRecorder.php
Better handling of success codes in the Api
Completely refactored the recorders, the old traits are now deprecated in favour of specific classes for spans or span events
- Fix sampler
Fix missing interface parameter
Full Changelog: https://github.com/spatie/flare-client-php/compare/2.2.0...2.2.2
Nothing published for this version
Add additional methods to control custom context
Full Changelog: https://github.com/spatie/flare-client-php/compare/2.1.0...2.2.0
Add support for stacktraces with logs
Laravel's artisan is now considered a vendor file in stacktraces
artisan is now considered a vendor file in stacktracesplease is now considered a vendor file in stacktracesFull Changelog: https://github.com/spatie/flare-client-php/compare/2.0.8...2.0.9
Fix issue where dns servers were contacted by @rubenvanassche in https://github.com/spatie/flare-client-php/pull/44
Full Changelog: https://github.com/spatie/flare-client-php/compare/2.0.7...2.0.8
- Add support for Curl Options
- Add support for disabled Flare
Add base path to stacktrace builder
Fix null values in Otel attributes mapper
- Use base URL const
- Use correct base url
- Routing changes
A complete rewrite of the package:
A complete rewrite of the package:
Strip embedded credentials (for example a GitHub OAuth token from Laravel Forge deployments) from the git remote URL before it is sent to Flare, by @m
Full Changelog: 1.11.1...1.11.2
Fixed: client now accepts HTTP status 201 as a successful response
Full Changelog: https://github.com/spatie/flare-client-php/compare/1.11.0...1.11.1
Support Laravel 13 by @erikn69 in https://github.com/spatie/flare-client-php/pull/67
Full Changelog: https://github.com/spatie/flare-client-php/compare/1.10.1...1.11.0
Supports Laravel 12 by @duncanmcclean in https://github.com/spatie/flare-client-php/pull/38
Full Changelog: https://github.com/spatie/flare-client-php/compare/1.10.0...1.10.1
Add support for overriding grouping
Fix PHP 8.4 deprecation errors by @Nationalcat in https://github.com/spatie/flare-client-php/pull/33
Full Changelog: https://github.com/spatie/flare-client-php/compare/1.8.0...1.9.0
Fix issues with symphony request payloads not behaving like they should.
Refactor solutions by @rubenvanassche in https://github.com/spatie/flare-client-php/pull/30
Full Changelog: https://github.com/spatie/flare-client-php/compare/1.6.0...1.7.0
One column per quarter.