PHP

首页 -  PHP  -  laravel5微信开发扩展(laravel-wechat)

laravel5微信开发扩展(laravel-wechat)

laravel5微信扩展安装(laravel-wechat)

安装

  1. 安装包文件

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

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

配置

Laravel 应用

  1. 注册 ServiceProvider:

Overtrue\LaravelWechat\ServiceProvider::class,
  1. 创建配置文件:

php artisan vendor:publish
  1. 请修改应用根目录下的 config/wechat.php 中对应的项即可;

  2. (可选)添加外观到 config/app.php 中的 aliases 部分:

'Wechat' => Overtrue\LaravelWechat\Facade::class,

Lumen 应用

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

$app->register(Overtrue\LaravelWechat\ServiceProvider::class);
  1. 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
  1. 如果你习惯使用 config/wechat.php 来配置的话,将 vendor/overtrue/laravel-wechat/src/config.php 拷贝到app/config目录下,并将文件名改成wechat.php

使用

Laravel <= 5.1

  1. Laravel 5 起默认启用了 CSRF 中间件,因为微信的消息是 POST 过来,所以会触发 CSRF 检查导致无法正确响应消息,所以请去除默认的 CSRF 中间件,改成路由中间件。可以参考我的写法:overtrue gist:Kernel.php

  2. 5.1 里的 CSRF 已经带了可忽略部分url的功能,你可以参考:http://laravel.com/docs/master/routing#csrf-protection

Laravel 5.2

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

<?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();
    }
}

上面例子里的 Log 是 Laravel 组件,所以它的日志不会写到 EasyWeChat 里的,建议把 wechat 的日志配置到 Laravel 同一个日志文件,便于调试。

我们有以下方式获取 SDK 的服务实例

使用容器的自动注入
<?php

namespace App\Http\Controllers;

use EasyWeChat\Foundation\Application;

class WechatController extends Controller
{

    public function demo(Application $wechat)
    {
        // $wechat 则为容器中 EasyWeChat\Foundation\Application 的实例
    }
}
使用外观

在 config/app.php 中 alias 部分添加外观别名:

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

然后就可以在任何地方使用外观方式调用 SDK 对应的服务了:

  $wechatServer = EasyWeChat::server(); // 服务端 
  $wechatUser = EasyWeChat::user(); // 用户服务  // ... 其它同理

OAuth 中间件

使用中间件的情况下 app/config/wechat.php 中的 oauth.callback 就随便填写吧(因为用不着了 ?)。

  1. 在 app/Http/Kernel.php 中添加路由中间件:

protected $routeMiddleware = [   
 // ...    'wechat.oauth' => \Overtrue\LaravelWechat\Middleware\OAuthAuthenticate::class,
 ];
  1. 在路由中添加中间件:

以 5.2 为例:

Route::group(['middleware' => ['web', 'wechat.oauth']], function () {
    Route::get('/user', function () {
        $user = session('wechat.oauth_user'); // 拿到授权用户资料

        dd($user);
    });
});

如果你在用 5.1 上面没有 'web' 中间件

当然,你也可以在中间件参数指定当前的 scopes:

Route::group(['middleware' => ['web', 'wechat.oauth:snsapi_userinfo']], function () {
  // ...
});

上面的路由定义了 /user 是需要微信授权的,那么在这条路由的回调 或 控制器对应的方法里, 你就可以从 session('wechat.oauth_user') 拿到已经授权的用户信息了。

模拟授权

有时候我们希望在本地开发完成后线上才真实的走微信授权流程,这将减少我们的开发成本,那么你需要做以下两步:

  1. 在 config/wechat.php 中将:'enable_mock' 启用,不论你是用 .env 文件里 WECHAT_ENABLE_MOCK=true 或者其它什么方法都可以。

  2. 在 config/wechat.php 中配置 mock_user 为微信的模拟的用户资料:

   /*
   * 开发模式下的免授权模拟授权用户资料
   *
   * 当 enable_mock 为 true 则会启用模拟微信授权,用于开发时使用,开发完成请删除或者改为 false 即可
   */
  'enable_mock' => env('WECHAT_ENABLE_MOCK', true),
  'mock_user' => [
     "openid" =>"odh7zsgI75iT8FRh0fGlSojc9PWM",
     // 以下字段为 scope 为 snsapi_userinfo 时需要
     "nickname" => "overtrue",
     "sex" =>"1",
     "province" =>"北京",
     "city" =>"北京",
     "country" =>"中国",
     "headimgurl" => "http://wx.qlogo.cn/mmopen/C2rEUskXQiblFYMUl9O0G05Q6pKibg7V1WpHX6CIQaic824apriabJw4r6EWxziaSt5BATrlbx1GVzwW2qjUCqtYpDvIJLjKgP1ug/0",
],

以上字段在 scope 为 snsapi_userinfo 时尽可能配置齐全哦,当然,如果你的模式只是 snsapi_base 的话只需要 openid 就好了。

授权事件

每次授权均会触发 Overtrue\LaravelWechat\Events\WeChatUserAuthorized,你可以监听该事件,该事件有两个属性:

$event->user; // 同 session('wechat.oauth_user') 一样
$event->isNewSession; // 是不是新的会话(第一次创建 session 时为 true)

开发文档:https://easywechat.org/zh-cn/docs/


(1)
分享:

本文由:xiaoshu168 作者:xiaoshu发表,转载请注明来源!

相关阅读