服务端

你可以通过 $app->getServer() 获取服务端模块,服务端模块默认处理了服务端验证的逻辑

use EasyWeChat\OfficialAccount\Application;

$config = [...];
$app = new Application($config);

$server = $app->getServer();
1
2
3
4
5
6

中间件模式

与 5.x 的设计类似,服务端使用中间件模式来依次调用开发者注册的中间件:

$server->with(function($message, \Closure $next) {
    // 你的自定义逻辑
    return $next($message)
});

$response = $server->serve();
1
2
3
4
5
6

你可以注册多个中间件来处理不同的情况:

$server
    ->with(function($message, \Closure $next) {
        // 你的自定义逻辑1
        return $next($message)
    })
    ->with(function($message, \Closure $next) {
        // 你的自定义逻辑2
        return $next($message)
    })
    ->with(function($message, \Closure $next) {
        // 你的自定义逻辑3
        return $next($message)
    });

$response = $server->serve();
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

回复消息

当你在中间件里不回复消息时,你将要传递消息给下一个中间件:

function($message, \Closure $next) {
    // 你的自定义逻辑3
    return $next($message)
}
1
2
3
4

如果此时你需要返回消息给用户,你可以直接像下面这样回复消息内容:

function($message, \Closure $next) {
    return '感谢你使用 EasyWeChat';
}
1
2
3

注意:回复消息后其他没运行的中间件将不再执行,所以请你将全局都需要执行的中间件优先提前注册。

其他类型的消息时,请直接参考 官方文档消息的 XML 结构open in new window 以数组形式返回即可。

需要省略 ToUserNameFromUserNameCreateTime,以回复图片消息为例:

function($message, \Closure $next) {
    return [
        'MsgType' => 'image',
        'Image' => [
            'MediaId' => 'media_id',
        ],
    ];
}
1
2
3
4
5
6
7
8

怎么发送多条消息?

服务端只能回复一条消息,如果你想在接收到消息时向用户发送多条消息,你可以调用 客服消息open in new window 接口来发送多条。

使用独立的中间件类

当然,中间件也支持多种类型,比如你可以使用一个独立的类作为中间件:

class MyCustomHandler
{
    public function __invoke($message, \Closure $next)
    {
        if ($message->MsgType === 'text') {
            //...
        }

        return $next($message);
    }
}
1
2
3
4
5
6
7
8
9
10
11

注册中间件:

$server->with(MyCustomHandler::class);

// 或者

$server->with(new MyCustomHandler());
1
2
3
4
5

使用 callable 类型中间件

中间件支持 callableopen in new window 类型的参数,所以你不一定要传入一个闭包(Closure),你可以选择传入一个函数名,一个 [$class, $method] 或者 Foo::bar 这样的类型。

$server->with([$object, 'method']);
$server->with('ClassName::method');
1
2

注册指定消息类型的消息处理器

为了方便开发者处理消息推送,server 类内置了两个便捷方法:

处理普通消息

当普通微信用户向公众账号发消息时被调用,且匹配对应的事件类型:

$server->addMessageListener('text', function() { ... });
1

参数

  • 参数 1 为消息类型,也就是 message 中的 MsgType 字段,例如:image;
  • 参数 2 是中间件,也就是上面讲到的多种类型的中间件。

处理事件消息

事件消息中间件仅在推送事件消息时被调用,且匹配对应的事件类型:

$server->addEventListener('subscribe', function() { ... });
1

参数

  • 参数 1 为事件类型,也就是 message 中的 Event 字段,例如:subscribe;
  • 参数 2 是中间件,也就是上面讲到的多种类型的中间件。

关于回复消息的结构,可以查阅 消息 章节了解更多。

完整示例

以下示例完成了服务端验证,自定义中间件回复等逻辑:

use EasyWeChat\OfficialAccount\Application;

$config = [...];
$app = new Application($config);

$server = $app->getServer();

$server->addEventListener('subscribe', function($message, \Closure $next) {
    return '感谢您关注 EasyWeChat!';
});

$response = $server->serve();

return $response;
1
2
3
4
5
6
7
8
9
10
11
12
13
14

$response 是一个 Psr\Http\Message\ResponseInterfaceopen in new window 实现,所以请自己决定如何适配您的框架。