Ecotone 框架使用教程

Ecotone 框架使用教程

ecotone Ecotone shifts the focus to the business code. In order to make it happen, enables Message-Driven Architecture with DDD, CQRS, Event Sourcing in PHP. 项目地址: https://gitcode.com/gh_mirrors/ec/ecotone

1、项目介绍

Ecotone 是一个基于 PHP 的服务总线框架，旨在通过消息驱动架构（Message-Driven Architecture）实现领域驱动设计（DDD）、命令查询职责分离（CQRS）和事件溯源（Event Sourcing）。Ecotone 框架的核心理念是将业务代码置于开发的核心位置，通过消息传递机制将各个组件、模块和服务连接起来，同时保持每个区域的边界清晰。

Ecotone 框架的名称来源于生态学中的“生态过渡带”（Ecotone），象征着框架在不同系统之间的过渡和连接作用。Ecotone 支持与 Symfony 和 Laravel 框架集成，适用于构建复杂的企业级应用。

2、项目快速启动

安装 Ecotone 框架

首先，确保你已经安装了 Composer，然后通过以下命令安装 Ecotone 框架：

composer require ecotone/ecotone

创建一个简单的命令处理器

创建一个命令类 CreateUserCommand：

namespace App\Command;

class CreateUserCommand
{
    private $name;

    public function __construct(string $name)
    {
        $this->name = $name;
    }

    public function getName(): string
    {
        return $this->name;
    }
}

创建一个命令处理器 CreateUserHandler：

namespace App\Handler;

use App\Command\CreateUserCommand;

class CreateUserHandler
{
    public function handle(CreateUserCommand $command): void
    {
        echo "User created: " . $command->getName();
    }
}

配置 Ecotone 服务总线

在配置文件中注册命令处理器：

use Ecotone\Modelling\Attribute\CommandHandler;
use App\Command\CreateUserCommand;
use App\Handler\CreateUserHandler;

class Application
{
    #[CommandHandler]
    public function createUser(CreateUserCommand $command): void
    {
        $handler = new CreateUserHandler();
        $handler->handle($command);
    }
}

发送命令

在应用中发送命令：

use Ecotone\Lite\EcotoneLiteApplication;
use App\Command\CreateUserCommand;

$application = EcotoneLiteApplication::bootstrap([__DIR__]);

$application->getCommandBus()->send(new CreateUserCommand("John Doe"));

3、应用案例和最佳实践

应用案例

Ecotone 框架适用于构建复杂的企业级应用，特别是在需要处理大量业务逻辑和数据交互的场景中。例如，在一个电子商务平台中，可以使用 Ecotone 来处理订单创建、支付处理、库存管理等业务流程。

最佳实践

1. 领域驱动设计（DDD）：使用 Ecotone 框架时，建议遵循领域驱动设计的原则，将业务逻辑封装在领域模型中，并通过命令和事件进行交互。
2. CQRS 模式：Ecotone 支持 CQRS 模式，可以将命令和查询分离，提高系统的可维护性和性能。
3. 事件溯源：通过事件溯源，可以记录系统中的所有状态变化，便于审计和故障恢复。

4、典型生态项目

Symfony 集成

Ecotone 框架可以与 Symfony 框架无缝集成，通过 Symfony 的依赖注入容器来管理服务总线的配置和依赖。

Laravel 集成

Ecotone 也支持与 Laravel 框架集成，通过 Laravel 的服务容器来管理命令和事件的处理。

其他生态项目

Ecotone 还支持与其他 PHP 生态项目集成，如 Doctrine ORM、RabbitMQ 等，进一步扩展其功能和应用场景。

通过以上步骤，你可以快速上手 Ecotone 框架，并将其应用于实际项目中。

ecotone Ecotone shifts the focus to the business code. In order to make it happen, enables Message-Driven Architecture with DDD, CQRS, Event Sourcing in PHP. 项目地址: https://gitcode.com/gh_mirrors/ec/ecotone