condux/condux-laravel

Laravel integration for the Condux SDK: automatic exception reporting to a Condux relay, zero config beyond a DSN.

v0.1.2 2026-08-02 18:45 UTC

Requires

• php: >=8.1
• condux/condux: ^0.1
• illuminate/support: ^10.0 || ^11.0 || ^12.0

Apache-2.0

• Condux

• laravel
• sentry
• error-monitoring
• observability
• condux

Published on Packagist.org on 2026-08-03 07:54 UTC

README

Automatic exception reporting to a Condux relay for Laravel apps. A thin integration over the base condux/condux SDK: it registers a Condux capture on Laravel's exception handler, so every reported exception is sent in the Sentry "store" wire shape (the relay normalizes it like an official Sentry SDK). Delivery is resilient and never throws — reporting can't crash your app.

Install

composer require condux/condux-laravel

The service provider is auto-discovered. Set a DSN and you're done:

CONDUX_DSN=https://<key>@ingest.condux.ai/<projectId>

Uncaught exceptions (anything Laravel reports) now show up in Condux automatically, marked unhandled — no code changes and, unlike some SDKs, no edit to bootstrap/app.php. Without CONDUX_DSN the package stays inert, so it is safe to install ahead of configuring it.

Verify the setup:

php artisan condux:test

To capture something manually, resolve the client:

app(\Condux\Client::class)->captureMessage('cache miss storm', \Condux\Level::WARNING);

Optionally publish the config to tune the environment, release, and retries:

php artisan vendor:publish --tag=condux-config

Develop

php test/run.php

The capture logic (ClientFactory, ConduxReporting) is unit-tested against the real base SDK with a fake transport — no network, no Laravel, no composer install. The ConduxServiceProvider is thin glue over those units and is syntax-checked in CI. Zero dependencies beyond the base SDK and illuminate/support.