PHPackages                             overtrue/laravel-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. overtrue/laravel-wechat

ActiveLibrary[API Development](/categories/api)

overtrue/laravel-wechat
=======================

微信 SDK for Laravel

8.0.0(3mo ago)3.0k1.8M↓20%49920MITPHPPHP ^8.3

Since Mar 20Pushed 1mo ago103 watchersCompare

[ Source](https://github.com/overtrue/laravel-wechat)[ Packagist](https://packagist.org/packages/overtrue/laravel-wechat)[ GitHub Sponsors](https://github.com/overtrue)[ RSS](/packages/overtrue-laravel-wechat/feed)WikiDiscussions 8.x Synced 2d ago

READMEChangelog (10)Dependencies (12)Versions (83)Used By (20)

EasyWeChat for Laravel
======================

[](#easywechat-for-laravel)

微信 SDK EasyWeChat for Laravel， 基于 [w7corp/easywechat](https://github.com/w7corp/easywechat)

[![Sponsor me](https://github.com/overtrue/overtrue/raw/master/sponsor-me-button-s.svg?raw=true)](https://github.com/sponsors/overtrue)

> 7.x 起不再默认支持 Lumen。

框架要求
----

[](#框架要求)

- overtrue/laravel-wechat:^7.0 -> Laravel >= 8.0
- overtrue/laravel-wechat:^6.0 -> Laravel/Lumen >= 7.0
- overtrue/laravel-wechat:^5.1 -> Laravel/Lumen >= 5.1

安装
--

[](#安装)

```
composer require overtrue/laravel-wechat:^7.2
```

配置
--

[](#配置)

1. 创建配置文件：

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

2. 可选，添加别名

```
'aliases' => [
    // ...
    'EasyWeChat' => Overtrue\LaravelWeChat\EasyWeChat::class,
],
```

3. 每个模块基本都支持多账号，默认为 `default`。

使用
--

[](#使用)

🚨 在中间件 `App\Http\Middleware\VerifyCsrfToken` 排除微信相关的路由，如：

```
protected $except = [
    // ...
    'wechat',
];
```

对于 Laravel 11.x 可以使用`bootstrap/app.php` 中的`$middleware->validateCsrfTokens`方法:

```
->withMiddleware(function (Middleware $middleware) {
    $middleware->validateCsrfTokens(except: [
        // ...
        'wechat',
    ]);
})
```

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

路由：

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

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

然后创建控制器 `WeChatController`：

```