К содержимому

Laravel Socialite: пошаговая настройка входа через провайдера

Socialite 5 даёт вход через GitHub, GitLab, Google, Facebook, LinkedIn, Slack, Twitch, X и Bitbucket. Ключи провайдера задают в config/services.php, а маршруты входа и возврата добавляют в routes/web.php. Настройка занимает несколько шагов, проверка входа через GitHub подтверждает результат.

Руководство Laravel 3 мин чтения

01Проверьте, что проект Laravel работает

Гид начинается на сервере, где проект Laravel уже развёрнут. Убедитесь, что команда artisan отвечает и версия фреймворка актуальна. Текущая версия Laravel 13 требует PHP 8.3 и выше, PHP 8.3 из Ubuntu 24.04 подходит. Если проект ещё не создан, его создают командой composer create-project laravel/laravel example.com, но установка фреймворка описана на отдельной странице.

bash
php artisan --version

02Установите Socialite через Composer

Пакет ставят в каталог проекта командой composer require laravel/socialite. Отдельного файла конфигурации у пакета нет: ключи провайдера задают в config/services.php. Версия Socialite 5 работает с Laravel 11 и новее.

bash
composer require laravel/socialite

03Зарегистрируйте OAuth-приложение у провайдера

В настройках GitHub создайте OAuth App и укажите адрес возврата, который совпадает с доменом сайта. Для примера это https://example.com/auth/github/callback. Полученные client_id и client_secret понадобятся на следующем шаге. Адрес возврата должен совпадать по схеме и домену, иначе провайдер не вернёт код.

04Добавьте ключи провайдера в config/services.php

Ключи задают в массиве github внутри config/services.php. Значения берут из переменных окружения, чтобы не хранить секреты в репозитории. В .env добавьте GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET и GITHUB_REDIRECT_URI. После правки .env при закэшированном конфиге выполните php artisan config:cache.

php
'github' => [
    'client_id' => env('GITHUB_CLIENT_ID'),
    'client_secret' => env('GITHUB_CLIENT_SECRET'),
    'redirect' => env('GITHUB_REDIRECT_URI'),
],

05Добавьте маршруты входа и возврата

В routes/web.php добавьте два маршрута: переход к провайдеру и обработку возврата. Метод redirect() отправляет пользователя на страницу согласия, метод user() возвращает объект пользователя от провайдера. Маршрут возврата должен совпадать с адресом, указанным у провайдера.

php
use Laravel\Socialite\Facades\Socialite;

Route::get('/auth/github/redirect', function () {
    return Socialite::driver('github')->redirect();
});

Route::get('/auth/github/callback', function () {
    $githubUser = Socialite::driver('github')->user();

    return $githubUser->getNickname();
});

06Проверьте вход через GitHub

Откройте в браузере https://example.com/auth/github/redirect и подтвердите доступ. После возврата на сайт Laravel покажет никнейм пользователя GitHub. Если вместо этого появляется Laravel\Socialite\Two\InvalidStateException, проверьте, что redirect в config/services.php указывает на тот же домен и схему, что и адрес в браузере, и что SESSION_DOMAIN совпадает с доменом сайта.

Частые ошибки

  • При возврате от провайдера появляется Laravel\Socialite\Two\InvalidStateException.

    Значение state в сессии не совпало с ответом провайдера. Проверьте, что redirect в config/services.php указывает на тот же домен и схему, что и адрес в браузере, и что SESSION_DOMAIN совпадает с доменом сайта.

  • После правки .env новые ключи провайдера не применяются.

    При закэшированном конфиге env() вне файлов config/ возвращает null. Выполните php artisan config:cache или php artisan config:clear и повторите вход.

  • Вход через провайдера завершается ошибкой на стороне провайдера.

    Адрес возврата в настройках OAuth-приложения должен совпадать с redirect в config/services.php по схеме и домену. Сверьте client_id и client_secret с настройками приложения.

Deploykin

Как это делается в Deploykin

В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Какие провайдеры поддерживает Socialite 5 из коробки?

GitHub, GitLab, Google, Facebook, LinkedIn, Slack, Twitch, X и Bitbucket. Для остальных провайдеров нужен отдельный драйвер.

Где задают ключи провайдера для Socialite?

В config/services.php в массиве провайдера: client_id, client_secret и redirect. Значения удобно брать из переменных окружения в .env.

Почему после возврата от провайдера появляется InvalidStateException?

Значение state в сессии не совпало с ответом провайдера. Чаще всего redirect указывает на другой домен, с www или без, либо на http вместо https, или SESSION_DOMAIN не совпадает с доменом сайта.

Нужно ли создавать миграцию для Socialite?

Нет, пакет не требует изменений схемы базы. Он отвечает за обмен с провайдером, а хранение пользователя и его связи с провайдером вы организуете сами.

Ещё по теме

Laravel: руководство по установке и настройке: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.