EasyWeChat for Laravel

SDK EasyWeChat for Laravel w7corp/easywechat

7.x Lumen

• overtrue/laravel-wechat:^7.0 -> Laravel >= 8.0
• overtrue/laravel-wechat:^6.0 -> Laravel/Lumen >= 7.0
• overtrue/laravel-wechat:^5.1 -> Laravel/Lumen >= 5.1

composer require "overtrue/laravel-wechat"

php artisan vendor:publish --provider="Overtrue\\LaravelWeChat\\ServiceProvider"

'aliases' => [
    // ...
    'EasyWeChat' => Overtrue\LaravelWeChat\EasyWeChat::class,
],

3. default

🚨 App\Http\Middleware\VerifyCsrfToken

protected $except = [
    // ...
    'wechat',
];

Route::any('/wechat', '[email protected]');

Route::any, GET, POST

WeChatController

<?php

namespace App\Http\Controllers;

use Log;

class WeChatController extends Controller
{
    public function serve()
    {
        Log::info('request arrived.'); 

        $server = app('easywechat.official_account')->getServer();

        $server->with(function($message){
            return " overtrue";
        });

        return $server->serve();
    }
}

OAuth

app/config/easywechat.php oauth.callback ( 😄)

1. app/Http/Kernel.php

protected $routeMiddleware = [
    // ...
    'easywechat.oauth' => \Overtrue\LaravelWeChat\Middleware\OAuthAuthenticate::class,
];

//...
Route::group(['middleware' => ['web', 'easywechat.oauth']], function () {
    Route::get('/user', function () {
        $user = session('easywechat.oauth_user.default'); // 

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

'easywechat.oauth:default' scopes:

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

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

/user ** ** session('easywechat.oauth_user.default')

use Illuminate\Support\Arr;
use Overtrue\Socialite\User as SocialiteUser;

$user = new SocialiteUser([
            'id' => 'mock-openid',
            'name' => 'overtrue',
            'nickname' => 'overtrue',
            'avatar' => 'http://example.com/avatars/overtrue.png',
            'email' => null,
            'original' => [],
            'provider' => 'WeChat',
        ]);

scope snsapi_userinfo snsapi_base openid

2. session

OAuth

session(['easywechat.oauth_user.default' => $user]); // `default` 

• OAuth Overtrue\LaravelWeChat\Events\WeChatUserAuthorized

// 
$event->user; //  session('easywechat.oauth_user.default') 
$event->isNewSession; //  session  true
$event->account; // 

Overtrue\LaravelWeChat\Traits\HandleOpenPlatformServerEvents

routes/web.php:

Route::any('/open-platform/server', OpenPlatformController::class);

app/Http/Controllers/OpenPlatformController.php:

<?php

namespace App\Http\Controllers;

use Overtrue\LaravelWeChat\Traits\HandleOpenPlatformServerEvents;

class OpenPlatformController extends Controller
{
    use HandleOpenPlatformServerEvents;
    
    public function __invoke(Application $application): \Psr\Http\Message\ResponseInterface
    {
        $app = app('easywechat.open_platform');
        
        return $this->handleServerEvents($app);
    }
}

Tips:

• Overtrue\LaravelWeChat\Events\OpenPlatform\Authorized
• Overtrue\LaravelWeChat\Events\OpenPlatform\AuthorizeUpdated
• Overtrue\LaravelWeChat\Events\OpenPlatform\Unauthorized
• VerifyTicketOvertrue\LaravelWeChat\Events\OpenPlatform\VerifyTicketRefreshed

// 
$message = $event->payload; // 

http://example.com/open-platform/server URL

SDK https://www.easywechat.com

❤️ Sponsor me

❤️

Project supported by JetBrains

Many thanks to Jetbrains for kindly providing a license for me to work on this and other open-source projects.

PHP

PHP

PHP -

License

MIT