PHPackages                             liqunx/lara-vue-wechat - 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. [API Development](/categories/api)
4. /
5. liqunx/lara-vue-wechat

ActiveLibrary[API Development](/categories/api)

liqunx/lara-vue-wechat
======================

微信 SDK for Laravel-Vue架构

3.1.8(9y ago)010MITPHP

Since Mar 20Pushed 9y ago1 watchersCompare

[ Source](https://github.com/liqunx/lara-vue-wechat)[ Packagist](https://packagist.org/packages/liqunx/lara-vue-wechat)[ RSS](/packages/liqunx-lara-vue-wechat/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (1)Versions (30)Used By (0)

laravel-wechat
==============

[](#laravel-wechat)

> 注意：此版本为 3.x 版本，不兼容 2.x 与 1.x，与 [overtrue/wechat 3.x](https://github.com/overtrue/wechat) 同步

微信 SDK for Laravel 5 / Lumen， 基于 [overtrue/wechat](https://github.com/overtrue/wechat)

本项目只适用于，只有一个固定的账号，如果是开发微信公众号管理系统就不要使用了，直接用 [overtrue/wechat](https://github.com/overtrue/wechat) 更方便些。

> 交流QQ群：319502940

安装
--

[](#安装)

1. 安装包文件

```
composer require "overtrue/laravel-wechat:~3.0"
```

> 如果你用了 laravel-debugbar，请禁用或者关掉，否则这模块别想正常使用！！！

> 如果你用了 laravel-debugbar，请禁用或者关掉，否则这模块别想正常使用！！！

> 如果你用了 laravel-debugbar，请禁用或者关掉，否则这模块别想正常使用！！！

配置
--

[](#配置)

### Laravel 应用

[](#laravel-应用)

1. 注册 `ServiceProvider`:

```
Overtrue\LaravelWechat\ServiceProvider::class,
```

2. 创建配置文件：

```
php artisan vendor:publish --provider="Overtrue\LaravelWechat\ServiceProvider"
```

3. 请修改应用根目录下的 `config/wechat.php` 中对应的项即可；
4. （可选）添加外观到 `config/app.php` 中的 `aliases` 部分:

```
'EasyWeChat' => Overtrue\LaravelWechat\Facade::class,
```

### Lumen 应用

[](#lumen-应用)

1. 在 `bootstrap/app.php` 中 82 行左右：

```
$app->register(Overtrue\LaravelWechat\ServiceProvider::class);
```

2. ENV 中支持以下配置：

```
WECHAT_APPID
WECHAT_SECRET
WECHAT_TOKEN
WECHAT_AES_KEY

WECHAT_LOG_LEVEL
WECHAT_LOG_FILE

WECHAT_OAUTH_SCOPES
WECHAT_OAUTH_CALLBACK

WECHAT_PAYMENT_MERCHANT_ID
WECHAT_PAYMENT_KEY
WECHAT_PAYMENT_CERT_PATH
WECHAT_PAYMENT_KEY_PATH
WECHAT_PAYMENT_DEVICE_INFO
WECHAT_PAYMENT_SUB_APP_ID
WECHAT_PAYMENT_SUB_MERCHANT_ID
WECHAT_ENABLE_MOCK
```

3. 如果你习惯使用 `config/wechat.php` 来配置的话，将 `vendor/overtrue/laravel-wechat/src/config.php` 拷贝到`app/config`目录下，并将文件名改成`wechat.php`。

使用
--

[](#使用)

### Laravel <= 5.1

[](#laravel--51)

1. Laravel 5 起默认启用了 CSRF 中间件，因为微信的消息是 POST 过来，所以会触发 CSRF 检查导致无法正确响应消息，所以请去除默认的 CSRF 中间件，改成路由中间件。可以参考我的写法：[overtrue gist:Kernel.php](https://gist.github.com/overtrue/ff6cd3a4e869fbaf6c01#file-kernel-php-L31)
2. 5.1 里的 CSRF 已经带了可忽略部分url的功能，你可以参考：

### Laravel 5.2+

[](#laravel-52)

Laravel 5.2 以后的版本默认启用了 web 中间件，意味着 CSRF 会默认打开，有两种方案：

1. 在 CSRF 中间件里排除微信相关的路由
2. 关掉 CSRF 中间件（极不推荐）

下面以接收普通消息为例写一个例子：

> 假设您的域名为 `overtrue.me` 那么请登录微信公众平台 “开发者中心” 修改 “URL（服务器配置）” 为： `http://overtrue.me/wechat`。

路由：

```
Route::any('/wechat', 'WechatController@serve');
```

> 注意：一定是 `Route::any`, 因为微信服务端认证的时候是 `GET`, 接收用户消息时是 `POST` ！

然后创建控制器 `WechatController`：

```