Actualización

Versionado

quiet-guard/monitor-symfony-bundle sigue el versionado semántico. Las versiones de corrección y las menores son retrocompatibles; los cambios incompatibles se reservan para las versiones mayores y se anuncian aquí.

El bundle depende del núcleo agnóstico quiet-guard/monitor-php, que se actualiza de forma conjunta. Composer resuelve ambos a la vez.

Compatibilidad

Compatible
PHP^8.2 (8.2, 8.3, 8.4)
Symfony6.4 (LTS), 7.x, 8.x
quiet-guard/monitor-php^0.2
monolog/monolog^3.0 (solo para el envío de logs)

Los componentes Symfony que requiere el bundle, symfony/config, symfony/dependency-injection, symfony/event-dispatcher y symfony/http-kernel, están restringidos a ^6.4|^7.0|^8.0.

La API de ingesta con la que dialoga el bundle (/api/v1/...) es agnóstica de plataforma y se versiona de forma independiente del paquete: un bundle reciente sigue funcionando por tanto con un servidor de la misma versión mayor de API.

Cómo actualizar

bash
composer update quiet-guard/monitor-symfony-bundle

Como la configuración es declarativa y se controla mediante el entorno, la mayoría de las actualizaciones no requieren ningún cambio de código, las nuevas opciones llegan con valores por defecto seguros y son opt-in.

Puntos a verificar después de una actualización

  • Árbol de configuración: compare su config/packages/monitor.yaml con la referencia actual de la Configuración y fusione las claves nuevas.
  • Entornos: verifique que environments sigue correspondiendo a los lugares donde desea el reporte activo (una lista vacía significa todos los entornos, incluido dev).
  • Handler de logs: si transmite logs, verifique que el handler monitor sigue adjunto a Monolog y que monolog/monolog ^3.0 está instalado.
  • Lista de enmascaramiento: definir scrub reemplaza los valores por defecto: compruebe de nuevo que su lista sigue incluyendo todas las claves que desea enmascarar.

Desinstalar el bundle

bash
composer remove quiet-guard/monitor-symfony-bundle

Retire después la entrada del bundle en config/bundles.php (si la había registrado manualmente), elimine config/packages/monitor.yaml, quite cualquier handler monitor de su configuración de Monolog y elimine las variables MONITOR_* de su .env.

Está leyendo la documentación Symfony Bundle v1.0.