vzina/wechat

微信SDK

2.0.1 2024-10-11 01:57 UTC

Requires

• php: >=7.2
• ext-curl: *
• ext-fileinfo: *
• ext-openssl: *
• ext-simplexml: *
• guzzlehttp/guzzle: ^6.3 || ^7.0
• monolog/monolog: ^2.7 || ^3.1
• overtrue/socialite: ~2.0
• pimple/pimple: ^3.0
• psr/simple-cache: ^1.0
• symfony/cache: ^3.3 || ^4.3 || ^5.0
• symfony/event-dispatcher: ^4.3 || ^5.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.15
• mockery/mockery: ^1.2.3
• phpstan/phpstan: ^0.12.0
• phpunit/phpunit: ~7.5

MIT

• vzina

• sdk
• wechat
• weixin
• weixin-sdk

README

EasyWeChat

Requirement

1. PHP >= 7.2
2. Composer
3. openssl 拓展
4. fileinfo 拓展（素材管理模块需要用到）

Installation

$ composer require "vzina/wechat:~2.0" -vvv

Usage

基本使用（以服务端为例）:

<?php

use EasyWeChat\Factory;

$options = [
    'app_id'    => 'wx3cf0f39249eb0exxx',
    'secret'    => 'f1c242f4f28f735d4687abb469072xxx',
    'token'     => 'easywechat',
    'log' => [
        'level' => 'debug',
        'file'  => '/tmp/easywechat.log',
    ],
    // ...
];

$app = Factory::officialAccount($options);

$server = $app->server;
$user = $app->user;

$server->push(function($message) use ($user) {
    $fromUser = $user->get($message['FromUserName']);

    return "{$fromUser->nickname} 您好！欢迎关注 overtrue!";
});

$server->serve()->send();

hyperf(2.2以上版本)框架使用：

<?php
declare (strict_types=1);

namespace Yef\WeChat;

use EasyWeChat\Kernel\Events\AccessTokenRefreshed;
use EasyWeChat\Kernel\Events\ApplicationInitialized;
use EasyWeChat\Kernel\Events\HttpResponseCreated;
use EasyWeChat\Kernel\Events\ServerGuardResponseCreated;
use Hyperf\Cache\CacheManager;
use Hyperf\Context\Context;
use Hyperf\Utils\ApplicationContext;
use Hyperf\Utils\Arr;
use Hyperf\Utils\Str;
use Psr\EventDispatcher\EventDispatcherInterface;
use Psr\Http\Message\ServerRequestInterface;
use Symfony\Component\HttpFoundation\Request;

/**
 * Class Factory
 *
 * @inheritDoc
 */
class Factory extends \EasyWeChat\Factory
{
    /**
     * @param string $name
     * @return \EasyWeChat\Kernel\ServiceContainer
     */
    public static function make($name, array $config = [])
    {
        $adapter = Str::snake((string)$name);
        $contextKey = 'hy.wechat.' . ($config['app_id'] ?? $adapter);

        return Context::getOrSet($contextKey, function () use ($adapter, $config) {
            $container = ApplicationContext::getContainer();

            $config = $config ?: (array)config('wechat.' . $adapter);

            $prepends = [
                // 设置hy缓存对象
                'cache' => fn() => $container->get(CacheManager::class)
                    ->getDriver($config['cache_name'] ?? 'wechat_redis_cache'),
                // 设置hy请求对象
                'request' => function () use ($container) {
                    $request = $container->get(ServerRequestInterface::class);
                    if (empty($request)) {
                        return Request::createFromGlobals();
                    }

                    return Request::create(
                        (string)$request->getUri(),
                        $request->getMethod(),
                        $request->getQueryParams(),
                        $request->getCookieParams(),
                        $request->getUploadedFiles(),
                        $request->getServerParams(),
                        (string)$request->getBody()->getContents()
                    );
                },
            ];

            // 设置hy监听事件
            $listener = fn($event) => $container->get(EventDispatcherInterface::class)->dispatch($event);
            Arr::set($config, 'events.listen', [
                AccessTokenRefreshed::class => [$listener],
                ApplicationInitialized::class => [$listener],
                HttpResponseCreated::class => [$listener],
                ServerGuardResponseCreated::class => [$listener],
            ]);

            $namespace = Str::studly($adapter);
            $application = "\\EasyWeChat\\{$namespace}\\Application";

            $app = new $application($config, $prepends);

            return $app;
        });
    }

    public static function __callStatic($name, $arguments)
    {
        return static::make($name, ...$arguments);
    }
}

更多请参考 https://www.easywechat.com/。

Documentation

官网 · 教程 · 讨论 · 微信公众平台 · WeChat Official

License

MIT