推荐使用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框架为例，演示如何接入支付宝手机网站支付。
立即学习“PHP免费学习笔记（深入）”；
步骤1：安装SDK通过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);}
调用该方法后，用户将跳转到支付宝支付页面。
Sylius开源电子商务平台下载Sylius开源电子商务平台是一个开源的 PHP 电子商务网站框架，基于 Symfony 和 Doctrine 构建，为用户量身定制解决方案。可管理任意复杂的产品和分类，每个产品可以设置不同的税率，支持多种配送方法，集成 Omnipay 在线支付。功能特点：前后端分离Sylius 带有一个强大的 REST API，可以自定义并与您选择的前端或您的微服务架构很好地配合使用。如果您是 Symfony
步骤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也可以轻松集成微信支付。
1. 安装SDKcomposer require yansongda/pay2. 创建支付服务类
新建
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://www.php.cn/link/b8986492278e5864d6b7107734bcbcdf', '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 ''; } catch (\Exception $e) { return ' SUCCESS OK '; } } FAIL '.$e->getMessage().' 安全与最佳实践
集成支付时需注意以下几点：
- 敏感信息（如密钥）应放在环境变量中，避免提交到代码仓库。
- 所有回调必须验证签名，防止伪造请求。
- 支付成功后应通过查询接口二次确认订单状态，避免依赖前端返回。
- 记录完整的日志，便于排查问题。
- 使用HTTPS确保通信安全。
基本上就这些。只要配置正确，调用清晰，无论是Laravel还是ThinkPHP，集成第三方支付并不复杂，关键是处理好回调和异常情况。Yansongda/pay这类通用SDK大大降低了接入门槛，推荐优先使用。
