README

此库添加了对创建活动的支持，然后作为webhooks触发这些活动的订阅者。

安装

使用 Composer 在您的项目中安装此包

composer require eoneopay/webhooks

使用

在需要创建活动的应用程序中注入 \EoneoPay\Webhooks\Activities\Interface\ActivityFactoryInterface 服务。此接口上的发送方法接受一个 ActivityDataInterface 实现的实例，代表要创建的特定活动。

对于您将在应用程序中触发的每个不同活动，您需要创建一个实现 ActivityDataInterface 的类。

工作原理

• ActivityFactoryInterface 接收一个 ActivityDataInterface 的实例
  • 工厂将调用 PayloadManager 来为 ActivityDataInterface 构建有效载荷
  • 工厂将有效载荷和 ActivityDataInterface 保存为新的 ActivityInterface 实体。
  • 最后，工厂将触发 ActivityCreatedEvent
• 监听器将在异步队列工作程序内接收事件并调用 WebhookManager#processActivity
  • WebhookManager 将解析活动的任何订阅
  • 然后为每个订阅创建一个新的 WebhookRequest
  • 并触发新的 WebhookRequestCreatedEvent。
• 另一个监听器将接收此事件并调用 RequestProcessor#process
  • 这将构建一个 PSR7 请求
  • 发送请求
  • 将结果记录为 WebhookResponse

集成

Laravel

要将此包集成到您的 Laravel 或 Lumen，您需要注册以下服务提供商

\EoneoPay\Webhooks\Bridge\Laravel\Providers\WebhookServiceProvider
\EoneoPay\Webhooks\Bridge\Laravel\Providers\WebhookEventServiceProvider

此库的任何实现都需要

• 实现并绑定一个服务以实现接口 EoneoPay\Webhooks\Subscription\Interfaces\SubscriptionResolverInterface
• 实现一个服务以实现接口 EoneoPay\Webhooks\Payload\Interfaces\PayloadBuilderInterface
  • 示例

  interface WebHookPayloadBuilderInterface extends PayloadBuilderInterface
  { ... }
  
  final class PayloadBuilder implements WebHookPayloadBuilderInterface
  { ... }
  

  • 绑定并标记服务以实现接口 YourNamespace\WebHookPayloadBuilderInterface

  $this->app->bind(WebHookPayloadBuilderInterface::class, PayloadBuilder::class);
  $this->app->tag([WebHookPayloadBuilderInterface::class], ['webhooks_payload_builders']);
  

• 将 EoneoPay\Externals\Bridge\Laravel\ORM\ResolveTargetEntityExtension 添加到 config/doctrine.php 中的 extensions 键下
• 修改 config/doctrine.php 以添加以下配置更改

<?php
declare(strict_types=1);

use EoneoPay\Externals\Bridge\LaravelDoctrine\Extensions\ResolveTargetEntityExtension;
use EoneoPay\Webhooks\Models\ActivityInterface;
use EoneoPay\Webhooks\Models\WebhookRequestInterface;
use EoneoPay\Webhooks\Models\WebhookResponseInterface;
use EoneoPay\Webhooks\Bridge\Doctrine\Entities\Activity;
use EoneoPay\Webhooks\Bridge\Doctrine\Entities\Lifecycle\Request;
use EoneoPay\Webhooks\Bridge\Doctrine\Entities\Lifecycle\Response;

return [
    'managers' => [
        'default' => [
            // ...
            'namespaces' => [
                // ...
                // Add the Webhooks Entities to the namespace mappings
                'Eoneopay\\Webhooks\\Bridge\\Doctrine\\Entities'
            ],
            'paths' => [
                // ...
                // Add the Webhooks filepath to the Entity Manager
                \base_path('vendor/eoneopay/webhooks/src/Bridge/Doctrine/Entities')
            ]
            // ...
        ]
    ],
    
    // ...
    
    'extensions' => [
        // ...
        // Add the ResolveTargetEntityExtension to Doctrine
        ResolveTargetEntityExtension::class
    ],
    
    // ...
    
    'replacements' => [
        // Add replacements so Doctrine can look up entities by interface
        ActivityInterface::class => Activity::class,
        WebhookRequestInterface::class => Request::class,
        WebhookResponseInterface::class => Response::class
    ]
];