libelulibelu/yii2-error-handler

Error handler for mongo databases

v1.0.0 2026-06-21 20:29 UTC

Requires

• php: >=8.2
• libelulibelu/yii2-common-helpers: ~1.0
• mongodb/mongodb: ^2.3
• symfony/mailer: ^7.4.12
• yiisoft/yii2: ~2.0.54
• yiisoft/yii2-mongodb: ^3.0

Requires (Dev)

• phpunit/phpunit: ^11.5 || ^12

Apache-2.0

• Johnny Garcia

• extension
• yii2

README

Error handler for mongo database

Installation

The preferred way to install this extension is through composer.

Either run

composer require --prefer-dist libelulibelu/yii2-error-handler

or add

"libelulibelu/yii2-error-handler": "~1.0.0"

to the require section of your composer.json file.

Migration

Si se quiere migrar de la version taguz91/yii2-error-handler a la nueva version libelulibelu/yii2-error-handler se debe seguir los siguientes pasos:

1. Seguir la guia de migracion para yii2-common-helpers.

2. Eliminar la version actual

composer remove taguz91/yii2-error-handler

1. Instalar la nueva version

composer require libelulibelu/yii2-error-handler

1. Se debe cambiar el namespace taguz91\ErrorHandler a Libelula\ErrorHandler en todo el proyecto.

2. Actualizar las configuraciones de la libreria, agregando las nuevas opciones:

• bdConnection nombre de la base de datos que se usara para guardar todas las excepciones.
• saveError booleano que nos indica si debemos guardar los errores en base de datos.
• showTrace booleano que nos indica si debemos mostrar le trace en la response, por defecto utiliza la constante YII_DEBUG
• saveBody booleano que nos indica si debemos guardar los datos enviados por post en la excepcion, por defecto se utiliza la constante YII_DEBUG

1. Las opciones de configuracion empresa y notificate fueron renombradas a company y notify respectivamente. Se deben actualizar en la configuracion del componente errorHandler.

2. Probamos que todo funcione de forma correcta.

Usage

Once the extension is installed, simply use it in your code by:

// confing\main.php

'components' => [
  ...,
  'errorHandler' => [
    'errorAction' => 'site/error',
    'class' => \Libelula\ErrorHandler\ErrorHandler::class,
    'loggerComponent' => '', // empty when the logger handler not exists
    'emailConfig' => 'EMAIL_ERROR_NOTIFICATION', // configuration for email
    'configClass' => '/common/models/Configuration', // debe implementar interface config
    'company' => $_GET['empresa'] ?? 'undefined',
    'bdConnection' => 'mongodb',
    'saveError' => true,
    'notify' => true,
    'showTrace' => YII_DEBUG,
    'saveBody' => YII_DEBUG,
    // This exceptions not be save into database
    // And this exceptions not send via email
    'exceptionsNotSave' => [
      \Libelula\ErrorHandler\exceptions\MessageException::class
    ],
  ],
]