Introducción
quiet-guard/monitor-php es el núcleo PHP agnóstico sobre el que se apoyan todos los clientes Quiet Guard. No tiene ninguna dependencia de framework, únicamente interfaces PSR (psr/log) y las extensiones ext-sodium / ext-curl, y puede por tanto integrarse allí donde PHP se ejecute.
El núcleo es un pequeño conjunto de piezas con responsabilidad única, basadas en PSR. Todo es PHP simple bajo el espacio de nombres QuietGuard\Monitor\, sin contenedor de servicios, sin fachadas y sin archivos de configuración:
| Clase | Rol |
|---|---|
Config | Objeto de valor inmutable: URL del servidor, clave del proyecto, timeout, release, entornos, límite de traza, patrones de enmascarado de valores. |
Reporter | Envía los payloads de excepciones, logs y dependencias a la API de ingesta. El envío nunca lanza excepciones. |
Payload\ExceptionPayloadBuilder | Transforma un Throwable en un payload de ingesta neutro. |
Support\Scrubber | Enmascara los valores sensibles por clave antes de cualquier envío. |
Support\ValueRedactor | Enmascara los valores por su forma (correos, IBAN, tarjetas, números de seguridad social y de teléfono franceses) estén donde estén. Activo por defecto. |
Http\HttpClient (interfaz) + Http\CurlHttpClient | Transporte intercambiable; se incluye una implementación cURL sin dependencias. |
ErrorHandler | Conecta los handlers globales de errores/excepciones/apagado de PHP para los hosts PHP simples. |
Backup\BackupCipher | Primitivas de cifrado híbrido en flujo para la bóveda de copias de seguridad de conocimiento cero. |
La lógica de reutilización
Este paquete es la base compartida, no un producto autónomo. El SDK de Laravel (quiet-guard/laravel-monitor), el bundle de Symfony (quiet-guard/monitor-symfony-bundle) y el plugin de WordPress (quiet-guard/monitor-wordpress) dependen todos de él y lo adaptan a su host: conectan los hooks de excepciones y de logs del framework a un Reporter, leen la configuración en un Config, y reutilizan el mismo Scrubber y el mismo BackupCipher. Como todos hablan el mismo protocolo, un parque PHP heterogéneo termina en un único dashboard de Quiet Guard.
Si integra Quiet Guard en una aplicación PHP a medida o en su propio framework, este paquete es el que debe usar directamente. Los payloads que produce están documentados por la API de ingesta (/docs/tool/1.0/ingestion-api).
Para ir más lejos
- Instalación: requisitos y
composer require. - Configuración: el objeto de valor
Config. - Reportar excepciones: cablear un
Reportera mano. - Handler de errores global: capturar los errores en una aplicación PHP simple.
- Enmascaramiento de datos sensibles: retirar los secretos antes del envío.
- Cifrado de las copias de seguridad: las primitivas de copia de seguridad de conocimiento cero.
Está leyendo la documentación PHP Core v1.0.