Laravel Socialite: пошаговая настройка входа через провайдера
Socialite 5 даёт вход через GitHub, GitLab, Google, Facebook, LinkedIn, Slack, Twitch, X и Bitbucket. Ключи провайдера задают в config/services.php, а маршруты входа и возврата добавляют в routes/web.php. Настройка занимает несколько шагов, проверка входа через GitHub подтверждает результат.
01Проверьте, что проект Laravel работает
Гид начинается на сервере, где проект Laravel уже развёрнут. Убедитесь, что команда artisan отвечает и версия фреймворка актуальна. Текущая версия Laravel 13 требует PHP 8.3 и выше, PHP 8.3 из Ubuntu 24.04 подходит. Если проект ещё не создан, его создают командой composer create-project laravel/laravel example.com, но установка фреймворка описана на отдельной странице.
php artisan --version
02Установите Socialite через Composer
Пакет ставят в каталог проекта командой composer require laravel/socialite. Отдельного файла конфигурации у пакета нет: ключи провайдера задают в config/services.php. Версия Socialite 5 работает с Laravel 11 и новее.
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.
'github' => [
'client_id' => env('GITHUB_CLIENT_ID'),
'client_secret' => env('GITHUB_CLIENT_SECRET'),
'redirect' => env('GITHUB_REDIRECT_URI'),
],
05Добавьте маршруты входа и возврата
В routes/web.php добавьте два маршрута: переход к провайдеру и обработку возврата. Метод redirect() отправляет пользователя на страницу согласия, метод user() возвращает объект пользователя от провайдера. Маршрут возврата должен совпадать с адресом, указанным у провайдера.
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 PHP Laravel: пошаговая настройка проекта на Ubuntu 24.04 Создайте проект Laravel на PHP 8.3 в Ubuntu 24.04: Composer,.env, MySQL, миграции, nginx, кэш и проверка запуска. Команды и типичные ошибки.
- Руководство · Laravel Filament в Laravel: установка и настройка панели Установка Filament 5 в Laravel на Ubuntu 24.04: панель /admin, пользователь, ресурс Customer, доступ на сервере и проверка входа без ошибки 403.
- Руководство · Laravel Laravel Livewire: установка и первый компонент на Ubuntu 24.04 Установка Livewire 4 в Laravel на Ubuntu 24.04: создание компонента, вывод на страницу, настройка nginx для livewire.min.js и проверка работы в браузере.
- Руководство · Laravel Laravel API: пошаговая настройка на Ubuntu 24.04 Как поднять API в Laravel на Ubuntu 24.04: установка Sanctum, маршруты в routes/api.php, проверка через curl, ответы 401 и 404, кэш и деплой.
- Руководство · Laravel Laravel Eloquent: настройка и проверка на Ubuntu 24.04 Пошаговая настройка Eloquent в Laravel на Ubuntu 24.04: подключение MySQL, миграции, модели, связи, проверка через tinker и маршрут.
- Руководство · Laravel Laravel install: установка фреймворка на Ubuntu 24.04 Пошаговая установка Laravel на Ubuntu 24.04: проверка PHP 8.3, composer create-project, ключ приложения,.env, миграции и запуск через php artisan serve.
Laravel: руководство по установке и настройке: все материалы темы