lijinhua/hyperf-wechat

适用于hyperf的微信sdk

v1.0.0 2023-11-08 03:43 UTC

Requires

• php: >=8.0
• hyperf/cache: ^3.0
• hyperf/di: 3.0.*
• hyperf/framework: 3.0.*
• hyperf/http-server: ^3.0
• w7corp/easywechat: ^6.12

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• mockery/mockery: ^1.0
• phpstan/phpstan: ^1.0
• phpunit/phpunit: >=7.0
• swoole/ide-helper: ^4.5

Suggests

• swow/swow: Required to create swow components.

Conflicts

• w7corp/easywechat: <6.0

MIT

• php
• easywechat
• hyperf

README

微信 SDK for Hyperf， 基于 w7corp/easywechat

由于 easywechat v6 使用了 symfony/http-client作为请求库，hyperf提供了ClassMap替换能力，此包替换EasyWechat底层InteractWithHttpClient中的HttpClient对象实例，支持协程。

安装

composer require lijinhua/hyperf-wechat

配置

1. 发布配置文件

php ./bin/hyperf.php vendor:publish lijinhua/hyperf-wechat

1. 修改根目录下的 config/autoload/wechat.php 中对应的参数即可。
2. 每个模块都支持多账号，默认为 default。

使用

接收普通消息例子：

Router::addRoute(['GET', 'POST', 'HEAD'], '/wechat', 'App\Controller\WeChatController@serve');

注意：微信服务端认证的时候是 GET, 接收用户消息时是 POST ：

<?php
declare(strict_types=1);

namespace App\Controller;

use EasyWeChat\Kernel\Exceptions\BadRequestException;
use EasyWeChat\Kernel\Exceptions\InvalidArgumentException;
use EasyWeChat\Kernel\Exceptions\InvalidConfigException;
use Lijinhua\HyperfWechat\EasyWechat;
use Lijinhua\HyperfWechat\Helper;
use ReflectionException;

class WeChatController
{
    /**
     * 处理微信的请求消息
     *
     * @return string
     * @throws BadRequestException
     * @throws InvalidArgumentException
     * @throws InvalidConfigException
     * @throws ReflectionException
     */
    public function serve()
    {
        $app = EasyWechat::officialAccount();
        $server = $app->getServer();
        
        $server->with(function ($message, \Closure $next) {
            return '谢谢关注！';
            
            // 自定义逻辑
            // return $next($message);
        });
        
        // 一定要用Helper::Response去转换
        return Helper::Response($server->serve());
    }
}

EasyWechat中已对request及cache对象替换，更方便使用

  use Lijinhua\HyperfWechat\EasyWechat;
  
  $officialAccount = EasyWechat::officialAccount(); //公众号
  $pay = EasyWechat::pay(); //微信支付
  $miniApp = EasyWechat::miniApp(); //小程序
  $openPlatform = EasyWechat::openPlatform(); //开放平台
  $work = EasyWechat::work(); //企业微信
  $openWork = EasyWechat::openWork(); //企业微信开放平台
  
  // `foo` 为配置文件中的名称，默认为 `default`。`[]` 可覆盖账号配置
  EasyWeChat::officialAccount('foo', []);

更多详细的用法，请参考：https://easywechat.com