Laravel Socialite 的线程 OAuth2 提供者

4.0.0 2024-06-22 22:59 UTC

This package is auto-updated.

Last update: 2024-08-26 21:42:08 UTC


README

composer require socialiteproviders/threads

安装与基本用法

请参阅基础安装指南,然后按照以下特定提供者的说明操作。

将配置添加到 config/services.php

'threads' => [
  'client_id' => env('THREADS_CLIENT_ID'),
  'client_secret' => env('THREADS_CLIENT_SECRET'),
  'redirect' => env('THREADS_REDIRECT_URI')
],

添加提供者事件监听器

Laravel 11+

在 Laravel 11 中,默认的 EventServiceProvider 提供者已被移除。相反,您可以在 AppServiceProviderboot 方法中使用 Event 门面上的 listen 方法添加监听器。

  • 注意:除非您用自己的提供者覆盖它们,否则不需要为内置的 Socialite 提供者添加任何内容。
Event::listen(function (\SocialiteProviders\Manager\SocialiteWasCalled $event) {
    $event->extendSocialite('threads', \SocialiteProviders\Threads\Provider::class);
});
Laravel 10 或以下配置包的监听器以监听 `SocialiteWasCalled` 事件。

将事件添加到 app/Providers/EventServiceProvider 中的 listen[] 数组中。有关详细说明,请参阅基础安装指南

protected $listen = [
    \SocialiteProviders\Manager\SocialiteWasCalled::class => [
        // ... other providers
        \SocialiteProviders\Threads\ThreadsExtendSocialite::class.'@handle',
    ],
];

用法

现在您应该可以使用提供者,就像您通常使用 Socialite 一样(假设您已安装了门面)

return Socialite::driver('threads')->redirect();

返回的用户字段

  • id
  • 昵称
  • 头像

刷新访问令牌

Threads 不支持刷新令牌。然而,您可以将默认的短期访问令牌交换为长期可刷新的访问令牌。由于 Socialite 只支持使用刷新令牌的传统方式刷新访问令牌,因此如果您需要刷新访问令牌,则需要自行实现此功能。

首先,将短期访问令牌交换为长期访问令牌。

public function exchangeAccessToken(string $accessToken): string
{
    $response = Http::post('https://graph.threads.net/access_token', [
            RequestOptions::HEADERS => [
                'Content-Type' => 'application/json'
            ],
            RequestOptions::FORM_PARAMS => [
                'access_token'  => $accessToken,
                'client_secret' => config('threads.client_secret'),
                'grant_type'    => 'th_exchange_token',
            ],
        ]);

    $response = json_decode((string) $response->getBody(), true);

    return $response['access_token'];
}

在获得长期访问令牌后,只要它仍然有效,就可以刷新此令牌。

public function refreshAccessToken(string $accessToken): string
{
    $response = Http::post('https://graph.threads.net/refresh_access_token', [
            RequestOptions::HEADERS => [
                'Content-Type' => 'application/json'
            ],
            RequestOptions::FORM_PARAMS => [
                'access_token'  => $accessToken,
                'grant_type'    => 'th_refresh_token',
            ],
        ]);

    $response = json_decode((string) $response->getBody(), true);

    return $response['access_token'];
}

参考