Installation

Installez le bundle dans l'application Symfony à surveiller (et non sur le serveur Quiet Guard).

Prérequis

• PHP 8.2 ou supérieur
• Symfony 6.4 (LTS), 7.x ou 8.x
• ext-curl (le transport par défaut) et ext-sodium (tirée par le cœur)

Installer le package

Le package est publié sur Packagist : un simple composer require l'installe.

composer require quiet-guard/monitor-symfony-bundle

Cela tire automatiquement le cœur agnostique quiet-guard/monitor-php.

Enregistrer le bundle

Symfony Flex enregistre un bundle à partir d'une recette publiée dans son propre index. Aucune recette n'existe pour ce bundle : ajoutez-le à la main dans config/bundles.php :

// config/bundles.php
return [
    // ...
    QuietGuard\Monitor\Symfony\MonitorBundle::class => ['all' => true],
];

La classe du bundle est QuietGuard\Monitor\Symfony\MonitorBundle, et l'alias de son extension de conteneur est monitor : toute la configuration vit donc sous une clé monitor.

Créer le fichier de configuration

Le bundle lit ses options dans une arborescence de configuration monitor. Créez config/packages/monitor.yaml :

# config/packages/monitor.yaml
monitor:
    url: '%env(MONITOR_URL)%'
    key: '%env(MONITOR_KEY)%'

Puis renseignez les variables correspondantes dans .env / .env.local :

MONITOR_URL=https://monitor.example.com
MONITOR_KEY=votre-jeton-de-projet

url et key sont les seules valeurs à fournir pour démarrer la remontée. Consultez la Configuration pour chaque option et sa valeur par défaut.

Vérifier le câblage

Une fois enregistré, le bundle définit ses services dans le conteneur. Vous pouvez confirmer leur présence :

php bin/console debug:container monitor.reporter
php bin/console debug:event-dispatcher kernel.exception

L'écouteur monitor.exception_subscriber doit apparaître sur kernel.exception. Poursuivez avec la Configuration.