PHPackages                             spooled-cloud/spooled - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Queues & Workers](/categories/queues)
4. /
5. spooled-cloud/spooled

ActiveLibrary[Queues & Workers](/categories/queues)

spooled-cloud/spooled
=====================

Official PHP SDK for Spooled Cloud job queue service

v1.0.7(4mo ago)20Apache-2.0PHPPHP ^8.2CI passing

Since Dec 18Pushed 4mo agoCompare

[ Source](https://github.com/Spooled-Cloud/spooled-sdk-php)[ Packagist](https://packagist.org/packages/spooled-cloud/spooled)[ Docs](https://spooled.cloud)[ RSS](/packages/spooled-cloud-spooled/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (11)Versions (9)Used By (0)

Spooled PHP SDK
===============

[](#spooled-php-sdk)

Official PHP SDK for [Spooled Cloud](https://spooled.cloud) - a modern job queue service for distributed applications.

[**Live Demo (SpriteForge)**](https://example.spooled.cloud) • [Documentation](https://spooled.cloud/docs)

[![Latest Version on Packagist](https://camo.githubusercontent.com/621f85e704ff823d23f7d2d9639d0cbf5ec8afe1eab004fef9b562e6fdb57820/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73706f6f6c65642d636c6f75642f73706f6f6c65642e737667)](https://packagist.org/packages/spooled-cloud/spooled)[![PHP Version](https://camo.githubusercontent.com/962aced9b09d89716dbebf186ff899754a096ff1068b6b7988675c2d9fab9331/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e322d626c75652e737667)](https://www.php.net/)[![License](https://camo.githubusercontent.com/a8cb6955fb6e825727774da32760c729c43dcde6b3f19232539089af14348deb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4170616368652d2d322e302d677265656e2e737667)](LICENSE)[![CI](https://github.com/spooled-cloud/spooled-sdk-php/actions/workflows/ci.yml/badge.svg)](https://github.com/spooled-cloud/spooled-sdk-php/actions/workflows/ci.yml)

Features
--------

[](#features)

- **Full REST API support** - Jobs, queues, workers, schedules, workflows, webhooks, and more
- **Worker runtime** - Process jobs with concurrency control, heartbeats, and graceful shutdown
- **Realtime events** - SSE and WebSocket clients for live job/queue events
- **Optional gRPC transport** - High-performance binary protocol when extensions are available
- **Retry & circuit breaker** - Built-in resilience with exponential backoff and circuit breaker
- **Type-safe** - Full PHP 8.2+ type hints and readonly DTOs
- **PSR-compliant** - Works with any PSR-compatible HTTP client and logger
- **Framework agnostic** - Use with Laravel, Symfony, or vanilla PHP
- **Webhook ingestion** - Validate and process GitHub, Stripe, and custom webhooks
- **Dead Letter Queue (DLQ)** - Manage and retry failed jobs
- **Billing integration** - Stripe-powered subscription management
- **Automatic case conversion** - Between camelCase (PHP) and snake\_case (API)

Requirements
------------

[](#requirements)

- PHP 8.2 or higher
- Composer
- `ext-json` (usually bundled)

### Optional Extensions

[](#optional-extensions)

- `ext-grpc` + `ext-protobuf` - For gRPC transport support
- WebSocket library (e.g., `ratchet/pawl`) - For WebSocket realtime support

Installation
------------

[](#installation)

```
composer require spooled-cloud/spooled
```

### With gRPC Support

[](#with-grpc-support)

```
# Install PHP extensions first
pecl install grpc protobuf

# Then require gRPC packages
composer require grpc/grpc google/protobuf
```

Quick Start
-----------

[](#quick-start)

```