SDK PHP (Laravel + Symfony)

🎫 Récupère ton token

Pionne est mobile-first : tu génères ton token depuis l’app mobile Pionne.

1. Télécharge sur App Store (à venir) / Google Play (à venir)
2. Crée ton compte (30 jours gratuits, carte non requise)
3. + Nouveau projet → choisis Laravel ou Symfony → copie le pio_live_…

Le SDK Pionne pour PHP. Trois usages : standalone, Laravel (auto-detect via service provider), Symfony (event subscriber).

Tip

Disponible via Composer.

composer require pionne/pionne

Installation

composer require pionne/pionne

Auto-context

• PHP_VERSION — version PHP
• php_uname() — OS, hostname
• URL de la requête, méthode HTTP, route name
• User ID si auth (Laravel Auth::user(), Symfony Security::getUser())

Auto-breadcrumbs

• Queries DB (Laravel : via DB::listen(), Symfony : via Doctrine middleware)
• Requêtes HTTP sortantes (middleware Guzzle automatique)
• Logs Log::info() / error_log()

Frameworks

Laravel

Le service provider est auto-discover. Configure via env vars :

.env

PIONNE_TOKEN=pio_live_…
PIONNE_ENVIRONMENT=production
PIONNE_RELEASE=1.0.0

Et dans config/services.php :

'pionne' => [
    'token' => env('PIONNE_TOKEN'),
    'environment' => env('PIONNE_ENVIRONMENT', 'production'),
    'release' => env('PIONNE_RELEASE'),
    'sample_rate' => 1.0,
    'scrub_pii' => true,
],

Pour Laravel 11+, hook dans bootstrap/app.php :

use Pionne\Laravel\PionneHandler;

return Application::configure(basePath: dirname(__DIR__))
    ->withExceptions(function (Exceptions $exceptions) {
        $exceptions->report(function (Throwable $e) {
            PionneHandler::report($e);
        });
    })->create();

Pour Laravel 10 et avant, dans App\Exceptions\Handler :

use Pionne\Pionne;

public function report(Throwable $e): void
{
    Pionne::captureException($e);
    parent::report($e);
}

Les jobs de queue sont auto-instrumentés — toute exception non gérée dans un Job est capturée.

Symfony

Active le bundle dans config/bundles.php :

return [
    // ...
    Pionne\Symfony\PionneBundle::class => ['all' => true],
];

Configure dans config/packages/pionne.yaml :

pionne:
  token: '%env(PIONNE_TOKEN)%'
  environment: '%env(PIONNE_ENVIRONMENT)%'
  release: '%env(PIONNE_RELEASE)%'
  sample_rate: 1.0
  scrub_pii: true

Et dans .env :

PIONNE_TOKEN=pio_live_…
PIONNE_ENVIRONMENT=production
PIONNE_RELEASE=1.0.0

Le bundle enregistre automatiquement un EventSubscriber sur KernelEvents::EXCEPTION. Les messages Symfony Messenger sont aussi auto-instrumentés.

Standalone

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Pionne\Pionne;

Pionne::init([
    'token' => 'pio_live_…',
    'environment' => 'production',
    'release' => '1.0.0',
]);

try {
    doSomething();
} catch (\Throwable $e) {
    Pionne::captureException($e);
}

API

Pionne::init(['token' => '…', 'environment' => '…']);
Pionne::captureException($e, ['tags' => ['feature' => 'checkout']]);
Pionne::captureMessage('Cache miss', ['level' => 'warning']);
Pionne::setUser(['id' => 'user_42']);
Pionne::setTags(['region' => 'eu-west-1']);
Pionne::setEnabled(false);
Pionne::addBreadcrumb(['category' => 'db', 'message' => 'SELECT ...']);

Queue jobs

• Laravel queue : auto-instrumenté (events JobFailed)
• Symfony Messenger : auto-instrumenté (subscriber sur WorkerMessageFailedEvent)
• Custom worker : wrap manuellement

try {
    $job->handle();
} catch (\Throwable $e) {
    Pionne::captureException($e, [
        'tags' => ['job' => get_class($job)],
        'contexts' => ['job' => ['attempts' => $job->attempts()]],
    ]);
    throw $e;
}

Anti-token-theft

Le hostname (gethostname()) est auto-pinné côté serveur au premier event. Si ton token fuite et qu’il est utilisé depuis un autre serveur, les events sont rejetés.

Voir aussi

• Index des SDKs — tous les SDKs Pionne
• API Ingest — protocole HTTP brut