EasyWeChat在laravel框架中的使用技巧

laravel框架实战：
EasyWeChat

文章目录

• • EasyWeChat公众号配置
  • • 报错:Failed to cache access token.
    • 获取公众号临时二维码
    • 公众号模板消息推送(推送字体带颜色)
    • 公众号服务端的使用
    • • 在微信开发中主要是负责接收用户发送过来的消息，还有用户触发的一系列事件
      • $message['MsgType'] 详解
      • MsgType Event 事件类型详解
  • EasyWeChat小程序配置
  • • 小程序报错：Identifier "subscribe_message" is not defined.
    • 小程序订阅消息推送
    • 根据 jsCode 获取用户 session 信息
    • 微信小程序消息解密
  • 持续更新中~~~~~

EasyWeChat公众号配置

protected $wechat;

public function __construct ()
{
    $this->wechat = app('wechat.official_account');  //微信公众号配置
}

报错:Failed to cache access token.

报错:Failed to cache access token.的原因大部分是：token缓存文件没写成功。

在使用wechat方法的上面加入以下代码:

 $this->wechat->cache = new CacheBridge(app('cache.store'));

获取公众号临时二维码

$res = $this->wechat->qrcode->temporary('WXiangQian', 6 * 24 * 3600);

公众号模板消息推送(推送字体带颜色)

$this->wechat->template_message->send([
    'touser' => $this->message['FromUserName'],
    'template_id' => 'template_id',// 模板消息id
    'url' => 'https://wxiangqian.github.io/', // 要跳转的url
    'data' => [
        "first" => "欢迎来到本公众号",
        "keyword1" => '你好，WXiangQian', // 必须为keyword
        "keyword2" => "欢迎来到本公众号",
        "keyword3" => "恭喜你成功入坑",
        "remark" =>  ['value' => '小提示：期待您的持续关注', 'color' => '#F00'],  // 带颜色的备注
    ]
]);

公众号服务端的使用

在微信开发中主要是负责接收用户发送过来的消息，还有用户触发的一系列事件

$app->server->push(function ($message) {
    // $message['FromUserName'] // 用户的 openid
    // $message['MsgType'] // 消息类型：event, text....
    return "您好！欢迎使用 EasyWeChat";
});

// 在 laravel 中：
$response = $app->server->serve();

// $response 为 `Symfony\Component\HttpFoundation\Response` 实例
// 对于需要直接输出响应的框架，或者原生 PHP 环境下
$response->send();

// 而 laravel 中直接返回即可：

return $response;

$message['MsgType’] 详解

$app->server->push(function ($message) {
    switch ($message['MsgType']) {
        case 'event':
            return '收到事件消息';
            break;
        case 'text':
            return '收到文字消息';
            break;
        case 'image':
            return '收到图片消息';
            break;
        case 'voice':
            return '收到语音消息';
            break;
        case 'video':
            return '收到视频消息';
            break;
        case 'location':
            return '收到坐标消息';
            break;
        case 'link':
            return '收到链接消息';
            break;
        case 'file':
            return '收到文件消息';
        // ... 其它消息
        default:
            return '收到其它消息';
            break;
    }

    // ...
});

MsgType Event 事件类型详解

扫描带参数的二维码事件

EventKey 事件KEY值，比如：qrscene_123123，qrscene_为前缀，后面为二维码的参数值
Ticket 二维码的 ticket，可用来换取二维码图片

// （如：subscribe(订阅)、unsubscribe(取消订阅) ...， CLICK 等）
if($message['MsgType'] == 'event') {  //收到事件消息
    switch ($message['Event']) {
        case 'CLICK':          //点击事件
            break;
        case 'subscribe':      //订阅
            $event_info = substr($this->message['EventKey'], 8);
            $event_arr = explode('_', $event_info);
            if (!empty($event_arr) && $event_arr[0] == 'test') 
                // test逻辑
            }else{
                // 关注公众号逻辑
                return $this->subscribe($event_arr);
            }
            break;
        case 'unsubscribe':    //取消订阅
            return $this->unSubscribe();
            break;
        case 'SCAN':           //已关注的情况下扫描二维码
            $this->scan();
            break;
    }
}

EasyWeChat小程序配置

    $this->config = [
        'app_id' => 'app_id',
        'secret' => 'secret',
        'response_type' => 'array',
        'log' => [
            'level' => 'debug',
         // 'file' => __DIR__.'/wechat.log',
        ],
    ];

    $this->app = Factory::miniProgram($this->config);

小程序报错：Identifier “subscribe_message” is not defined.

报错的原因是当前的laravel-wechat版本过低，需要更新，小程序订阅消息是后续新增的功能，所以说低版本用不了订阅消息。小程序的模板消息已停用，后续都会接入订阅消息。

小程序订阅消息推送

$send_data = [
    'template_id' => 'template_id', // 所需下发的订阅模板id
    'touser' => 'openid',     // 接收者（用户）的 openid
    'page' => '/pages/index,       // 点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转。
    'data' => [         
    // 模板内容，格式形如 { "key1": { "value": any }, "key2": { "value": any } }
        'thing2' => [
            'value' => '课程标题',
        ],
        'character_string6' => [
            'value' => '1/1',
        ],
        'thing7' => [
            'value' => '恭喜你已成功解锁这个课程',
        ],
    ],
];
// 非线上环境
if (env('APP_ENV') != 'production') {
    $send_data['miniprogramState'] = 'developer';
}
$this->app->subscribe_message->send($send_data);

根据 jsCode 获取用户 session 信息

    $code = $this->request->input('code');
    // 返回openid
    $data = $this->app->auth->session($code);
    $openid = $data['openid'];

微信小程序消息解密

    $session = $this->request->input('session');
    $iv = $this->request->input('iv');
    $encryptedData = $this->request->input('encryptedData');
    $decrypted = AES::decrypt(
     base64_decode($encryptedData, false), base64_decode($session, false), base64_decode($iv, false)
    );
    $decrypted = json_decode($decrypted, true);

持续更新中~~~~~