PHP框架集成支付接口教程与实例

推荐使用Yansongda/pay集成支付，该SDK支持多平台并兼容主流PHP框架。以Laravel接入支付宝为例，首先通过Composer安装SDK，接着在config/services.php中配置支付宝参数，包括应用ID、密钥及回调地址。然后在控制器中调用Pay::alipay()->wap()发起支付，用户跳转至支付宝完成付款。服务器通过notify_url接收异步通知，需验证签名并处理订单状态更新，返回'success'确认接收。ThinkPHP6集成微信支付时，同样安装Yansongda/pay，创建PayService类封装支付逻辑，配置商户信息与证书路径，调用scan()生成二维码链接供扫码支付。回调接口需解析微信通知数据，验证后更新订单并返回XML格式响应。安全方面应将密钥存于环境变量，确保HTTPS通信，记录日志，并通过官方查询接口二次确认支付状态，防止异常导致的数据不一致。

在现代Web开发中，很多PHP项目都需要接入第三方支付功能，比如微信支付、支付宝等。使用PHP框架集成支付接口不仅能提升开发效率，还能增强系统的可维护性。下面介绍如何在主流PHP框架中集成第三方支付，并提供实用案例。

选择合适的PHP支付SDK

直接调用支付平台的API较为复杂，推荐使用成熟的开源SDK来简化流程：

• Yansongda/pay：目前最流行的PHP通用支付库，支持支付宝、微信支付、银联等，兼容Laravel、Symfony、ThinkPHP等多种框架。
• 官方SDK：支付宝和微信也提供官方PHP SDK，但封装较原始，适合定制化需求。

推荐使用 Yansongda/pay，它提供了统一的调用方式，文档清晰，社区活跃。

Laravel中集成支付宝支付（案例）

以Laravel框架为例，演示如何接入支付宝手机网站支付。

通过Composer安装Yansongda/pay：

composer require yansongda/pay

步骤2：配置支付参数

在config/services.php中添加支付宝配置：

'alipay' => [
    'app_id' => env('ALIPAY_APP_ID'),
    'notify_url' => '/pay/alipay/notify',
    'return_url' => '/pay/alipay/return',
    'ali_public_key' => '支付宝公钥',
    'private_key' => '应用私钥',
    'log' => [
        'file' => storage_path('logs/alipay.log'),
        'level' => 'debug'
    ],
    'mode' => 'normal' // 'dev' or 'normal'
]

步骤3：发起支付请求

在控制器中创建支付方法：

use Yansongda\Pay\Pay;
public function pay()
{
$order = [
'out_trade_no' => time(),
'total_amount' => '0.01',
'subject'      => '测试商品',
'product_code' => 'QUICK_WAP_WAY',
];
return Pay::alipay(config('services.alipay'))->wap($order);
}

调用该方法后，用户将跳转到支付宝支付页面。

步骤4：处理回调

设置异步通知接收接口（notify_url）：

public function notify()
{
    $pay = Pay::alipay(config('services.alipay'));
try {
    $data = $pay->verify(); // 验证签名
    // 处理订单逻辑，如更新数据库状态
    Log::info('Alipay notify', $data->all());
} catch (\Exception $e) {
    Log::error('Alipay notify error: ' . $e->getMessage());
    return 'fail';
}

return 'success'; // 不能修改或输出其他内容
}

ThinkPHP6集成微信支付示例

ThinkPHP6也可以轻松集成微信支付。

composer require yansongda/pay

2. 创建支付服务类

新建app/service/PayService.php：

use Yansongda\Pay\Pay;
class PayService 
{
public function wechatPay($orderId, $amount)
{
$config = [
'app_id' => 'wx_app_id',
'mch_id' => '商户号',
'key' => 'APIv3密钥',
'notify_url' => 'https://yourdomain.com/notify/wechat',
'cert_client' => '../cert/apiclient_cert.pem',
'cert_key' => '../cert/apiclient_key.pem',
];
    $order = [
        'out_trade_no' => $orderId,
        'body' => '商品描述',
        'total_fee' => $amount * 100, // 单位为分
        'spbill_create_ip' => request()->ip(),
        'notify_url' => $config['notify_url'],
        'trade_type' => 'NATIVE' // 扫码支付
    ];

    $result = Pay::wechat($config)->scan($order);
    return $result->code_url; // 返回二维码链接
}
}

3. 处理微信异步通知

在回调接口中验证并处理结果：

public function wechatNotify()
{
    $pay = Pay::wechat($config);
    try {
        $handle = $pay->callback($_POST);
        // 更新订单状态
        return '<xml><return_code>SUCCESS</return_code><return_msg>OK</return_msg></xml>';
    } catch (\Exception $e) {
        return '<xml><return_code>FAIL</return_code><return_msg>'.$e->getMessage().'</return_msg></xml>';
    }
}

安全与最佳实践

集成支付时需注意以下几点：

• 敏感信息（如密钥）应放在环境变量中，避免提交到代码仓库。
• 所有回调必须验证签名，防止伪造请求。
• 支付成功后应通过查询接口二次确认订单状态，避免依赖前端返回。
• 记录完整的日志，便于排查问题。
• 使用HTTPS确保通信安全。

基本上就这些。只要配置正确，调用清晰，无论是Laravel还是ThinkPHP，集成第三方支付并不复杂，关键是处理好回调和异常情况。Yansongda/pay这类通用SDK大大降低了接入门槛，推荐优先使用。