您现在的位置是：首页> 编程文章 个人博客模板
laravel-wechat
无痕小Q个人博客
2022-08-24 22:05:11【
主页】
701人已围观
简介微信开发，第三方扩展
github地址：https://github.com/overtrue/laravel-wechat
框架要求
- 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"
配置
- 创建配置文件：
php artisan vendor:publish --provider="Overtrue\LaravelWeChat\ServiceProvider"
- 可选，添加别名
'aliases' => [
// ...
'EasyWeChat' => Overtrue\LaravelWeChat\EasyWeChat::class,
],- 每个模块基本都支持多账号，默认为
default。
使用
App\Http\Middleware\VerifyCsrfToken 排除微信相关的路由，如：
protected $except = [
// ...
'wechat',
];下面以接收普通消息为例写一个例子。
路由：
Route::any('/wechat', 'WeChatController@serve');注意：一定是
Route::any, 因为微信服务端认证的时候是GET, 接收用户消息时是POST！
然后创建控制器 WeChatController：
getServer();
$server->with(function($message){
return "欢迎关注 overtrue！";
});
return $server->serve();
}
}OAuth 中间件
使用中间件的情况下 app/config/easywechat.php 中的 oauth.callback 就随便填写吧(因为用不着了
- 在
app/Http/Kernel.php中添加路由中间件：
protected $routeMiddleware = [
// ...
'easywechat.oauth' => \Overtrue\LaravelWeChat\Middleware\OAuthAuthenticate::class,
];- 在路由中添加中间件：
//...
Route::group(['middleware' => ['web', 'easywechat.oauth']], function () {
Route::get('/user', function () {
$user = session('easywechat.oauth_user.default'); // 拿到授权用户资料
dd($user);
});
});中间件支持指定配置名称：'easywechat.oauth:default'，当然，你也可以在中间件参数指定当前的 scopes:
Route::group(['middleware' => ['easywechat.oauth:snsapi_userinfo']], function () {
// ...
});
// 或者指定账户的同时指定 scopes:
Route::group(['middleware' => ['easywechat.oauth:default,snsapi_userinfo']], function () {
// ...
});上面的路由定义了 /user 是需要微信授权的，那么在这条路由的回调 或 控制器对应的方法里， 你就可以从 session('easywechat.oauth_user.default') 拿到已经授权的用户信息了。
模拟授权
有时候我们希望在本地开发完成后线上才真实的走微信授权流程，这将减少我们的开发成本，那么你需要做以下两步：
- 准备模拟授权资料：
use Illuminate\Support\Arr;
use Overtrue\Socialite\User as SocialiteUser;
$user = new SocialiteUser([
'id' => 'mock-openid',
'name' => 'overtrue',
'nickname' => 'overtrue',
'avatar' => 'http://example.com/avatars/overtrue.png',
'email' => null,
'original' => [],
'provider' => 'WeChat',
]);以上字段在 scope 为
snsapi_userinfo时尽可能配置齐全哦，当然，如果你的模式只是snsapi_base的话只需要openid就好了。
- 将资料写入 session：
注意：一定要在调用 OAuth 中间件之前写入，比如你可以创建一个全局中间件来完成这件事儿，只在开发环境启用即可。
session(['easywechat.oauth_user.default' => $user]); // 同理，`default` 可以更换为您对应的其它配置名
事件
你可以监听相应的事件，并对事件发生后执行相应的操作。
- OAuth 网页授权：
Overtrue\LaravelWeChat\Events\WeChatUserAuthorized
// 该事件有以下属性
$event->user; // 同 session('easywechat.oauth_user.default') 一样
$event->isNewSession; // 是不是新的会话（第一次创建 session 时为 true）
$event->account; // 当前中间件所使用的账号，对应在配置文件中的配置项名称开放平台支持
您可以适用内置的 Overtrue\LaravelWeChat\Traits\HandleOpenPlatformServerEvents 来快速完成开放平台的服务端验证工作：
routes/web.php:
Route::any('/open-platform/server', OpenPlatformController::class);app/Http/Controllers/OpenPlatformController.php:
handleServerEvents($app);
}
}开发文档：https://easywechat.com/
阅读量！ (701)
点击排行
应怜屐齿印苍苔，小扣柴扉久不开。 春色满园关不住，一枝红杏出墙来。
网站公告
- 欢迎来到我的博客
1：欢迎来到我的博客
2：博客免费api接口现已上线
3：博客会定期更新文章
4：欢迎大家来捧场
站点信息
生活是一位睿智的长者，生活是一位博学的老师，它常常春风化雨，润物无声地为我们指点迷津，给我们人生的启迪。
- 建站时间：2019-8-30
- 网站程序：php,laravel-swoole框架
- 今日流量：71（10分钟统计一次）
- 本月流量：9412
- 浏览总量：388339
- 统计方式：中间件，redis消息队列，定时任务
