Implementing Third-Party WeChat Login in Laravel with Socialite

This guide demonstrates how to add WeChat third‑party login to a Laravel project using the Socialite package.

1. Install Socialite composer require laravel/socialite 2. Register the provider and alias in config/app.php:

'providers' => [
    Laravel\Socialite\SocialiteServiceProvider::class,
],
'aliases' => [
    'Socialite' => Laravel\Socialite\Facades\Socialite::class,
],

3. Install the WeChat provider : composer require socialiteproviders/weixin Then add the provider class to config/app.php:

'providers' => [
    SocialiteProviders\Manager\ServiceProvider::class,
],

Register the event listener in app/Providers/EventServiceProvider.php:

protected $listen = [
    SocialiteProviders\Manager\SocialiteWasCalled::class => [
        'SocialiteProviders\Weixin\WeixinExtendSocialite@handle',
    ],
];

4. Add configuration :

In .env set WEIXIN_KEY, WEIXIN_SECRET and WEIXIN_REDIRECT_URI (do not prepend http:// to the redirect URI).

In config/services.php add:

'weixin' => [
    'client_id' => env('WEIXIN_KEY'),
    'client_secret' => env('WEIXIN_SECRET'),
    'redirect' => env('WEIXIN_REDIRECT_URI'),
    'auth_base_uri' => 'https://open.weixin.com/connect/qrconnect',
],

5. Define routes in routes/web.php:

// Initiate WeChat login
Route::get('/weixin', 'WeixinController@weixin')->name('weixin');

// Callback after authorization
Route::get('/weixin/callback', 'WeixinController@weixinlogin');

6. Implement controller app/Http/Controllers/WeixinController.php with two methods:

<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Laravel\Socialite\Facades\Socialite;
use App\User;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Str;

class WeixinController extends Controller
{
    public function weixin()
    {
        return Socialite::with('weixin')->redirect();
    }

    public function weixinlogin()
    {
        $user = Socialite::driver('weixin')->user();
        $check = User::where('uid', $user->id)
                     ->where('provider', 'qq_connect')
                     ->first();
        if (! $check) {
            $customer = User::create([
                'uid' => $user->id,
                'provider' => 'qq_connect',
                'name' => $user->nickname,
                'email' => 'qq_connect' . $user->id . '@example.com',
                'password' => bcrypt(Str::random(60)),
                'avatar' => $user->avatar,
            ]);
        } else {
            $customer = $check;
        }
        Auth::login($customer, true);
        return redirect('/');
    }
}

After the callback, the authenticated user information can be accessed, completing the WeChat login integration.