Instalación - PHP

Antes de empezar, crea un proyecto en el panel de DockRay. En sus ajustes encontrarás el token del proyecto - el identificador público que forma parte de la URL de ingesta - y en la pestaña Claves de API generarás una clave privada. La clave se muestra una sola vez, al generarla: DockRay guarda únicamente su hash. Si todavía no tienes un proyecto, empieza por Primeros pasos.

Requisitos

• PHP 8.2 o posterior,
• Composer 2,
• conexiones HTTPS salientes permitidas.

El SDK es independiente del framework y es la base de todas las demás integraciones de PHP: Laravel, Symfony, Drupal, Joomla, PrestaShop y el plugin de WordPress. Si usas cualquiera de ellos, recurre al paquete específico: este artículo trata de aplicaciones sin ese puente.

Instalación

composer require dockcodes/dock-ray

Inicialización

Llama a init() tan pronto como lo permita el framework o tu bootstrap: así los errores del propio arranque también llegan al panel.

use function Dock\Ray\init;

init([
    'token' => 'TOKEN_DEL_PROYECTO',
    'private_key' => 'CLAVE_PRIVADA_DEL_PROYECTO',
    'environment' => 'production',
    'release' => '1.4.0',
]);

token y private_key toman por defecto las variables de servidor RAY_TOKEN y RAY_PRIVATE_KEY, así que un despliegue puede configurar el SDK sin tocar código:

init([
    'environment' => getenv('APP_ENV') ?: 'production',
    'release' => getenv('APP_VERSION') ?: null,
]);

Si falta cualquiera de las credenciales, el SDK queda cargado y no envía nada. Nunca lanza excepciones por estar sin configurar, y por eso init() puede llamarse sin condiciones, también en local.

Qué se captura automáticamente

Las integraciones por defecto capturan excepciones no gestionadas y errores fatales. Si tu aplicación tiene su propio manejador y quieres conservarlo, pasa 'default_integrations' => false e informa a mano.

La primera prueba

use Dock\Ray\Severity;
use function Dock\Ray\captureMessage;

captureMessage('Mensaje de control DockRay', Severity::info());

El mensaje debería aparecer en el panel, en la sección Errores del proyecto al que apunta el token.