Download the PHP package crontinel/php without Composer

crontinel/php

Report cron and background job runs to Crontinel Cloud.

Framework-agnostic PHP core for Crontinel. Provides monitor contracts, typed data objects, alert management with deduplication, and cron expression helpers.

Quickstart

Get your API key at app.crontinel.com.

Requirements

If you use Laravel, install crontinel/laravel instead. It pulls in this package automatically and adds service providers, dashboard, Artisan commands, and event listeners.

Install crontinel/php directly when you are:

• Building an adapter for Symfony, Slim, or another framework
• Integrating Crontinel into a vanilla PHP application
• Writing a custom monitor that does not depend on Laravel

Requirements

• PHP 8.2, 8.3, or 8.4
• Composer

Compatibility

• Laravel 10, 11, and 12 — install crontinel/laravel instead, which wraps this package and adds Laravel-specific integration.
• Horizon — this package reads the same Redis keys that Horizon uses. When you install crontinel/laravel, the HorizonMonitor works out of the box with no additional configuration.
• Other frameworks — Symfony, Slim, and any PHP 8.2+ application can use the contracts and data objects directly.

Installation

What this package provides

Contracts

• MonitorInterface -- implement isHealthy(): bool to create a custom monitor
• AlertChannelInterface -- implement send(AlertEvent $event): void to deliver alerts via any transport (Slack, email, webhook, etc.)

Data objects

Immutable, readonly value objects used across the stack:

• AlertEvent -- key, title, message, level (critical / warning / info / resolved), fired timestamp
• CronStatus -- command, expression, status, last run metadata, next due time
• HorizonStatus -- Horizon supervisor state
• QueueStatus -- queue depth, failed count, oldest job age

Alert management

AlertManager handles fire/resolve lifecycle with built-in deduplication. It accepts any PSR-16 cache and any AlertChannelInterface implementation:

• Deduplicates repeated alerts for the same key (default: 5 min TTL)
• Auto-sends "resolved" notifications when an issue clears
• Logs failures via PSR-3 logger (falls back to NullLogger)

Cron expression helpers

CronExpressionHelper wraps dragonmantank/cron-expression with convenience methods:

• nextDue(string $expression) -- next scheduled run as DateTimeImmutable
• previousDue(string $expression) -- last scheduled run
• isLate(DateTimeInterface $lastRunAt, string $expression, int $graceSeconds = 120) -- whether a job has missed its window

Built-in monitors

Ready-to-use monitor implementations (all implement MonitorInterface):

• CronMonitor, HorizonMonitor, QueueMonitor

Usage example

Implement MonitorInterface to build a custom health check:

Wire up alert delivery by implementing AlertChannelInterface:

Then use AlertManager to fire and resolve alerts:

Using CronExpressionHelper

Using built-in monitors with AlertManager

Ecosystem

License

MIT. See LICENSE.

Built by Harun R Rayhan · crontinel.com