Temporal integration for Spiral Framework

This package connects a Spiral application to Temporal, the open source engine for durable, fault-tolerant workflows. It configures the Temporal clients, registers your workflows and activities in RoadRunner workers and adds console commands to inspect and generate them.

Get Started

Installation

composer require spiral/temporal-bridge

Requirements:

• PHP 8.2+
• Spiral Framework 3
• RoadRunner 3 with the Temporal plugin
• Extension grpc for client calls, protobuf (recommended)

Configuration

Add the bootloader to the application's bootloader list:

protected const LOAD = [
    \Spiral\TemporalBridge\Bootloader\TemporalBridgeBootloader::class,
    // ...
];

Without an app/config/temporal.php file the bridge reads the environment:

Variable	Default	Description
TEMPORAL_ADDRESS	127.0.0.1:7233	Address of the Temporal server
TEMPORAL_CONNECTION	default	Name of the default client
TEMPORAL_TASK_QUEUE	default	Task queue of workflows without a worker

See the documentation for the config file, workers, interceptors and the temporal:info, create:workflow and create:activity commands.

Useful links

• Temporal PHP SDK and its developer guide
• Intro to Temporal: create your first workflow with the PHP SDK
• Fault tolerant workflow orchestration on PHP
• Fault tolerant workflow orchestration on PHP (rus)
• Discord