jardisport/workflow

Workflow orchestration for PHP - Multi-step process execution with configurable transitions

Maintainers

Details

github.com/jardisPort/workflow

Homepage

Source

Issues

Installs: 22

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

pkg:composer/jardisport/workflow

1.0.0 2026-02-25 17:29 UTC

Requires

  • php: >=8.2

Requires (Dev)

MIT 75ec3b9fb4509990ae00818f0da30d2153be1bd8

  • Jardis Development <jardisDev.woop@headgent.com>

workflowdomaindddinterfacesHeadgentJardisPort

This package is auto-updated.

Last update: 2026-02-25 17:31:21 UTC

README

Build Status License: MIT PHP Version PHPStan Level PSR-4 PSR-12

Interface library for workflow orchestration in PHP 8.2+ applications. Provides strictly typed interfaces for multi-step process execution with configurable transitions and conditional branching.

Zero dependencies - can be used standalone or integrated with any framework/container.

Installation

composer require jardisport/workflow

Requirements

  • PHP >= 8.2

Architecture Overview

This library provides contracts for implementing workflow patterns with a focus on type safety and flexible transition handling.

Core Interfaces

WorkflowInterface

Executes workflows with configured nodes:

public function __invoke(
    WorkflowConfigInterface $workflowConfig,
    mixed ...$parameters  // Request, context, data - passed to each handler
): array;

Handler instantiation is an implementation detail - use a factory, container, or direct instantiation.

WorkflowConfigInterface

Configuration container for workflow nodes and their transitions:

  • addNode(string $handlerClass, array $transitions = []) - Add a workflow node
  • getNodes() - Get all configured nodes with transitions
  • getTransitions(string $handlerClass) - Get transitions for a specific handler

WorkflowBuilderInterface

Fluent API for building workflow configurations:

$config = (new WorkflowBuilder())
    ->node(PaymentHandler::class)
        ->onSuccess(ShippingHandler::class)
        ->onFail(NotifyHandler::class)
    ->node(ShippingHandler::class)
        ->onSuccess(ConfirmHandler::class)
    ->build();

WorkflowNodeBuilderInterface

Node-level transition configuration with support for:

  • onSuccess() - Handler for successful completion
  • onFail() - Handler for failure
  • onError() - Handler for errors
  • onTimeout() - Handler for timeouts
  • onRetry() - Handler for retry logic
  • onSkip() - Handler for skip conditions
  • onPending() - Handler for pending state
  • onCancel() - Handler for cancellation

WorkflowResultInterface

Explicit control over workflow transitions:

  • Status constants: STATUS_SUCCESS, STATUS_FAIL
  • Transition constants: ON_SUCCESS, ON_FAIL, ON_ERROR, ON_TIMEOUT, ON_RETRY, ON_SKIP, ON_PENDING, ON_CANCEL
  • Methods: getStatus(), getData(), getTransition(), isSuccess(), isFail(), hasExplicitTransition()

Typical Workflow Flow

$workflow($config, $request, $context, ...)
                  ↓
            Node 1: PaymentHandler($request, $context, ...) → WorkflowResult
                  ↓ (onSuccess)
            Node 2: ShippingHandler($request, $context, ...) → WorkflowResult
                  ↓ (onSuccess)
            Node 3: ConfirmHandler($request, $context, ...) → WorkflowResult
                  ↓
            Results Array

Usage Examples

Standalone (no dependencies):

$workflow = new Workflow();  // Instantiates handlers directly
$result = $workflow($config, $request);

With Factory/Container:

$workflow = new Workflow(fn($class) => $container->get($class));
$result = $workflow($config, $request);

With Domain Context:

$workflow = new Workflow(fn($class) => $boundedContext->handle($class));
$result = $workflow($config, $domainRequest);

Development

All development commands run inside Docker containers for consistent environments.

Available Commands

make install     # Install Composer dependencies
make update      # Update Composer dependencies
make autoload    # Regenerate autoload files
make phpstan     # Run PHPStan static analysis (Level 8)
make phpcs       # Run PHP_CodeSniffer (PSR-12)
make shell       # Access Docker container shell
make help        # Show all available commands

Code Quality Standards

  • PHPStan Level 8 - Maximum strictness with full type coverage
  • PSR-12 coding standard with 120-character line limit
  • Strict types required in all PHP files (declare(strict_types=1))
  • Pre-commit hooks validate branch naming and run phpcs on staged files

Branch Naming Convention

Branches must follow this pattern:

(feature|fix|hotfix)/[1-7 digits]_[alphanumeric-_]+

Example: feature/123_add-workflow-timeout

License

MIT License - see LICENSE file for details.

Support

Authors

Jardis Development