如何使用laravel+easywechat开发微信公众号
在laravel中使用easywechat
1.安装包文件:(如果使用更高版本,请查看easywechat文档)
- composer require "overtrue/laravel-wechat:~3.0"
注册ServiceProvider:在config下的app.php中的 providers 数组中添加:
- Overtrue\LaravelWechat\ServiceProvider::class,
创建配置文件:在命令行中执行
- php artisan vendor:publish --provider="Overtrue\LaravelWechat\ServiceProvider"
如果执行该命令后显示已发布但是在config中找不到配置文件的话,看一下 config/app.php
- providers数组中是否有
如果有的话将其先注释掉,重新执行上面发布服务的命令,即可生成配置文件 config/wechat.php,如果需要使用到 laravel\thinker的话,生成配置文件以后,将刚刚注释的还原
(关于laravel\thinker 详情请查看 http://laravelacademy.org/post/4935.html)
然后修改config/wechat.php中对应的参数
- 'app_id' => env('WECHAT_APPID', ''), // AppID
- 'secret' => env('WECHAT_SECRET', ''), // AppSecret
- 'token' => env('WECHAT_TOKEN', ''), // Token
- 'aes_key' => env('WECHAT_AES_KEY', ''),
- 'log' => [
- 'level' => env('WECHAT_LOG_LEVEL', 'debug'),
- 'file' => env('WECHAT_LOG_FILE', storage_path('logs/wechat.log')),
- ],
- 'oauth' => [
- 'only_wechat_browser' => false,
- 'scopes' => ['snsapi_userinfo'],
- 'callback' => '',
- ],
- //如果使用微信自带的中间件,callback可以不填,如果是自己使用重定向完成的授权的话,这个callback就是回调的地址
- 如果在进行微信授权的时候,报scopes参数错误,则可能是scopes这个配置错误了,(注意看清楚自己是公众平台还是开放平台)
然后在控制器中定义一个路由 Route::any('/wechat','WechatController@serve');
注意:在laravel中需要token验证,所以有两种方法:
1》在将csrf验证关闭(不安全,不推荐) 详情:http://www.cnblogs.com/HD/p/4555369.html
2》我们在项目中使用:
在中间件VerifyCsrfToken.php中修改内容为:
- protected function tokensMatch($request)
- {
- // If request is an ajax request, then check to see if token matches token provider in
- // the header. This way, we can use CSRF protection in ajax requests also.
- $token = $request->ajax() ? $request->header('X-CSRF-TOKEN') : $request->input('_token');
- return $request->session()->token() == $token;
- }
- public function handle($request,\Closure $next){
- //todo:需要在添加了登录验证之后,取消
- if($request->method() == 'POST')
- {
- return $next($request);
- }
- return parent::handle($request,$next);
- }
然后在vue中的bootstrap.js中的引入axios中添加
- window.axios.defaults.headers.common = {
- 'X-CSRF-TOKEN': document.querySelector('meta[name="X-CSRF-TOKEN"]').content,
- 'X-Requested-With': 'XMLHttpRequest'
- };
- 在index.blade.php中添加
- <meta name="X-CSRF-TOKEN" content="{{csrf_token()}}">
- 关于laravel 的 csrf token的更多详情,请看:http://www.cnblogs.com/zhuchenglin/p/7723997.html
- ,下面继续说微信授权的
然后创建控制器 WechatController:
- <?php
namespace App\Http\Controllers;
use Log;
class WechatController extends Controller
{
/**
* 处理微信的请求消息
*
* @return string
*/
public function serve()
{
Log::info('request arrived.'); # 注意:Log 为 Laravel 组件,所以它记的日志去 Laravel 日志看,而不是 EasyWeChat 日志
$wechat = app('wechat');
$wechat->server->setMessageHandler(function($message){
return "欢迎关注 overtrue!";
});
Log::info('return response.');
return $wechat->server->serve();
}
}
然后将这个代码上传到云服务器(注:服务器一定要在公网中(或通过某种工具使自己的电脑映射到公网上),否则微信无法验证)
默认配置好虚拟主机,(必须用80端口),指向:项目名/public
然后打开微信公众号后台(我用测试账号来说明问题,如果是真正的服务号的话,要开启开发者模式)
2.在公众号后台修改配置信息
例:
填写的url要能找到你那个控制器中的serve()方法
Token要和上面的配置文件中填写的一样
如果按照上面的步骤一步一步来的话,应该可以保存成功(即初步验证成功)
下面有一个js接口,下面填上你的已经经过备案的域名,这样你就能在你域名指向的服务器中使用微信的jssdk
这样,配置基本上就完成了,下面就可以进行微信开发了。
下面正式进行微信公众平台开发:
将上面的serve()改成类似下面的:
- public function serve()
- {
- Log::info('request arrived.');
- $app = app('wechat');
- $app->server->setMessageHandler(function($message) use ($app){
- if ($message->MsgType=='event') {
- $user_openid = $message->FromUserName;
- if ($message->Event=='subscribe') {
- //下面是你点击关注时,进行的操作
- $user_info['unionid'] = $message->ToUserName;
- $user_info['openid'] = $user_openid;
- $userService = $app->user;
- $user = $userService->get($user_info['openid']);
- $user_info['subscribe_time'] = $user['subscribe_time'];
- $user_info['nickname'] = $user['nickname'];
- $user_info['avatar'] = $user['headimgurl'];
- $user_info['sex'] = $user['sex'];
- $user_info['province'] = $user['province'];
- $user_info['city'] = $user['city'];
- $user_info['country'] = $user['country'];
- $user_info['is_subscribe'] = 1;
- if (WxStudent::weixin_attention($user_info)) {
- return '欢迎关注';
- }else{
- return '您的信息由于某种原因没有保存,请重新关注';
- }
- }else if ($message->Event=='unsubscribe') {
- //取消关注时执行的操作,(注意下面返回的信息用户不会收到,因为你已经取消关注,但别的操作还是会执行的<如:取消关注的时候,要把记录该用户从记录微信用户信息的表中删掉>)
- if (WxStudent::weixin_cancel_attention($user_openid)) {
- return '已取消关注';
- }
- }
- }
- });
- Log::info('return response.');
- return $app->server->serve();
- }
这时,更新服务器上的代码后,应该达到,你关注该公众号的时候,会提示你欢迎关注…………
注:
微信公众号的菜单设置:
- /**
- * 添加菜单
- */
- // public function menu_add(){
- // $app = app('wechat');
- // $menu = $app->menu;
- // $buttons = [
- // [
- // "type"=>"view",
- // "name"=>"进入课堂",
- // "url"=>BASE_URL."/wx_student#/main"
- // ],
- // ];
- // $menu->add($buttons);
- // }
- /**
- * 删除菜单
- */
- // public function menu_destroy(){
- // $app = app('wechat');
- // $menu = $app->menu;
- // $menu->destroy();
- // }
- /**
- * 查看微信公众号当前的菜单
- */
- public function menu_current(){
- $app = app('wechat');
- $menu = $app->menu;
- $menus = $menu->all();
- var_dump($menus);
- }
- 这个具体文档上面都有,将这些方法加到一个控制器中,注册路由,上传到云服务器上,然后使用浏览器访问一下这些方法,就会出相应的结果
微信网页授权:
注:使用微信网页授权之前,一定要检查一下你所使用的微信公众号是否有网页授权接口的权限
在laravel版的easywechat中自带一个微信授权的中间件,使用非常简单
只需要在配置文件将有关授权的配置填写完整,然后在laravel
中注册一下
然后在 路由中使用该中间件(注:使用web中间件是为了防止出现session不共享的情况)
例:
就可以在session中获取授权用户的信息
例:这是一个关于检测登录的中间件
- public function handle($request,Closure $next, $guard = null)
- {
- if (empty(session("id"))){
- $user = session('wechat.oauth_user');
- $openid = $user['id'];
- //检测数据库中用户账号和微信号是否绑定
- $result = WxStudent::check_boundwechat($openid);
- if ($result=='200'){
- return $next($request);
- }else{
- return response("请登录", 403)->header("X-CSRF-TOKEN", csrf_token());
- }
- } else if(!empty(session("id"))) {
- return $next($request);
- }
- }
注:如果报redirect_uri错误,这时候极有可能是网页授权的链接没有更改成现在需要授权的网址,这时候只需要去公众号后台改一下要授权的网址即可
例:
这样授权部分的就介绍完了,下面来说一下微信公众号向已关注的用户推送模板消息
模板消息
ps:要先看一下微信公众号是否支持模板消息接口,然后要先把该模板消息的摸板添加到你的微信公众号上(通过公众号后台),然后要知道你要使用模板消息的模板id
如:$template_id = 'XQ3uJilYd5elz-TUHzkvKF4-nfB6Yu3WBm0B45dRtbY';
- 示例:
- $app = app('wechat');
- $notice = $app->notice;
- $template_id = 'XQ3uJilYd5elz-TUHzkvKF4-nfB6Yu3WBm0B45dRtbY'; //消息模板的id
$url = BASE_URL.'/wx_student#/bulletininfo/'.$course_id.'/'.$bu_id; //点击模板消息的跳转的地址
//循环给多个用户发送消息
// foreach ($users as $user){
// if ($user['openid']!=""&&$user['openid']!='0'&&!empty($user['openid'])){
// $open_id = $user['openid'];
// 注:不同的模板,$data的内容可能不太一样,具体要看你微信公众号后台所使用的模板,上面都有示例的
// $data = array(
// "first"=>$user['name']."同学你好,你的".$course_nam.'课教师'.$create_name.'发布了一个新的班级公告',
// "keyword1"=>'',
// "keyword2"=>'',
// "remark"=>'请及时查看班级公告',
// );
// $notice->uses($template_id)->withUrl($url)->andData($data)->andReceiver($open_id)->send();
// }
// }
模板消息如果发不出去的话,你要检查一下微信公众号是否有该接口的权限,这个接口的调用次数好像是有限制
下面来说一下调用微信的扫码接口
这个是微信的jssdk
后台jssdk的域名不要填写http://
直接写就行。如ydjx.gm365.cc 要不然可能jssdk就无法调
1.先在html里面引入
<script src="http://res.wx.qq.com/open/js/jweixin-1.0.0.js" type="text/javascript" charset="utf-8"></script>
<script type="text/javascript" charset="utf-8">
wx.config(<?php echo app('wechat')->js->config(array('scanQRCode'), false) ?>);
</script>
然后在js中加上这个方法
scan_code(){
wx.scanQRCode({
needResult: 1, // 默认为0,扫描结果由微信处理,1则直接返回扫描结果,
success: function (res) {
var result = res.resultStr; // 当needResult 为 1 时,扫码返回的结果
}
});
}
然后再对你扫到的内容进行相应的处理即可。