streak/streak

, _(*1)

Streak PHP - Event Sourcing Framework

, _(*2)

Streak is a PHP framework designed for building applications using the Event Sourcing pattern. It provides a robust foundation for creating event-sourced, domain-driven applications with a focus on flexibility and testability., _(*3)

Features

• Event Sourcing - Persistent event store with support for various storage backends
• Command Handling - Type-safe command processing with built-in validation
• Subscriptions - Reliable event delivery system with support for resuming, restarting, and pausing
• Projections - Tools for building read models optimized for querying
• Saga & Process Management - Support for long-running business processes across multiple aggregates

Installation

Install via Composer:, _(*4)

composer require streak/streak

For Symfony integration, install the Streak Bundle:, _(*5)

composer require streak/streak-bundle

Documentation

Comprehensive documentation is available in the docs directory:, _(*6)

• Core Concepts
• Getting Started
• Tutorials
• Symfony Integration

Development

Requirements

• PHP 8.0+
• Docker and Docker Compose

Running locally

Clone the repository:, _(*7)

git clone https://github.com/streakphp/streak.git
cd streak

Start the development environment:, _(*8)

docker-compose up --detach --build

Running tests and checks

# Validate composer.json
docker compose run --rm --no-deps php composer validate --strict --no-interaction --ansi

# Install dependencies
docker compose run --rm --no-deps php composer install --no-scripts --no-interaction --ansi

# Run tests with coverage
docker compose run --rm --no-deps php xphp -dxdebug.mode=coverage bin/phpunit --color=always --configuration=phpunit.xml.dist

# Run tests without coverage
docker compose run --rm --no-deps php bin/phpunit

# Check code quality
docker compose run --rm --no-deps php bin/rector --dry-run --ansi
docker compose run --rm --no-deps php bin/deptrac --no-interaction --cache-file=./build/.deptrac/.deptrac.cache --ansi
docker compose run --rm --no-deps php bin/php-cs-fixer fix --diff --dry-run --ansi --config=.php-cs-fixer.dist.php

License

Streak is open-sourced software licensed under the MIT license., _(*9)