edgecron / edgecron-php

v1.0.1 2026-07-02 06:36 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.9

Requires (Dev)

• phpunit/phpunit: ^11.5

MIT

• EdgeCron Team

Published on Packagist.org on 2026-07-02 10:19 UTC

README

Official PHP SDK for the EdgeCron webhook scheduling and callback delivery platform.

Schedule delayed HTTP requests, deliver webhooks reliably, and automatically retry failed calls — with full execution history so nothing gets lost.

中文文档：README.zh-CN.md

Install

composer require edgecron/edgecron-php

Quick Start

<?php

use EdgeCron\EdgeCron;
use EdgeCron\APIError;

$client = new EdgeCron('ak_xxx', 'sk_xxx');

try {
    $schedule = $client->schedules->create('my-schedule', '*/5 * * * *');
    var_dump($schedule->id);
} catch (APIError $error) {
    var_dump($error->codeValue, $error->getMessage(), $error->requestId);
}

Modules

Client method	Description
$client->schedules->*	Cron schedule CRUD, pause, resume
$client->tasks->*	Task execution instances, cancel
$client->events->*	Event publishing and management
$client->endpoints->*	Webhook endpoint configuration
$client->deliveries->*	Delivery attempt records and retry
$client->retries->*	Retry policies and jobs
$client->subscription->*	Quota, usage, and resource limits

Configuration

• base_url — override API base URL
• timeout — HTTP client timeout in seconds
• http_client — custom Guzzle Client

Error Handling

Service-side business errors throw APIError.

<?php

use EdgeCron\APIError;

try {
    $client->schedules->get(123);
} catch (APIError $error) {
    var_dump($error->codeValue, $error->getMessage(), $error->requestId);
}

Security Notice

This is a server-side SDK. Do not expose secret in browsers or mobile apps.