Kakao

인증된 제출자

socialiteproviders/kakao

제출자 이우진

최신 v4.3.0라이센스 MIT배포 2026년 7월 6일

인증

Laravel Socialite용 Kakao OAuth2 프로바이더

GitHub

카카오 소셜 로그인 (Kakao)

composer require socialiteproviders/kakao

설치 및 기본 사용법

먼저 기본 설치 가이드를 참고하여 공통 설정을 완료한 후, 아래의 카카오 전용 설정을 진행하세요.

`config/services.php`에 설정 추가

'kakao' => [
    'client_id' => env('KAKAO_CLIENT_ID'),
    'client_secret' => env('KAKAO_CLIENT_SECRET'),
    'redirect' => env('KAKAO_REDIRECT_URI'),
],

프로바이더 이벤트 리스너 등록

Laravel 11 이상

Laravel 11부터는 기본 EventServiceProvider가 제거되었습니다. 대신, AppServiceProvider의 boot 메서드에서 Event 파사드의 listen 메서드를 사용하여 리스너를 등록합니다.

NOTE

Socialite에 내장된 기본 프로바이더는 별도로 등록하지 않아도 됩니다. 직접 커스텀 프로바이더로 오버라이드하는 경우에만 추가 설정이 필요합니다.

Event::listen(function (\SocialiteProviders\Manager\SocialiteWasCalled $event) {
    $event->extendSocialite('kakao', \SocialiteProviders\Kakao\Provider::class);
});

Laravel 10 이하

SocialiteWasCalled 이벤트를 수신하도록 패키지 리스너를 등록합니다.

app/Providers/EventServiceProvider의 listen[] 배열에 아래 내용을 추가하세요. 자세한 설명은 기본 설치 가이드를 참고하세요.

protected $listen = [
    \SocialiteProviders\Manager\SocialiteWasCalled::class => [
        // ... 다른 프로바이더
        \SocialiteProviders\Kakao\KakaoExtendSocialite::class.'@handle',
    ],
];

사용법

설정이 완료되면 일반적인 Socialite 사용 방식과 동일하게 카카오 로그인을 사용할 수 있습니다(Socialite 파사드가 등록되어 있다고 가정합니다).

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

반환되는 사용자 필드

카카오 로그인 후 반환되는 사용자 정보 필드는 다음과 같습니다.

id
nickname (name과 동일한 값)
name
email
avatar