cron

Skill: Cron — Tareas Periódicas en FacturaScripts

El sistema de cron de FacturaScripts permite ejecutar tareas periódicas en los plugins. Cada plugin puede tener su propio archivo Cron.php que hereda de CronClass. El cron del sistema gestionará automáticamente todos los procesos cron de los plugins activos.

Requisito previo

El cron del sistema debe estar configurado correctamente en el servidor o hosting para que se ejecute periódicamente (por ejemplo, cada minuto).

Atajo con fsmaker

Para generar automáticamente el archivo Cron.php y añadir un nuevo CronJob:

# Crear el archivo Cron.php base del plugin
fsmaker cron

# Crear un nuevo CronJob y registrarlo en Cron.php
fsmaker cronjob

---

Estructura básica de Cron.php

<?php
namespace FacturaScripts\Plugins\MiPlugin;

use FacturaScripts\Core\Template\CronClass;

class Cron extends CronClass
{
    public function run(): void
    {
        // tu código aquí
    }
}

Todo el código dentro de run() se ejecutará cada vez que se active el cron. Para controlar la frecuencia de ejecución de trabajos individuales, se usa el método job().

---

Frecuencias de ejecución

Cada X horas o días

public function run(): void
{
    // ejecutar cada hora
    $this->job('mi-trabajo')
        ->every('1 hour')
        ->run(function () {
            // código a ejecutar cada hora
        });

    // ejecutar cada 6 horas
    $this->job('otro-trabajo')
        ->every('6 hours')
        ->run(function () {
            // código a ejecutar cada 6 horas
        });

    // ejecutar cada 10 días
    $this->job('trabajo-dias')
        ->every('10 days')
        ->run(function () {
            // código a ejecutar cada 10 días
        });
}

Cada día a una hora concreta

$this->job('mi-trabajo')
    ->everyDayAt(8)
    ->run(function () {
        // se ejecutará cada día a las 8h
    });

Si necesitas una comprobación más estricta (solo ejecutar exactamente a esa hora, sin recuperar ejecuciones perdidas):