README

PHP的PayPal IPN（即时支付通知）监听器

索引

先决条件
安装
架构
使用方法
扩展
注意

先决条件

PHP >=7.1.0
了解PayPal即时支付通知系统的工作原理（请参阅此处）

安装

composer require mike182uk/paypal-ipn-listener

架构

该包由几个组件组成，它们协同工作

Listener - 监听并处理IPN消息
Verifier - 通过PayPal验证IPN消息
Service - 与PayPal通信
Message - IPN消息的包装器
MessageFactory - 从数据源创建新的消息实例
EventDispatcher - 分派事件

监听器使用MessageFactory创建一个Message。该消息传递给Verifier，后者使用Service与PayPal通信。监听器使用EventDispatcher来分派与IPN消息验证结果相关的事件。

MessageFactory和Service组件是可替换的组件。

此包提供了2个消息工厂

Mdb\PayPal\Ipn\MessageFactory\InputStreamMessageFactory - 从php://input流创建消息
Mdb\PayPal\Ipn\MessageFactory\ArrayMessageFactory - 从传递给setData方法的数组创建消息

此包提供1个服务

Mdb\PayPal\Ipn\Service\GuzzleService - 使用Guzzle与PayPal通信

使用方法

您可以手动构建监听器对象，也可以使用监听器构建器。此包提供了2个监听器构建器

Mdb\PayPal\Ipn\ListenerBuilder\Guzzle\InputStreamListenerBuilder - 使用guzzle服务和输入流消息工厂构建监听器
Mdb\PayPal\Ipn\ListenerBuilder\Guzzle\ArrayListenerBuilder - 使用guzzle服务和数组消息工厂构建监听器

使用监听器构建器是构建监听器对象的首选方法。

使用监听器构建器

use Mdb\PayPal\Ipn\ListenerBuilder\Guzzle\InputStreamListenerBuilder as ListenerBuilder;

$listener = (new ListenerBuilder)->build();

手动构建监听器

use GuzzleHttp\Client;
use Mdb\PayPal\Ipn\InputStream;
use Mdb\PayPal\Ipn\Listener;
use Mdb\PayPal\Ipn\MessageFactory\InputStreamMessageFactory;
use Mdb\PayPal\Ipn\Service\GuzzleService;
use Mdb\PayPal\Ipn\Verifier;
use Symfony\Component\EventDispatcher\EventDispatcher;

$service = new GuzzleService(
    new Client(),
    'https://www.sandbox.paypal.com/cgi-bin/webscr'
);

$verifier = new Verifier($service);

$messageFactory = new InputStreamMessageFactory(new InputStream());

$listener = new Listener(
    $messageFactory,
    $verifier,
    new EventDispatcher()
);

手动创建监听器需要大量的管道工作。监听器构建器的任务是抽象化这些逻辑。

订阅事件

创建监听器对象后，您可以订阅它将分派的事件

use Mdb\PayPal\Ipn\Event\MessageVerifiedEvent;
use Mdb\PayPal\Ipn\Event\MessageInvalidEvent;
use Mdb\PayPal\Ipn\Event\MessageVerificationFailureEvent;

$listener->onVerified(function (MessageVerifiedEvent $event) {
   $ipnMessage = $event->getMessage();
   
   // IPN message was verified, everything is ok! Do your processing logic here...
});

$listener->onInvalid(function (MessageInvalidEvent $event) {
   $ipnMessage = $event->getMessage();
   
   // IPN message was was invalid, something is not right! Do your logging here...
});

$listener->onVerificationFailure(function (MessageVerificationFailureEvent $event) {
    $error = $event->getError();
    
    // Something bad happend when trying to communicate with PayPal! Do your logging here...
});

在订阅事件时，您可以使用任何callable

class IpnProcessor
{
    public function onVerified(MessageVerifiedEvent $event)
    {
        $message = $event->getMessage();
        
        // ...
    }
}

$listener->onVerified(array(new IpnProcessor, 'onVerified'));

class IpnProcessor
{
    public static function onVerified(MessageVerifiedEvent $event)
    {
        $message = $event->getMessage();
        
        // ...
    }
}

$listener->onVerified(array('IpnProcessor', 'onVerified'));

监听IPN消息

要启动此过程，您需要最后一步是监听IPN消息

$listener->listen();

完整示例

use Mdb\PayPal\Ipn\Event\MessageVerifiedEvent;
use Mdb\PayPal\Ipn\Event\MessageInvalidEvent;
use Mdb\PayPal\Ipn\Event\MessageVerificationFailureEvent;
use Mdb\PayPal\Ipn\ListenerBuilder\Guzzle\InputStreamListenerBuilder as ListenerBuilder;

$listener = (new ListenerBuilder)->build();

$listener->onVerified(function (MessageVerifiedEvent $event) {
   $ipnMessage = $event->getMessage();
   
   // IPN message was verified, everything is ok! Do your processing logic here...
});

$listener->onInvalid(function (MessageInvalidEvent $event) {
   $ipnMessage = $event->getMessage();
   
   // IPN message was was invalid, something is not right! Do your logging here...
});

$listener->onVerificationFailure(function (MessageVerificationFailureEvent $event) {
    $error = $event->getError();
    
    // Something bad happend when trying to communicate with PayPal! Do your logging here...
});

$listener->listen();

沙箱模式

当使用提供的监听器构建器之一时，您可以设置监听器以使用PayPal的沙箱进行测试

$listenerBuilder = new ListenerBuilder();

$listenerBuilder->useSandbox(); // use PayPal sandbox

$listener = $listenerBuilder->build();

您可以在示例目录中找到一些完整的用法示例。

扩展

要创建自己的服务，您必须实现 Mdb\PayPal\Ipn\Service。

要创建自己的消息工厂，您必须实现 Mdb\PayPal\Ipn\MessageFactory。

要创建自己的监听器构建器，最好扩展 Mdb\PayPal\Ipn\ListenerBuilder，因为这提供了创建监听器构建器所需的多数样板代码。

您会注意到，在使用任何提供的Guzzle监听器构建器时，都暴露了useSandbox方法。您可以通过使用Mdb\PayPal\Ipn\ListenerBuilder\ModeDependentServiceEndpoint特质来将此功能添加到监听器构建器中（有关使用示例，请参阅Mdb\PayPal\Ipn\ListenerBuilder\GuzzleListenerBuilder）。

注意事项

测试

PayPal提供了一个IPN模拟器，您可以在这里找到。

akamenew / paypal-ipn-listener

维护者

详细信息