# Ecotone Framework

> Ecotone is a PHP framework for building resilient, scalable, and business-oriented systems using message-driven architecture with DDD, CQRS, and Event Sourcing patterns.

Ecotone works with Symfony, Laravel, or standalone using Ecotone Lite. It provides declarative configuration using PHP attributes, requiring no framework-specific class extensions.

## Key Features

- Message-driven architecture with Commands, Events, and Queries
- Built-in resilience with automatic retries, dead letter queues, and self-healing
- Event Sourcing and Aggregates support
- Sagas and Process Managers for complex workflows
- Async processing with RabbitMQ, Kafka, SQS, Redis
- OpenTelemetry integration for distributed tracing
- Testing support with Ecotone Lite

## Documentation

- [Full Documentation](https://docs.ecotone.tech): Complete Ecotone documentation
- [Installation Guide](https://docs.ecotone.tech/install-php-service-bus): How to install Ecotone
- [Quick Start](https://docs.ecotone.tech/quick-start-php-ddd-cqrs-event-sourcing): Getting started examples
- [Tutorial](https://docs.ecotone.tech/tutorial-php-ddd-cqrs-event-sourcing): Step-by-step learning path

## Core Concepts

- [Message Bus and CQRS](https://docs.ecotone.tech/modelling/command-handling): Commands, Events, and Query handlers
- [Asynchronous Processing](https://docs.ecotone.tech/modelling/asynchronous-handling): Async message handling and scheduling
- [Event Sourcing](https://docs.ecotone.tech/modelling/event-sourcing): Event sourcing patterns
- [Business Workflows](https://docs.ecotone.tech/modelling/business-workflows): Sagas, orchestrators, and process managers
- [Testing Support](https://docs.ecotone.tech/modelling/testing-support): Testing Ecotone applications
- [Recovering and Monitoring](https://docs.ecotone.tech/modelling/recovering-tracing-and-monitoring): Tracing, dead letters, and monitoring

## Framework Integration

- [Symfony](https://docs.ecotone.tech/modules/symfony/symfony-ddd-cqrs-event-sourcing): Symfony integration
- [Laravel](https://docs.ecotone.tech/modules/laravel/laravel-ddd-cqrs-event-sourcing): Laravel integration
- [Ecotone Lite](https://docs.ecotone.tech/modules/ecotone-lite): Standalone / any framework

## Message Brokers

- [RabbitMQ](https://docs.ecotone.tech/modules/amqp-support-rabbitmq): AMQP/RabbitMQ support
- [Kafka](https://docs.ecotone.tech/modules/kafka-support): Apache Kafka support
- [Amazon SQS](https://docs.ecotone.tech/modules/amazon-sqs-support): AWS SQS support
- [Redis](https://docs.ecotone.tech/modules/redis-support): Redis streams support

## Code Repository

- [GitHub Monorepo](https://github.com/ecotoneframework/ecotone-dev): Main development repository
- [Packagist](https://packagist.org/packages/ecotone/ecotone): Composer package

## AI Integration

- [MCP Server](https://docs.ecotone.tech/~gitbook/mcp): Model Context Protocol for AI assistants
- [Install MCP in VSCode](vscode:mcp/install?%7B%22name%22%3A%22Ecotone%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.ecotone.tech%2F~gitbook%2Fmcp%22%7D): One-click VSCode MCP setup
- [llms-full.txt](https://ecotone.tech/llms-full.txt): Extended documentation for LLMs

## Recommended Reading

- [Implementing Event-Driven Architecture in PHP](https://blog.ecotone.tech/implementing-event-driven-architecture-in-php/): Smart Endpoints, Dumb Pipes approach
- [Building Workflows in PHP](https://blog.ecotone.tech/building-workflows-in-php/): Workflow handling patterns
- [Write Only Business Logic: Eliminate Boilerplate](https://blog.ecotone.tech/write-only-business-logic-eliminate-boilerplate/): Declarative configuration benefits
- [Building Blocks: Aggregates, Sagas, Event Sourcing](https://blog.ecotone.tech/building-blocks-exploring-aggregates-sagas-event-sourcing/): Domain-focused development
- [Async Failure Recovery: Queue vs Streaming Strategies](https://blog.ecotone.tech/async-failure-recovery-queue-vs-streaming-channel-strategies/): Self-healing message systems
- [Building Workflows in PHP with Ecotone](https://blog.ecotone.tech/building-workflows-in-php-with-ecotone/): Stateless and stateful workflows
- [Building Reactive Message-Driven Systems in PHP](https://blog.ecotone.tech/building-reactive-message-driven-systems-in-php): Reactive architecture patterns
- [DDD and Messaging with Laravel and Ecotone](https://blog.ecotone.tech/ddd-and-messaging-with-laravel-and-ecotone): Laravel integration guide
- [Laravel Multi-Tenant Systems with Ecotone](https://blog.ecotone.tech/laravel-multi-tenant-systems-with-ecotone): Multi-tenancy for Laravel
- [Symfony Multi-Tenant Applications with Ecotone](https://blog.ecotone.tech/symfony-multi-tenant-applications-with-ecotone): Multi-tenancy for Symfony
- [Building Resilient and Scalable Systems by Default](https://blog.ecotone.tech/building-resilient-and-scalable-systems-by-default): Resilience patterns
- [Message Channels: Zero Configuration Async Processing](https://blog.ecotone.tech/message-channels-zero-configuration-async-processing): Simplified async setup

## Optional

- [Blog](https://blog.ecotone.tech): All articles, tutorials, and best practices
- [Enterprise Features](https://ecotone.tech/pricing): Advanced enterprise capabilities
- [Workshops](https://ecotone.tech/workshops): Training and workshops
- [Discord Community](https://discord.gg/GwM2BSuXeg): Community support