PHPackages                             guanguans/yii-pay - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. guanguans/yii-pay

ActiveLibrary[Payment Processing](/categories/payments)

guanguans/yii-pay
=================

适配于 Yii 的 alipay 和 wechat 的支付扩展包

v1.2.3(3y ago)515.5k↑16.7%4MITPHPCI failing

Since Mar 19Pushed 1y ago1 watchersCompare

[ Source](https://github.com/guanguans/yii-pay)[ Packagist](https://packagist.org/packages/guanguans/yii-pay)[ Fund](https://www.guanguans.cn/images/wechat.jpeg)[ Patreon](https://www.patreon.com/guanguans)[ RSS](/packages/guanguans-yii-pay/feed)WikiDiscussions 1.x Synced 1mo ago

READMEChangelog (1)Dependencies (7)Versions (16)Used By (0)

yii-pay
=======

[](#yii-pay)

> 基于 [yansongda/pay](https://github.com/yansongda/pay) 开发的适配于 Yii 的 alipay 和 wechat 的支付扩展包。

[![](./docs/usage.png)](./docs/usage.png)

[![tests](https://github.com/guanguans/yii-pay/actions/workflows/run-tests.yml/badge.svg)](https://github.com/guanguans/yii-pay/actions/workflows/run-tests.yml)[![check & fix styling](https://github.com/guanguans/yii-pay/actions/workflows/php-cs-fixer.yml/badge.svg)](https://github.com/guanguans/yii-pay/actions/workflows/php-cs-fixer.yml)[![codecov](https://camo.githubusercontent.com/a2ae39130aca18633448b92f194977ee3f1767b264042119802efd8931ba7bbd/68747470733a2f2f636f6465636f762e696f2f67682f6775616e6775616e732f7969692d7061792f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/guanguans/yii-pay)[![Latest Stable Version](https://camo.githubusercontent.com/12024d7d34228ac4b5b95ccfb3322f79e95c561c8ec75ee894ae832c14d38d17/68747470733a2f2f706f7365722e707567782e6f72672f6775616e6775616e732f7969692d7061792f762f737461626c65)](https://packagist.org/packages/guanguans/yii-pay)[![Total Downloads](https://camo.githubusercontent.com/fc4859e6c8856478ee844c6ce2a2aaa0e288e2bbabf897c08851d17426c32dce/68747470733a2f2f706f7365722e707567782e6f72672f6775616e6775616e732f7969692d7061792f646f776e6c6f616473)](https://packagist.org/packages/guanguans/yii-pay)[![License](https://camo.githubusercontent.com/de0d51aa10619bc7de17de50fa8118db8360175db802a892ce5b80e7bda96cdd/68747470733a2f2f706f7365722e707567782e6f72672f6775616e6775616e732f7969692d7061792f6c6963656e7365)](https://packagist.org/packages/guanguans/yii-pay)

环境要求
----

[](#环境要求)

- Yii >= 2.0

安装
--

[](#安装)

```
$ composer require guanguans/yii-pay --prefer-dist -v
```

配置
--

[](#配置)

Yii2 配置文件 `config/main.php` 的 components 中添加:

```
'components' => [
	// ...
	'pay' => [
        'class' => 'Guanguans\YiiPay\Pay',
        // 'defaultDriver' => 'wechat', // 默认支付驱动[wechat, alipay] 若配置为 wechat：`Yii::$app->pay->wap();` 等效于 `Yii::$app->pay->wechat->wap();`
        'wechatOptions' => [
            'appid' => 'wxb3fxxxxxxxxxxx', // APP APPID
            'app_id' => 'wxb3fxxxxxxxxxxx', // 公众号 APPID
            'miniapp_id' => 'wxb3fxxxxxxxxxxx', // 小程序 APPID
            'mch_id' => '14577xxxx',
            'key' => 'mF2suE9sU6Mk1Cxxxxxxxxxxx',
            'notify_url' => 'http://xxxxxx.cn/notify.php',
            'cert_client' => './cert/apiclient_cert.pem', // optional，退款等情况时用到
            'cert_key' => './cert/apiclient_key.pem',// optional，退款等情况时用到
            'log' => [ // optional
                'file' => './logs/wechat.log',
                'level' => 'info', // 建议生产环境等级调整为 info，开发环境为 debug
                'type' => 'single', // optional, 可选 daily.
                'max_file' => 30, // optional, 当 type 为 daily 时有效，默认 30 天
            ],
            'http' => [ // optional
                'timeout' => 5.0,
                'connect_timeout' => 5.0,
                // 更多配置项请参考 [Guzzle](https://guzzle-cn.readthedocs.io/zh_CN/latest/request-options.html)
            ],
            // 'mode' => 'dev', // optional, dev/hk;当为 `hk` 时，为香港 gateway。
        ],
        'alipayOptions' => [
            'app_id' => '2016082000295641',
            'notify_url' => 'http://xxxxxx.cn/notify.php',
            'return_url' => 'http://xxxxxx.cn/return.php',
            'ali_public_key' => 'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuWJKrQ6SWvS6niI+4vEVZiYfjkCfLQfoFI2nCp9ZLDS42QtiL4Ccyx8scgc3nhVwmVRte8f57TFvGhvJD0upT4O5O/lRxmTjechXAorirVdAODpOu0mFfQV9y/T9o9hHnU+VmO5spoVb3umqpq6D/Pt8p25Yk852/w01VTIczrXC4QlrbOEe3sr1E9auoC7rgYjjCO6lZUIDjX/oBmNXZxhRDrYx4Yf5X7y8FRBFvygIE2FgxV4Yw+SL3QAa2m5MLcbusJpxOml9YVQfP8iSurx41PvvXUMo49JG3BDVernaCYXQCoUJv9fJwbnfZd7J5YByC+5KM4sblJTq7bXZWQIDAQAB',
            // 加密方式： **RSA2**
            'private_key' => 'MIIEpAIBAAKCAQEAs6+F2leOgOrvj9jTeDhb5q46GewOjqLBlGSs/bVL4Z3fMr3p+Q1Tux/6uogeVi/eHd84xvQdfpZ87A1SfoWnEGH5z15yorccxSOwWUI+q8gz51IWqjgZxhWKe31BxNZ+prnQpyeMBtE25fXp5nQZ/pftgePyUUvUZRcAUisswntobDQKbwx28VCXw5XB2A+lvYEvxmMv/QexYjwKK4M54j435TuC3UctZbnuynSPpOmCu45ZhEYXd4YMsGMdZE5/077ZU1aU7wx/gk07PiHImEOCDkzqsFo0Buc/knGcdOiUDvm2hn2y1XvwjyFOThsqCsQYi4JmwZdRa8kvOf57nwIDAQABAoIBAQCw5QCqln4VTrTvcW+msB1ReX57nJgsNfDLbV2dG8mLYQemBa9833DqDK6iynTLNq69y88ylose33o2TVtEccGp8Dqluv6yUAED14G6LexS43KtrXPgugAtsXE253ZDGUNwUggnN1i0MW2RcMqHdQ9ORDWvJUCeZj/AEafgPN8AyiLrZeL07jJz/uaRfAuNqkImCVIarKUX3HBCjl9TpuoMjcMhz/MsOmQ0agtCatO1eoH1sqv5Odvxb1i59c8Hvq/mGEXyRuoiDo05SE6IyXYXr84/Nf2xvVNHNQA6kTckj8shSi+HGM4mO1Y4Pbb7XcnxNkT0Inn6oJMSiy56P+CpAoGBAO1O+5FE1ZuVGuLb48cY+0lHCD+nhSBd66B5FrxgPYCkFOQWR7pWyfNDBlmO3SSooQ8TQXA25blrkDxzOAEGX57EPiipXr/hy5e+WNoukpy09rsO1TMsvC+v0FXLvZ+TIAkqfnYBgaT56ku7yZ8aFGMwdCPL7WJYAwUIcZX8wZ3dAoGBAMHWplAqhe4bfkGOEEpfs6VvEQxCqYMYVyR65K0rI1LiDZn6Ij8fdVtwMjGKFSZZTspmsqnbbuCE/VTyDzF4NpAxdm3cBtZACv1Lpu2Om+aTzhK2PI6WTDVTKAJBYegXaahBCqVbSxieR62IWtmOMjggTtAKWZ1P5LQcRwdkaB2rAoGAWnAPT318Kp7YcDx8whOzMGnxqtCc24jvk2iSUZgb2Dqv+3zCOTF6JUsV0Guxu5bISoZ8GdfSFKf5gBAo97sGFeuUBMsHYPkcLehM1FmLZk1Q+ljcx3P1A/ds3kWXLolTXCrlpvNMBSN5NwOKAyhdPK/qkvnUrfX8sJ5XK2H4J8ECgYAGIZ0HIiE0Y+g9eJnpUFelXvsCEUW9YNK4065SD/BBGedmPHRC3OLgbo8X5A9BNEf6vP7fwpIiRfKhcjqqzOuk6fueA/yvYD04v+Da2MzzoS8+hkcqF3T3pta4I4tORRdRfCUzD80zTSZlRc/h286Y2eTETd+By1onnFFe2X01mwKBgQDaxo4PBcLL2OyVT5DoXiIdTCJ8KNZL9+kV1aiBuOWxnRgkDjPngslzNa1bK+klGgJNYDbQqohKNn1HeFX3mYNfCUpuSnD2Yag53Dd/1DLO+NxzwvTu4D6DCUnMMMBVaF42ig31Bs0jI3JQZVqeeFzSET8fkoFopJf3G6UXlrIEAQ==',
            // 使用公钥证书模式，请配置下面两个参数，同时修改ali_public_key为以.crt结尾的支付宝公钥证书路径，如（./cert/alipayCertPublicKey_RSA2.crt）
            // 'app_cert_public_key' => './cert/appCertPublicKey.crt', //应用公钥证书路径
            // 'alipay_root_cert' => './cert/alipayRootCert.crt', //支付宝根证书路径
            'log' => [ // optional
                'file' => './logs/alipay.log',
                'level' => 'info', // 建议生产环境等级调整为 info，开发环境为 debug
                'type' => 'single', // optional, 可选 daily.
                'max_file' => 30, // optional, 当 type 为 daily 时有效，默认 30 天
            ],
            'http' => [ // optional
                'timeout' => 5.0,
                'connect_timeout' => 5.0,
                // 更多配置项请参考 [Guzzle](https://guzzle-cn.readthedocs.io/zh_CN/latest/request-options.html)
            ],
            // 'mode' => 'dev', // optional,设置此参数，将进入沙箱模式
        ],
    ],
	// ...
]
```

使用
--

[](#使用)

### 获取 alipay 实例

[](#获取-alipay-实例)

```
Yii::$app->pay->getAlipay();
// or
Yii::$app->pay->alipay;
```

### 支付宝使用示例，更多详细文档请参考 [yansongda/pay](https://github.com/yansongda/pay)

[](#支付宝使用示例更多详细文档请参考-yansongdapay)

```