Uso del Archivo Cron.php en FacturaScripts

Para que tu plugin ejecute tareas periódicas, puedes utilizar el archivo Cron.php de tu plugin. El cron de FacturaScripts gestionará todos los procesos cron de los plugins activos, siempre y cuando haya sido configurado correctamente en el sistema o hosting. Si necesitas ejecutar algo de forma periódica, el mejor lugar para hacerlo es el cron de tu plugin.

Ejemplo de Cron.php

A continuación, se muestra un ejemplo de un cron para el plugin MiPlugin:

<?php
namespace FacturaScripts\Plugins\MiPlugin;

use FacturaScripts\Core\Template\CronClass;

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

Todo lo que se coloque en la función run() se ejecutará cada vez que se active el cron. Por ejemplo, si configuras el cron para que se ejecute cada minuto, la función run() se ejecutará cada minuto. Para controlar cuándo debe ejecutarse un trabajo, puedes asignarle un nombre y definir la frecuencia con la que se debe ejecutar.

Ejecutar un Trabajo Cada Hora

En este ejemplo, crearemos un trabajo llamado mi-trabajo. Al llamar a la función job(), indicaremos que se realice cada hora con la función every() y finalmente pondremos el código a ejecutar en la función run().

<?php
namespace FacturaScripts\Plugins\MiPlugin;

use FacturaScripts\Core\Template\CronClass;

class Cron extends CronClass
{
    public function run(): void
    {
        $this->job('mi-trabajo')
            ->every('1 hour')
            ->run(function () {
                // tu código aquí
                // esto se ejecutará cada hora
            });
    }
}

Si queremos que el trabajo se ejecute cada 6 horas, simplemente indicaríamos '6 hours' como parámetro en la función every(). Si deseamos que se ejecute cada 10 días, pondríamos '10 days'.

Ejecutar Cada Día a una Hora Concreta

Para ejecutar un trabajo cada día a una hora específica, podemos utilizar la función everyDayAt():

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

Si el cron no se ha ejecutado a las 8, por ejemplo porque el servidor estaba apagado, cuando se vuelva a ejecutar a las 10, este trabajo se ejecutaría a las 10, ya que no se comprobó a las 8. Para hacer una comprobación más estricta, podemos establecer el segundo parámetro de la función en true.

$this->job('mi-trabajo')
    ->everyDayAt(8, true)
    ->run(function () {
        // tu código aquí
        // esto se ejecutará solo a las 8h
    });

Ejecutar Cada Lunes, Martes, etc.

Para ejecutar un trabajo un día específico de la semana, como el lunes, se puede usar la función correspondiente:

$this->job('mi-trabajo')
    ->everyMondayAt(8)
    ->run(function () {
        // tu código aquí
        // esto se ejecutará cada lunes a las 8h
    });

everyMondayAt(): Ejecutar cada lunes.
everyTuesdayAt(): Ejecutar cada martes.
everyWednesdayAt(): Ejecutar cada miércoles.
everyThursdayAt(): Ejecutar cada jueves.
everyFridayAt(): Ejecutar cada viernes.
everySaturdayAt(): Ejecutar cada sábado.
everySundayAt(): Ejecutar cada domingo.

Ejecutar un Día Concreto de Cada Mes

Para ejecutar un día específico de cada mes, podemos usar la función everyDay():

$this->job('mi-trabajo')
    ->everyDay(15, 7)
    ->run(function () {
        // tu código aquí
        // esto se ejecutará cada día 15 a las 7h
    });

Ejecutar el Último Día del Mes

Para ejecutar un trabajo el último día de cada mes, se puede usar la función everyLastDayOfMonthAt():

$this->job('mi-trabajo')
    ->everyLastDayOfMonthAt(8)
    ->run(function () {
        // tu código aquí
        // esto se ejecutará el último día de cada mes, a las 8h
    });

Evitar Solapamiento

Puedes ejecutar el cron de FacturaScripts tantas veces como desees. Si se ejecuta en paralelo, cada hilo procesará un trabajo distinto. Sin embargo, si necesitas que un trabajo se ejecute de forma exclusiva, puedes utilizar el método withoutOverlapping() para impedir que este trabajo se ejecute mientras otros estén en progreso.

$this->job('mi-trabajo')
    ->everyDayAt(8)
    ->withoutOverlapping()
    ->run(function () {
        // tu código aquí
        // esto se ejecutará cada día a las 8h y no podrá ejecutarse al mismo tiempo que otro trabajo
    });

Si deseas evitar que un trabajo se ejecute al mismo tiempo que un trabajo específico, por ejemplo, si trabajo2 no debe ejecutarse simultáneamente con trabajo3, pero puede superponerse con trabajo1, simplemente pasa el nombre del trabajo como parámetro al método withoutOverlapping().

$this->job('trabajo2')
    ->everyDayAt(8)
    ->withoutOverlapping('trabajo3')
    ->run(function () {
        // tu código aquí
        // esto se ejecutará cada día a las 8h y no podrá ejecutarse junto a trabajo3
    });

Para evitar que se ejecute simultáneamente con trabajo3 o trabajo4, simplemente indícalo como parámetros:

$this->job('trabajo2')
    ->everyDayAt(8)
    ->withoutOverlapping('trabajo3', 'trabajo4')
    ->run(function () {
        // tu código aquí
        // esto se ejecutará cada día a las 8h y no podrá ejecutarse junto a trabajo3 o trabajo4
    });

Limitaciones

Si hay una tarea que se ejecuta cada minuto y otra que se ejecuta menos frecuentemente y sin solapamiento, puede ocurrir que la segunda nunca llegue a ejecutarse, ya que siempre coincidirá cuando la primera esté en ejecución.
Si planeas que una tarea se ejecute todos los días a las 23h, y el cron se ejecuta a las 23:59, puede ser posible que nunca se ejecute.

Anterior Siguiente

Pregunta al chatbot