workers

Skill: Workers — Cola de Trabajos en FacturaScripts

Los workers permiten ejecutar procesos en segundo plano al final de cada ejecución de página. Se usan para tareas no críticas que no necesitan ejecutarse en el momento exacto de la acción (por ejemplo, actualizar contadores, enviar notificaciones, sincronizar datos).

La cola de trabajos se compone de eventos y workers:

• Los eventos se lanzan automáticamente cuando se crea, modifica o elimina un registro.
• Los workers son clases PHP que escuchan esos eventos y ejecutan la lógica necesaria.

Atajo con fsmaker

Para generar automáticamente la clase Worker y registrarla en Init.php:

fsmaker worker

---

Eventos de los modelos

Todos los modelos lanzan automáticamente eventos al operar sobre ellos:

Acción	Eventos lanzados
Insertar	Model.NombreModelo.Insert, Model.NombreModelo.Save
Modificar	Model.NombreModelo.Update, Model.NombreModelo.Save
Eliminar	Model.NombreModelo.Delete

Ejemplos:

• Model.Producto.Insert — al insertar un producto
• Model.Cliente.Update — al modificar un cliente
• Model.FacturaCliente.Delete — al eliminar una factura

---

Lanzar eventos personalizados

use FacturaScripts\Core\Model\WorkEvent;
use FacturaScripts\Core\WorkQueue;

// lanzar un evento inmediatamente
WorkQueue::send('mi-evento', 'valor-identificador');

// lanzar un evento con parámetros adicionales
WorkQueue::send('mi-evento', $modelo->id(), $modelo->toArray());

// lanzar un evento para ejecutarse en el futuro (en segundos)
WorkQueue::sendFuture(300, 'mi-evento', 'valor'); // en 5 minutos

---

Estructura básica de un Worker

Los workers se crean en la carpeta Worker/ del plugin:

<?php
namespace FacturaScripts\Plugins\MiPlugin\Worker;

use FacturaScripts\Core\Model\WorkEvent;
use FacturaScripts\Core\Template\WorkerClass;

class MiWorker extends WorkerClass
{
    public function run(WorkEvent $event): bool
    {
        // tu código aquí

        return $this->done();
    }
}