본문 바로가기
← 패키지 목록

Manager

인증된 제출자

socialiteproviders/manager

제출자 이우진
최신 v4.10.0라이센스 MIT배포 2026년 10월 23일
인증

Laravel Socialite에서 새로운 프로바이더를 추가하거나 기본 제공 프로바이더를 손쉽게 오버라이드할 수 있습니다.

Socialite Providers Manager

Test codecov Scrutinizer Code Quality Latest Stable Version Total Downloads Latest Unstable Version License

소개

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