推荐使用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;
<p>public function pay()
{
$order = [
'out_trade_no' => time(),
'total_amount' => '0.01',
'subject' => '测试商品',
'product_code' => 'QUICK_WAP_WAY',
];</p><pre class="brush:php;toolbar:false;">return Pay::alipay(config('services.alipay'))->wap($order);}
调用该方法后，用户将跳转到支付宝支付页面。
步骤4：处理回调
设置异步通知接收接口（notify_url）：
public function notify()
{
$pay = Pay::alipay(config('services.alipay'));
<pre class="brush:php;toolbar:false;">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/pay
2. 创建支付服务类
新建app/service/PayService.php：
use Yansongda\Pay\Pay;
<p>class PayService
{
public function wechatPay($orderId, $amount)
{
$config = [
'app_id' => 'wx_app_id',
'mch_id' => '商户号',
'key' => 'APIv3密钥',
'notify_url' => '<a href="https://www.php.cn/link/b8986492278e5864d6b7107734bcbcdf">https://www.php.cn/link/b8986492278e5864d6b7107734bcbcdf</a>',
'cert_client' => '../cert/apiclient_cert.pem',
'cert_key' => '../cert/apiclient_key.pem',
];</p><pre class="brush:php;toolbar:false;"> $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大大降低了接入门槛，推荐优先使用。
