Instalación

Instale el bundle en la aplicación Symfony que desea monitorizar (y no en el servidor Quiet Guard).

Requisitos previos

• PHP 8.2 o superior
• Symfony 6.4 (LTS), 7.x u 8.x
• ext-curl (el transporte por defecto) y ext-sodium (requerida por el núcleo)

Instalar el paquete

El paquete está publicado en Packagist: basta con un composer require para instalarlo.

composer require quiet-guard/monitor-symfony-bundle

Esto descarga automáticamente el núcleo agnóstico quiet-guard/monitor-php.

Registrar el bundle

Symfony Flex registra un bundle a partir de una receta publicada en su propio índice. No existe ninguna receta para este bundle, así que añádalo manualmente en config/bundles.php:

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

La clase del bundle es QuietGuard\Monitor\Symfony\MonitorBundle, y el alias de su extensión de contenedor es monitor: toda la configuración vive por tanto bajo una clave monitor.

Crear el archivo de configuración

El bundle lee sus opciones en un árbol de configuración monitor. Cree config/packages/monitor.yaml:

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

Después defina las variables correspondientes en .env / .env.local:

MONITOR_URL=https://monitor.example.com
MONITOR_KEY=su-token-de-proyecto

url y key son los únicos valores necesarios para empezar a reportar. Consulte la Configuración para conocer cada opción y su valor por defecto.

Verificar el cableado

Una vez registrado, el bundle define sus servicios en el contenedor. Puede confirmar su presencia:

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

El listener monitor.exception_subscriber debe aparecer en kernel.exception. Continúe con la Configuración.