Manager
인증된 제출자socialiteproviders/manager
Laravel Socialite에서 새로운 프로바이더를 추가하거나 기본 제공 프로바이더를 손쉽게 오버라이드할 수 있습니다.
Socialite Providers Manager
소개
Socialite Providers Manager는 Laravel Socialite에 새로운 프로바이더를 손쉽게 추가하거나 기존 프로바이더를 오버라이드할 수 있게 해 주는 패키지입니다.
장점
- Manager를 통해 로드한 모든 프로바이더를 사용할 수 있습니다.
- 인스턴스 생성이 Socialite가 호출되는 시점까지 지연됩니다.
- 기존 프로바이더를 오버라이드할 수 있습니다.
- 새로운 프로바이더를 직접 만들 수 있습니다.
stateless()를true또는false로 설정할 수 있습니다.- 설정값을 동적으로 덮어쓸 수 있습니다.
- services 배열을 따로 설정할 필요 없이
.env파일의 환경 변수를 직접 읽어 옵니다.
사용 가능한 프로바이더
- SocialiteProviders 목록을 참고하세요.
- 직접 만들거나 다른 사람이 만든 프로바이더를 수정해서 사용할 수도 있습니다.
참고 자료
핸들러 만들기
아래는 핸들러 예제입니다. 이 클래스의 전체 이름(FQCN)을 EventServiceProvider의 listen[]에 추가해야 합니다.
- Laravel 이벤트 문서도 함께 참고하세요.
providername은meetup처럼 프로바이더의 이름입니다.- 네임스페이스와 클래스 이름은 프로젝트에 맞게 변경해야 합니다.
namespace Your\Name\Space;
use SocialiteProviders\Manager\SocialiteWasCalled;
class ProviderNameExtendSocialite
{
public function handle(SocialiteWasCalled $socialiteWasCalled)
{
$socialiteWasCalled->extendSocialite('providername', \Your\Name\Space\Provider::class);
}
}프로바이더 만들기
- 이미 만들어진 프로바이더를 참고하면 도움이 됩니다.
내장 프로바이더 오버라이드하기
laravel/socialite에 내장된 프로바이더(예: 'facebook')와 정확히 같은 이름으로 새 프로바이더를 만들면 손쉽게 오버라이드할 수 있습니다.
설정을 동적으로 전달하기
다음과 같이 설정을 동적으로 전달할 수 있습니다.
$clientId = "secret";
$clientSecret = "secret";
$redirectUrl = "http://yourdomain.com/api/redirect";
$additionalProviderConfig = ['site' => 'meta.stackoverflow.com'];
$config = new \SocialiteProviders\Manager\Config($clientId, $clientSecret, $redirectUrl, $additionalProviderConfig);
return Socialite::with('provider-name')->setConfig($config)->redirect();이 코드는 다른 Socialite 메서드를 실행하기 전에 반드시 먼저 호출해야 합니다.
OAuth1 서버 클래스 만들기
다른 OAuth1 프로바이더를 참고하면 도움이 됩니다.
액세스 토큰 응답 본문 가져오기
Laravel Socialite는 기본적으로 access_token에만 접근할 수 있으며, 이는 \Laravel\Socialite\User->token 공개 프로퍼티로 가져옵니다. 하지만 refresh_token 같은 항목이 담긴 응답 본문 전체가 필요할 때가 있습니다.
이를 가능하게 하려면 OAuth2 프로바이더 클래스가 \SocialiteProviders\Manager\OAuth2\AbstractProvider를 상속해야 하고, OAuth1 프로바이더는 \SocialiteProviders\Manager\OAuth1\AbstractProvider와 \SocialiteProviders\Manager\OAuth1\Server를 사용해야 합니다.
사용자 객체에서 다음과 같이 접근할 수 있습니다: $user->accessTokenResponseBody
