目录

实例化

微信服务器推送事件

预受权

获取预受权 Code

获取预受权 URL

API 列表

使用受权码换取公众号的接口调用凭据和受权信息

获取受权方的公众号账号基本信息

获取受权方的选项设置信息

设置受权方的选项信息

调用受权方 API

实例化

use EasyWeChat\Foundation\Application;

$options = [

// ...

'open_platform' => [

'app_id' => 'component-app-id',

'secret' => 'component-app-secret',

'token' => 'component-token',

'aes_key' => 'component-aes-key'

],

// ...

];

$app = new Application($options);

$openPlatform = $app->open_platform;

微信服务器推送事件

公众号第三方平台推送的有四个事件：php

受权成功(authorized)

受权更新(updateauthorized)

受权取消(unauthorized)

推送 ComponentVerifyTicket(component_verify_ticket)

在公众号第三方平台建立审核经过后，微信服务器会向其“受权事件接收URL”每隔 10 分钟推送一次 component_verify_ticket。数据库

SDK 内部已实现缓存 component_veirfy_ticket，开发者无需另行处理该事件。

其他事件须要开发者自行处理。缓存

注：须要在URL路由中写上触发代码，而且注册路由后须要等待微信服务器推送 component_verify_ticket，才有权限进行其余操做，不然报”Component verify ticket does not exists.”

Example:服务器

use EasyWeChat\OpenPlatform\Guard;

$server = $openPlatform->server;

$server->setMessageHandler(function($event) use ($openPlatform) {

// 事件类型常量定义在 \EasyWeChat\OpenPlatform\Guard 类里

switch ($event->InfoType) {

case Guard::EVENT_AUTHORIZED: // 受权成功

$authorizationInfo = $openPlatform->getAuthorizationInfo($event->AuthorizationCode);

// 保存数据库操做等...

case Guard::EVENT_UPDATE_AUTHORIZED: // 更新受权

// 更新数据库操做等...

case Guard::EVENT_UNAUTHORIZED: // 受权取消

// 更新数据库操做等...

}

});

$response = $server->serve();

$response->send(); // Laravel 里请使用：return $response;

预受权

获取预受权 Code

Example:微信

$openPlatform->pre_auth->getCode();

获取预受权 URL

Example:app

// 直接跳转

$response = $openPlatform->pre_auth->redirect('https://your-domain.com/callback');

// 获取跳转的 URL

$response->getTargetUrl();

用户受权后会带上 auth_code 跳转到 https://your-domain.com/callback?auth_code=xxxxxxxdom

API 列表

使用受权码换取公众号的接口调用凭据和受权信息

// 使用受权码换取公众号的接口调用凭据和受权信息

// Optional: $authorizationCode 不传值时会自动获取 URL 中 auth_code 值

$openPlatform->getAuthorizationInfo($authorizationCode = null);

获取受权方的公众号账号基本信息

$openPlatform->getAuthorizerInfo($authorizerAppId);

获取受权方的选项设置信息

$openPlatform->getAuthorizerOption($authorizerAppId, $optionName);

设置受权方的选项信息

$openPlatform->setAuthorizerOption($authorizerAppId, $optionName, $optionValue);

调用受权方 API

经过该方法会得到一个 \EasyWeChat\Foundation\Application 实例。code

当调用受权方 API 后，SDK 内部会自动获取和刷新 AuthorizerAccessToken 有效期。

因此开发者无需处理受权方公众号的接口调用凭据 AuthorizerAccessToken。component

// 传递 AuthorizerAppId 和 AuthorizerRefreshToken(注意不是 AuthorizerAccessToken)便可。

$app = $openPlatform->createAuthorizerApplication($authorizerAppId, $authorizerRefreshToken);

// 调用方式与普通调用一致。orm