Download the PHP package apxcde/laravel-telltale without Composer
On this page you can find all versions of the php package apxcde/laravel-telltale. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download apxcde/laravel-telltale
More information about apxcde/laravel-telltale
Files in apxcde/laravel-telltale
Package laravel-telltale
Short Description Send Laravel errors, logs and traces to Telltale. A fork of spatie/laravel-flare.
License MIT
Homepage https://github.com/apxcde/laravel-telltale
Informations about the package laravel-telltale
Laravel Telltale: send Laravel errors, logs and traces to Telltale
apxcde/laravel-telltale is the Laravel client for Telltale, a self-hosted receiver for errors, logs and performance traces. It runs inside your application and reports to your own Telltale installation.
This package is a fork of spatie/laravel-flare by Spatie. It is not affiliated with Spatie or Flare. The fork does not follow upstream releases.
What differs from spatie/laravel-flare
- Names. The namespace is
Apxcde\LaravelTelltale, the config file isconfig/telltale.php, the log driver istelltale, the facade isTelltaleand the test command istelltale:test. - Env variables start with
TELLTALE_:TELLTALE_KEY,TELLTALE_BASE_URL,TELLTALE_REPORT,TELLTALE_TRACE,TELLTALE_SAMPLER_RATEandTELLTALE_LOG. - No default server. Nothing is sent unless both
TELLTALE_KEYandTELLTALE_BASE_URLare set. The package never falls back to flareapp.io. - Tracing is off by default. Enable it with
TELLTALE_TRACE=true. - The error page's Share button is off by default, because it uploads the error to flareapp.io.
-
Query bindings are not sent by default, because bound values often hold personal data. Queries are reported with their
?placeholders, and the message of a failed query is rewritten the same way. To send the values, setinclude_bindingstotruefor the queries collect inconfig/telltale.php:A value the database quotes in its own error text, such as the duplicate value in a unique key violation, is still part of the message.
- Query strings are censored. The
censor.body_fieldslist also applies to query string parameters in URLs: the request's URL and entry point, theRefererheader, the request shown as a stack frame argument, and the URLs of outgoing HTTP requests. On a web request the process command is not reported, because PHP can put the query string there. Withphonein the list,/search?phone=...is sent as/search?phone=<CENSORED:string>. Values in the path of a URL (/contacts/+15551234567) are not censored. - Exception context is censored. The array an exception returns from
context()is sent ascontext.exception. Thecensor.body_fieldslist applies to it too, at any depth.
The wire protocol is unchanged. The package still depends on spatie/flare-client-php, which builds and sends the payloads, so its classes keep the Spatie\FlareClient namespace and the payloads keep Flare's attribute names (for example flare.entry_point.type).
Requirements
PHP 8.2 or higher and Laravel 10.14 or higher. The package conflicts with spatie/laravel-ignition, which needs an older spatie/flare-client-php; remove Ignition first.
Installation
The package is not on Packagist. Add its repository to your composer.json, then require it:
Set the project key and the URL of your Telltale installation in .env:
Report exceptions from bootstrap/app.php:
To send logs, add a channel with the telltale driver to config/logging.php and include it in your stack:
To change the defaults, publish the config file:
Then check the setup. Each flag sends one test payload of that kind:
Keeping tests silent
Set an empty key in phpunit.xml so your test suite never sends anything:
Testing the package
The test suite includes integration tests that need a running workbench server and queue worker:
To run only the unit tests:
Changelog
UPGRADING record the history of spatie/laravel-flare up to the point of the fork, and use its names.
Credits
- Spatie and all contributors to
spatie/laravel-flare, who wrote nearly all of this code.
License
The MIT License (MIT). Please see the License File for more information.
All versions of laravel-telltale with dependencies
ext-curl Version *
ext-json Version *
ext-mbstring Version *
illuminate/support Version ^10.14|^11.47|^12.42|^13.0
spatie/flare-client-php Version ^3.6
spatie/laravel-error-share Version ^1.0.3
symfony/console Version ^6.4|^7.2.1|^8.0
symfony/var-dumper Version ^6.4|^7.2.3|^8.0