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) |
| Symfony | 6.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
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.yamlcon la referencia actual de la Configuración y fusione las claves nuevas. - Entornos: verifique que
environmentssigue correspondiendo a los lugares donde desea el reporte activo (una lista vacía significa todos los entornos, incluidodev). - Handler de logs: si transmite logs, verifique que el handler
monitorsigue adjunto a Monolog y quemonolog/monolog^3.0está instalado. - Lista de enmascaramiento: definir
scrubreemplaza los valores por defecto: compruebe de nuevo que su lista sigue incluyendo todas las claves que desea enmascarar.
Desinstalar el 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.