README

分支自：https://github.com/WadeShuler/PHP-PayPal-IPN

分支自：https://github.com/Quixotix/PHP-PayPal-IPN/

从不再维护的伟大的Quixotix PayPal IPN脚本分支而来。从现在起，你应该使用这个仓库，因为我已经解决了它的问题，并使其重新焕发生机。

这个分支修复了原始仓库中已知的问题，并根据PayPal的文档和今天的标准更新了代码。

注意：SSLv3问题已修复！

已修复并开箱即用，旧的Quixotix仓库不再工作！

要求： PHP >= 5.3

适用于PHP >= 5.3的PayPal即时支付通知（IPN）类（如果你不是至少5.3版本，那么我无法帮助你！我将不支持已停止使用的版本！）

在你的PHP IPN脚本中使用IpnListener类来处理POST数据的编码、回发到PayPal以及解析来自PayPal的响应。

使用Composer安装

现在支持Composer！

Packagist: https://packagist.org.cn/packages/shane-lessard/php-paypal-ipn

composer.json

{
    "require": {
        "wadeshuler/php-paypal-ipn": "*"
    }
}


use wadeshuler\paypalipn\IpnListener;
$listener = new IpnListener();

// default options
$listener->use_sandbox = true;
$listener->use_curl = true;
$listener->follow_location = false;
$listener->timeout = 30; 
$listener->verify_ssl = true;
$listener->curl_ssl = false_; //Curl specify using SSL 6 (TLS 1.2)

if ($verified = $listener->processIpn())
{
    // handle successful ipn request
} else {
    // handle invalid ipn request
}

请参阅example\ipn.php中的示例文件。

特性

通过设置use_sandbox属性在实时和沙盒之间切换。
通过设置use_ssl属性支持安全的SSL和普通的HTTP事务（推荐使用SSL）。
通过设置use_curl属性支持cURL和fsockopen网络库（推荐使用cURL）。
验证来自PayPal服务器的HTTP "200"响应状态码。
使用getTextReport()方法获取整个IPN的详细纯文本报告，用于在电子邮件和日志中向管理员报告。
抛出各种异常，以区分代码或服务器配置中的常见错误与无效的IPN响应之间的差异。

入门指南

此代码旨在为网络开发者提供。你应该理解IPN过程的概念性工作方式，以及何时以及为什么你会使用IPN。阅读PayPal即时支付通知指南是一个很好的开始。

你还应该有一个PayPal沙盒账户，以及一个测试买家账户和一个测试卖家账户。在登录你的沙盒账户后，在“测试工具”菜单下有一个IPN模拟器，你可以用它来测试你的IPN监听器。

一旦你设置了沙盒账户，你只需创建一个PHP脚本，它将成为你的IPN监听器。在该脚本中，使用如下所示的IpnListener()类。有关更详细的示例，请参阅源代码中的example/ipn.php脚本。

<?php

require_once('vendor/autoload.php');

$listener = new \wadeshuler\paypalipn\IpnListener();
$listener->use_sandbox = true;

if ($verified = $listener->processIpn())
{
    // Valid IPN
    /*
        1. Check that $_POST['payment_status'] is "Completed"
        2. Check that $_POST['txn_id'] has not been previously processed
        3. Check that $_POST['receiver_email'] is your Primary PayPal email
        4. Check that $_POST['payment_amount'] and $_POST['payment_currency'] are correct
    */

} else {

    // Invalid IPN

}

?>

文档

尚未生成文档，但，在IpnListener.php中存在phpDocumentor风格文档字符串（注释），它们解释了重要的公共属性和方法。

我还在我的博客上写了一个更深入的IPN教程：[PayPal IPN with PHP](http://www.micahcarrick.com/paypal-ipn-with-php.html)（外部链接，无索引，无跟踪，无操作）

示例报告

以下是一个由getTextReport()方法返回的报告示例。通过扩展IpnListener()类或直接在您的ipn脚本中访问数据，您可以创建自己的报告。

--------------------------------------------------------------------------------
[09/09/2011 8:35 AM] - https://www.sandbox.paypal.com/cgi-bin/webscr (curl)
--------------------------------------------------------------------------------
HTTP/1.1 200 OK
Date: Fri, 09 Sep 2011 13:35:39 GMT
Server: Apache
X-Frame-Options: SAMEORIGIN
Set-Cookie: c9MWDuvPtT9GIMyPc3jwol1VSlO=Ch-NORlHUjlmbEm__KG9LupR4mfMfQTkx1QQ6hHDyc0RImWr88NY_ILeICENiwtVX3iw4jEnT1-1gccYjQafWrQCkDmiykNT8TeDUg7R7L0D9bQm47PTG8MafmrpyrUAxQfst0%7c_jG1ZL6CffJgwrC-stQeqni04tKaYSIZqyqhFU7tKnV520wiYOw0hwk5Ehrh3hLDvBxkpm%7cYTFdl0w0YpEqxu0D1jDTVTlEGXlmLs4wob2Glu9htpZkFV9O2aCyfQ4CvA2kLJmlI6YiXm%7c1315575340; domain=.paypal.com; path=/; Secure; HttpOnly
Set-Cookie: cookie_check=yes; expires=Mon, 06-Sep-2021 13:35:40 GMT; domain=.paypal.com; path=/; Secure; HttpOnly
Set-Cookie: navcmd=_notify-validate; domain=.paypal.com; path=/; Secure; HttpOnly
Set-Cookie: navlns=0.0; expires=Thu, 04-Sep-2031 13:35:40 GMT; domain=.paypal.com; path=/; Secure; HttpOnly
Set-Cookie: Apache=10.72.109.11.1315575339707456; path=/; expires=Sun, 01-Sep-41 13:35:39 GMT
X-Cnection: close
Transfer-Encoding: chunked
Content-Type: text/html; charset=UTF-8

VERIFIED
--------------------------------------------------------------------------------
test_ipn                 1
payment_type             instant
payment_date             06:34:51 Sep 09, 2011 PDT
payment_status           Completed
address_status           confirmed
payer_status             verified
first_name               John
last_name                Smith
payer_email              buyer@paypalsandbox.com
payer_id                 TESTBUYERID01
address_name             John Smith
address_country          United States
address_country_code     US
address_zip              95131
address_state            CA
address_city             San Jose
address_street           123, any street
business                 seller@paypalsandbox.com
receiver_email           seller@paypalsandbox.com
receiver_id              TESTSELLERID1
residence_country        US
item_name                something
item_number              AK-1234
quantity                 1
shipping                 3.04
tax                      2.02
mc_currency              USD
mc_fee                   0.44
mc_gross                 12.34
mc_gross_1               9.34
txn_type                 web_accept
txn_id                   51991334
notify_version           2.1
custom                   xyz123
charset                  windows-1252
verify_sign              Ah5rOpfPGo5g6FNg95DMPybP51J5AUEdXS1hqyRAP6WYYwaixKNDgQRR

shane-lessard / php-paypal-ipn

维护者

详情

README

使用Composer安装

特性

入门指南

文档

示例报告