$definition) { $existing = ScheduledJobRepository::findByKey($jobKey); $job = self::buildDefaultJob($definition, $jobKey, $nowUtc); if (!$existing) { ScheduledJobRepository::create($job); continue; } $normalized = self::normalizeStoredJob($existing, $definition); if (!self::jobsDiffer($existing, $normalized)) { continue; } ScheduledJobRepository::updateJobMeta((int) $existing['id'], $normalized); } } public static function listPaged(array $filters): array { self::ensureSystemJobs(); return ScheduledJobRepository::listPaged($filters); } public static function find(int $id): ?array { self::ensureSystemJobs(); return ScheduledJobRepository::find($id); } public static function updateFromAdmin(int $id, array $input): array { $job = self::find($id); if (!$job) { return ['ok' => false, 'errors' => [t('Scheduled job not found')]]; } $definition = ScheduledJobRegistry::get((string) ($job['job_key'] ?? '')); if (!$definition) { return ['ok' => false, 'errors' => [t('Scheduled job is not registered')]]; } $form = [ 'enabled' => isset($input['enabled']) ? 1 : 0, 'timezone' => ScheduleCalculator::normalizeTimezone((string) ($input['timezone'] ?? ($job['timezone'] ?? ''))), 'schedule_type' => ScheduleCalculator::normalizeScheduleType((string) ($input['schedule_type'] ?? ($job['schedule_type'] ?? 'daily'))), 'schedule_interval' => (int) ($input['schedule_interval'] ?? ($job['schedule_interval'] ?? 1)), 'schedule_time' => ScheduleCalculator::normalizeTime((string) ($input['schedule_time'] ?? ($job['schedule_time'] ?? ''))), 'schedule_weekdays_csv' => ScheduleCalculator::normalizeWeekdaysCsv( array_key_exists('schedule_weekdays', $input) ? $input['schedule_weekdays'] : ($job['schedule_weekdays_csv'] ?? '') ), 'catchup_once' => isset($input['catchup_once']) ? 1 : 0, ]; $errors = self::validateForm($form, $definition); if ($errors) { return ['ok' => false, 'errors' => $errors, 'form' => $form, 'job' => $job]; } $nextRunAt = null; if ((int) $form['enabled'] === 1) { $nextRun = ScheduleCalculator::calculateNextRunUtc($form, new \DateTimeImmutable('now', new \DateTimeZone('UTC'))); $nextRunAt = $nextRun ? $nextRun->format('Y-m-d H:i:s') : null; } $updated = ScheduledJobRepository::updateJobMeta((int) $job['id'], [ 'label' => (string) ($definition['label'] ?? (string) ($job['label'] ?? '')), 'description' => (string) ($definition['description'] ?? (string) ($job['description'] ?? '')), 'enabled' => (int) $form['enabled'], 'timezone' => (string) $form['timezone'], 'schedule_type' => (string) $form['schedule_type'], 'schedule_interval' => (int) $form['schedule_interval'], 'schedule_time' => $form['schedule_time'], 'schedule_weekdays_csv' => $form['schedule_weekdays_csv'], 'catchup_once' => (int) $form['catchup_once'], 'next_run_at' => $nextRunAt, ]); if (!$updated) { return ['ok' => false, 'errors' => [t('Scheduled job could not be saved')], 'form' => $form, 'job' => $job]; } $fresh = self::find((int) $job['id']); return ['ok' => true, 'job' => $fresh, 'form' => $form]; } public static function listRunsByJobId(int $jobId, array $filters): array { return ScheduledJobRunRepository::listPagedByJobId($jobId, $filters); } public static function purgeRunsExpired(): int { return ScheduledJobRunRepository::purgeOlderThanDays(self::RUN_RETENTION_DAYS); } public static function scheduleSummary(array $job): string { $type = ScheduleCalculator::normalizeScheduleType((string) ($job['schedule_type'] ?? 'daily')); $interval = (int) ($job['schedule_interval'] ?? 1); $time = (string) ($job['schedule_time'] ?? ''); if ($type === 'hourly') { return sprintf(t('Every %d hour(s)'), max(1, $interval)); } if ($type === 'daily') { return sprintf(t('Every %d day(s) at %s'), max(1, $interval), $time !== '' ? $time : '--:--'); } $weekdays = ScheduleCalculator::parseWeekdays((string) ($job['schedule_weekdays_csv'] ?? '')); $labels = []; foreach ($weekdays as $day) { $labels[] = self::weekdayLabel($day); } $weekdayText = $labels ? implode(', ', $labels) : t('No weekdays'); return sprintf( t('Every %d week(s) on %s at %s'), max(1, $interval), $weekdayText, $time !== '' ? $time : '--:--' ); } public static function weekdaysFromCsv(?string $csv): array { return ScheduleCalculator::parseWeekdays((string) ($csv ?? '')); } private static function validateForm(array $form, array $definition): array { $errors = []; $allowedTypes = $definition['allowed_schedule_types'] ?? ['hourly', 'daily', 'weekly']; $type = (string) ($form['schedule_type'] ?? 'daily'); if (!in_array($type, $allowedTypes, true)) { $errors[] = t('Schedule type is invalid'); return $errors; } $interval = (int) ($form['schedule_interval'] ?? 0); if ($type === 'hourly' && ($interval < 1 || $interval > 24)) { $errors[] = t('Hourly interval must be between 1 and 24'); } elseif ($type === 'daily' && ($interval < 1 || $interval > 365)) { $errors[] = t('Daily interval must be between 1 and 365'); } elseif ($type === 'weekly' && ($interval < 1 || $interval > 52)) { $errors[] = t('Weekly interval must be between 1 and 52'); } $timezone = trim((string) ($form['timezone'] ?? '')); try { new \DateTimeZone($timezone); } catch (\Throwable $exception) { $errors[] = t('Timezone is invalid'); } if (in_array($type, ['daily', 'weekly'], true) && $form['schedule_time'] === null) { $errors[] = t('Schedule time is required'); } if ($type === 'weekly') { $weekdays = ScheduleCalculator::parseWeekdays((string) ($form['schedule_weekdays_csv'] ?? '')); if (!$weekdays) { $errors[] = t('At least one weekday is required for weekly schedule'); } } return $errors; } private static function buildDefaultJob(array $definition, string $jobKey, \DateTimeImmutable $nowUtc): array { $type = (string) ($definition['default_schedule_type'] ?? 'daily'); $job = [ 'job_key' => $jobKey, 'label' => (string) ($definition['label'] ?? $jobKey), 'description' => (string) ($definition['description'] ?? ''), 'enabled' => (int) ($definition['default_enabled'] ?? 1), 'timezone' => ScheduleCalculator::normalizeTimezone((string) ($definition['default_timezone'] ?? '')), 'schedule_type' => ScheduleCalculator::normalizeScheduleType($type), 'schedule_interval' => ScheduleCalculator::normalizeInterval($type, (int) ($definition['default_schedule_interval'] ?? 1)), 'schedule_time' => ScheduleCalculator::normalizeTime((string) ($definition['default_schedule_time'] ?? '')), 'schedule_weekdays_csv' => ScheduleCalculator::normalizeWeekdaysCsv($definition['default_schedule_weekdays_csv'] ?? null), 'catchup_once' => (int) ($definition['default_catchup_once'] ?? 1), 'next_run_at' => null, ]; if ((int) $job['enabled'] === 1) { $nextRun = ScheduleCalculator::calculateNextRunUtc($job, $nowUtc); $job['next_run_at'] = $nextRun ? $nextRun->format('Y-m-d H:i:s') : null; } return $job; } private static function normalizeStoredJob(array $existing, array $definition): array { $type = ScheduleCalculator::normalizeScheduleType((string) ($existing['schedule_type'] ?? ($definition['default_schedule_type'] ?? 'daily'))); $normalized = [ 'label' => (string) ($definition['label'] ?? (string) ($existing['label'] ?? '')), 'description' => (string) ($definition['description'] ?? (string) ($existing['description'] ?? '')), 'enabled' => (int) ($existing['enabled'] ?? ($definition['default_enabled'] ?? 1)), 'timezone' => ScheduleCalculator::normalizeTimezone((string) ($existing['timezone'] ?? ($definition['default_timezone'] ?? ''))), 'schedule_type' => $type, 'schedule_interval' => ScheduleCalculator::normalizeInterval($type, (int) ($existing['schedule_interval'] ?? ($definition['default_schedule_interval'] ?? 1))), 'schedule_time' => ScheduleCalculator::normalizeTime((string) ($existing['schedule_time'] ?? ($definition['default_schedule_time'] ?? ''))), 'schedule_weekdays_csv' => ScheduleCalculator::normalizeWeekdaysCsv( (string) ($existing['schedule_weekdays_csv'] ?? ($definition['default_schedule_weekdays_csv'] ?? '')) ), 'catchup_once' => (int) ($existing['catchup_once'] ?? ($definition['default_catchup_once'] ?? 1)), 'next_run_at' => (string) ($existing['next_run_at'] ?? ''), ]; if ($normalized['next_run_at'] === '' && (int) $normalized['enabled'] === 1) { $nextRun = ScheduleCalculator::calculateNextRunUtc($normalized, new \DateTimeImmutable('now', new \DateTimeZone('UTC'))); $normalized['next_run_at'] = $nextRun ? $nextRun->format('Y-m-d H:i:s') : null; } else { $normalized['next_run_at'] = $normalized['next_run_at'] !== '' ? $normalized['next_run_at'] : null; } return $normalized; } private static function jobsDiffer(array $existing, array $normalized): bool { $keys = [ 'label', 'description', 'enabled', 'timezone', 'schedule_type', 'schedule_interval', 'schedule_time', 'schedule_weekdays_csv', 'catchup_once', 'next_run_at', ]; foreach ($keys as $key) { $a = (string) ($existing[$key] ?? ''); $b = (string) ($normalized[$key] ?? ''); if ($a !== $b) { return true; } } return false; } private static function weekdayLabel(int $weekday): string { return match ($weekday) { 1 => t('Mon'), 2 => t('Tue'), 3 => t('Wed'), 4 => t('Thu'), 5 => t('Fri'), 6 => t('Sat'), 7 => t('Sun'), default => '-', }; } }