Task Scheduling

return [
    'jobs' => [
        [
            'name' => 'cleanup_temp_files',
            'schedule' => '0 0 * * *', // Daily at midnight
            'handler_class' => 'App\\Jobs\\CleanupTempFilesJob',
            'description' => 'Delete temporary files older than a day',
            'enabled' => true,
        ],
    ],
];

# Run all due jobs once
php glueful queue:scheduler run

# Run continuously (daemon mode)
php glueful queue:scheduler work --interval=60

*  *  *  *  *
│  │  │  │  │
│  │  │  │  └─ Day of week (0-7, Sunday = 0 or 7)
│  │  │  └──── Month (1-12)
│  │  └─────── Day of month (1-31)
│  └────────── Hour (0-23)
└───────────── Minute (0-59)

// Every minute
'schedule' => '* * * * *'

// Every 5 minutes
'schedule' => '*/5 * * * *'

// Every hour
'schedule' => '0 * * * *'

// Every hour at 30 minutes past
'schedule' => '30 * * * *'

// Daily at midnight
'schedule' => '0 0 * * *'

// Daily at 3:00 AM
'schedule' => '0 3 * * *'

// Weekdays at 9:00 AM
'schedule' => '0 9 * * 1-5'

// First day of month
'schedule' => '0 0 1 * *'

// Every Sunday at 2:00 AM
'schedule' => '0 2 * * 0'

'schedule' => '@yearly'   // 0 0 1 1 *
'schedule' => '@monthly'  // 0 0 1 * *
'schedule' => '@weekly'   // 0 0 * * 0
'schedule' => '@daily'    // 0 0 * * *
'schedule' => '@hourly'   // 0 * * * *

return [
    'jobs' => [
        [
            'name' => 'send_daily_digest',
            'schedule' => '@daily',
            'handler_class' => 'App\\Jobs\\SendDailyDigestJob',
            'parameters' => ['limit' => 500],
            'description' => 'Send daily email digest to users',
            'enabled' => env('DAILY_DIGEST_ENABLED', true),
        ],
        [
            'name' => 'generate_reports',
            'schedule' => '0 1 * * *', // 1:00 AM daily
            'handler_class' => 'App\\Jobs\\GenerateReportsJob',
            'description' => 'Generate daily analytics reports',
        ],
    ],
];

use Glueful\Scheduler\JobScheduler;

$scheduler = app($context, JobScheduler::class);

$scheduler->register('@hourly', function () use ($context) {
    // Cleanup task
}, 'hourly-cleanup');

namespace App\Jobs;

use Glueful\Queue\Job;
use Glueful\Storage\StorageManager;
use Psr\Log\LoggerInterface;

class CleanupTempFilesJob extends Job
{
    public function handle(): void
    {
        $maxAge = (int) ($this->getData()['max_age'] ?? 86400);
        $storage = app($this->context, StorageManager::class);

        foreach ($storage->listContents('temp/', true) as $item) {
            if ($item->isFile() && $item->lastModified() < time() - $maxAge) {
                $storage->delete($item->path());
            }
        }

        app($this->context, LoggerInterface::class)->info('Cleaned up temp files');
    }
}

[
    'name' => 'weekly_report',
    'schedule' => '0 9 * * 1', // Mondays at 9 AM
    'handler_class' => 'App\\Jobs\\WeeklyReportJob',
],

use Glueful\Queue\Job;

class WeeklyReportJob extends Job
{
    public function handle(): void
    {
        $since = date('Y-m-d', strtotime('-7 days'));

        $stats = [
            'users' => db($this->context)->table('users')->count(),
            'orders' => db($this->context)->table('orders')
                ->where('created_at', '>=', $since)
                ->count(),
        ];

        // ... deliver $stats (e.g. through a notification)
    }
}

# Run all due jobs
php glueful queue:scheduler run

# Force run all jobs (ignore schedule)
php glueful queue:scheduler run --force

# Dry run (show what would run)
php glueful queue:scheduler run --dry-run

# Run continuously, check every 60 seconds
php glueful queue:scheduler work --interval=60

# Stop after N passes; --watch shows a live status screen
php glueful queue:scheduler work --interval=60 --max-runs=100

* * * * * cd /path/to/app && php glueful queue:scheduler run >> /dev/null 2>&1

# List registered jobs (--output-format=table|json|plain)
php glueful queue:scheduler list

# Stats and the next upcoming jobs
php glueful queue:scheduler status

# Health check
php glueful queue:scheduler health

[program:scheduler]
command=php /path/to/app/glueful queue:scheduler work --interval=60
autostart=true
autorestart=true
user=www-data
stdout_logfile=/var/log/scheduler.log

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start scheduler

services:
  scheduler:
    image: your-app
    command: php glueful queue:scheduler work --interval=60
    restart: always

use Glueful\Queue\Job;
use Glueful\Queue\QueueManager;

// ✅ Good - delegates to the job queue
class SendDigestJob extends Job
{
    public function handle(): void
    {
        $users = db($this->context)->table('users')
            ->where('digest_enabled', true)
            ->get();

        $queue = app($this->context, QueueManager::class);
        foreach ($users as $user) {
            $queue->push(\App\Jobs\SendUserDigestJob::class, ['userUuid' => $user['uuid']]);
        }
    }
}

use Glueful\Cache\CacheStore;

// ✅ Good - safe to run multiple times
public function handle(): void
{
    $today = date('Y-m-d');
    $cache = app($this->context, CacheStore::class);

    if ($cache->has("report:generated:{$today}")) {
        return; // Already ran today
    }

    $this->generateReport();

    $cache->set("report:generated:{$today}", true, 86400);
}