Laravel Socialite は OAuth 認証のインターフェースを提供するパッケージです。ソーシャルログインを簡単に実装する事ができます。

Laravel Socialite 4.x でソーシャルログイン（OAuth認証）を行う

Laravel には Socialite という、ソーシャルログインを実現するためのパッケージがあります。
今回は Socialite 4.x を利用して SNS のアカウントを使ったソーシャルログイン（OAuth認証）を実装してみます。
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#laravel-socialite">Laravel Socialite</a></li>
<li><a href="#%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">インストール</a></li>
<li><a href="#%E8%A8%AD%E5%AE%9A%E6%83%85%E5%A0%B1%E3%81%AE%E8%BF%BD%E5%8A%A0">設定情報の追加</a></li>
<li><a href="#service-provider-%E7%99%BB%E9%8C%B2">Service Provider 登録</a></li>
<li><a href="#event-listener-%E7%99%BB%E9%8C%B2">Event Listener 登録</a></li>
<li><a href="#%E3%82%BD%E3%83%BC%E3%82%B7%E3%83%A3%E3%83%AB%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E5%AE%9F%E8%A3%85">ソーシャルログインの実装</a></li>
<li><a href="#%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D">動作確認</a></li>
<li><a href="#%E3%82%B3%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF%E3%81%A7%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E6%83%85%E5%A0%B1%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B">コールバックでユーザー情報を取得する</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
今回の開発環境は以下の通りです。
<ul>
<li>CentOS 8</li>
<li>PHP 7.4</li>
<li>Laravel 7</li>
<li>Socialite 4.x</li>
</ul>
Socialite のバージョンに関して、本記事では４系を扱います。３系と互換性が無いので、３系の場合は<a href="/entry/33">こちら</a>の記事を参考にしてください。
また、本記事執筆時で最新の Laravel を使います。これ未満のバージョンの動作確認は行っていません。
<h2 id="laravel-socialite">Laravel Socialite</h2>
Laravel Socialite（ソーシャライト） は、ソーシャルログイン（OAuth認証）のインターフェースを提供するパッケージです。これを利用する事で、ソーシャルログインを簡単に実装する事ができます。
Laravel Socialite 
<a href="https://github.com/laravel/socialite" rel="noopener noreferrer" target="_blank">https://github.com/laravel/socialite</a>
Google / Twitter / GitHub / Facebook など、代表的な SNS やサービスなどは一応は網羅されていて、Socialite で導入できます。
他にも対応している SNS やサービスが沢山あるので、詳細は以下を確認してください。（Instagram とか YouTube とか LINE とかまである。Slack とかもいけるみたい）
Socialite Providers 
<a href="https://socialiteproviders.netlify.app/" rel="noopener noreferrer" target="_blank">https://socialiteproviders.netlify.app/</a>
Socialite 4.x を使うためには以下がシステム要件となっています。
<ul>
<li>PHP >= 7.1.3</li>
</ul>
要件としては PHP のバージョンだけですが、Laravel のバージョンも 5.6 以上には上げておく事を推奨します。
（PHP 7.1.3 以上が必要なのは 5.6 からなので個人的な推奨ラインとして。もちろん最新版が理想です。）
<h2 id="インストール">インストール</h2>
Socialite をインストールします。Laravel のルートディレクトリで以下の composer コマンドを実行します。
<pre><code class="hljs language-shell"># socialite install
composer require laravel/socialite
</code></pre>
今回は Twitter アカウントでのソーシャルログインを実装しますが、４系ではアダプタの提供がサービスごとに別々になったみたいなので、Twitter のアダプタもインストールします。
<pre><code class="hljs language-shell"># socialite twitter provider install
composer require socialiteproviders/twitter
</code></pre>
<h2 id="設定情報の追加">設定情報の追加</h2>
予め作成した SNS などの APP 情報設定ファイルに追加します。
<dl class="description_setting">
<dt>config/services.php</dt>
<dd>
<pre><code class="hljs language-php">'twitter' => [
 'client_id' => env('TWITTER_KEY'),
 'client_secret' => env('TWITTER_SECRET'),
 'redirect' => env('TWITTER_REDIRECT_URI'),
]
</code></pre>
</dd>
</dl>
<dl class="description_setting">
<dt>.env</dt>
<dd>
<pre><code class="hljs language-shell">TWITTER_KEY=xxxxxxxxxx
TWITTER_SECRET=xxxxxxxxxx
TWITTER_REDIRECT_URI=http://yourdomain.com/login/twitter/callback
</code></pre>
</dd>
</dl>
<h2 id="service-provider-登録">Service Provider 登録</h2>
サービスプロバイダを登録します。
<dl class="description_setting">
<dt>config/app.php</dt>
<dd>
<pre><code class="hljs language-php">'providers' => [
 .
 .
 .
 \SocialiteProviders\Manager\ServiceProvider::class, // 追加
],
</code></pre>
</dd>
</dl>
<h2 id="event-listener-登録">Event Listener 登録</h2>
イベントリスナーを登録します。
<dl class="description_setting">
<dt>app/Providers/EventServiceProvider.php</dt>
<dd>
<pre><code class="hljs language-php">// 追加
use SocialiteProviders\Manager\SocialiteWasCalled;


protected $listen = [
 Registered::class => [
 SendEmailVerificationNotification::class,
 ],
 // 追加
 SocialiteWasCalled::class => [
 //TwitterExtendSocialite::class,
 'SocialiteProviders\\Twitter\\TwitterExtendSocialite@handle',
 ],
];
</code></pre>
</dd>
</dl>
<h2 id="ソーシャルログインの実装">ソーシャルログインの実装</h2>
初期設定は完了したので、あとはルーティングやコントローラを作成して、OAuth認証を実装していきます。
この辺からのファイル名やパスは公式リファレンスに沿うので、適宜好きな名前やパスにしてください。
コントローラを作成します。以下の artisan コマンドを実行します。
<pre><code class="hljs language-shell">php artisan make:controller Auth/LoginController
</code></pre>
コントローラを定義します。
<dl class="description_setting">
<dt>app/Http/Controllers/Auth/LoginController.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

declare(strict_type=1);

namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use Laravel\Socialite\Facades\Socialite;

class LoginController extends Controller
{
 public function redirectToProvider()
 {
 return Socialite::driver('twitter')->redirect();
 }

 public function handleProviderCallback()
 {
 $user = Socialite::driver('twitter')->user();
 }
}
</code></pre>
</dd>
</dl>
<ul>
<li>redirectToProvider() では、SNS の OAuth認証画面へリダイレクトしています。</li>
<li>handleProviderCallback() では、OAuth認証後に SNS から戻ってきた時の処理（コールバック）を定義しています。ここでは、ユーザー情報を取得しています。</li>
</ul>
基本的にはこれだけです。簡単ですね。
今回は twitter だけですが、別の SNS やサービスの場合も、基本的にはこれと同じで、その分追加（もしくは共通化）すれば実現できると思います。
最後にルーティングを定義します。
<dl class="description_setting">
<dt>routes/web.php</dt>
<dd>
<pre><code class="hljs language-php">Route::get('login/twitter', 'Auth\LoginController@redirectToProvider');
Route::get('login/twitter/callback', 'Auth\LoginController@handleProviderCallback');
</code></pre>
</dd>
</dl>
Twitter でのソーシャルログインを行うためにアクセスしてきた場合のルーティング（上部）と、OAuth認証後に SNS から戻ってきた時のルーティング（下部）を定義しています。
<h2 id="動作確認">動作確認</h2>
実際にブラウザからアクセスして確認してみます。 
http<a href=""></a>://your-domain/login/twitter
Twitter の OAuth認証画面にリダイレクトされ、以下の画面が表示されました。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/207/4rgJfKfN1u8xd9EPtS7P.png" width="800" height="836" alt="Twitter OAuth 認証画面"></div>
「連携アプリを認証」を押下すろと、ソーシャルログインが行われ、自分のサイトへ戻ってきます。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/207/KMNWZ2zQblZFb6KALQ9j.png" width="800" height="175" alt="Twitter ソーシャルログイン コールバック"></div>
ここで、ユーザー情報なども一緒に渡ってくるので、あとはそれらを記録したり表示すれば、一連の流れは完了です。
<h2 id="コールバックでユーザー情報を取得する">コールバックでユーザー情報を取得する</h2>
最後に、ソーシャルログイン後のコールバックでユーザーインスタンスの取得後、ユーザー情報などを取得できるのでメモ程度に雑多に残します。
<pre><code class="hljs language-php">// コールバックでユーザーインスタンスを取得
$user = Socialite::driver('twitter')->user();


$user->getId(); // その SNS で一意の ID
// 123456789

$user->getNickname(); // twitter でいうところの @xxxx
// rito328

$user->getName(); // 名前
// rito

$user->getEmail(); // メールアドレス
// samole@example.com

$user->getAvatar(); // アイコンやアバターの画像 URL
// http://pbs.twimg.com/profile_images/1085152018702905344/jBBrHWeZ_normal.jpg

$user->accessTokenResponseBody;
// => Array
//(
// [oauth_token] => xxxxx-xxxxx
// [oauth_token_secret] => xxxxxxxxxx
// [user_id] => xxxxxxxxxx
// [screen_name] => xxxxx
//)
</code></pre>
$user->getXXX() は全プロバイダ共通なので、どのソーシャルログインでも一定値は取れると思います。
メールアドレスだけ、サービス、もしくは個人の設定、もしくは サービスで作成する APP の権限範囲によっては取得できない（空で返ってくる）とかはあるかもしれません。
$user->accessTokenResponseBody は、OAuth2 なのか OAuth1 なのかによって変わりそう。
<h2 id="まとめ">まとめ</h2>
Laravel Socialite の４系は記述がよりシンプルになったなと感じました。対応している SNS などのサービスも多いので、Laravel でソーシャルログインを実装するのであれば使わない手は無いなと思います。
ただ、Socialite 自体よりも、最近はソーシャルログインさせるための SNS の APP の作成が大変だなと思いました。（なかなか厳しくなってて気軽に作れない。理由書かされたりとか。）
Laravel でソーシャルログインを実装するのであれば Socialite を活用して安全に実現していきたいですね。
<a href="https://github.com/rito328/www.ritolab.com-sample-sources-laravel-socialite-4" rel="noopener noreferrer" target="_blank">[Github] サンプルコード</a>

Laravel には Socialite という、ソーシャルログインを実現するためのパッケージがあります。
今回は Socialite 4.x を利用して SNS のアカウントを使ったソーシャルログイン（OAuth認証）を実装してみます。
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#laravel-socialite">Laravel Socialite</a></li>
<li><a href="#%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">インストール</a></li>
<li><a href="#%E8%A8%AD%E5%AE%9A%E6%83%85%E5%A0%B1%E3%81%AE%E8%BF%BD%E5%8A%A0">設定情報の追加</a></li>
<li><a href="#service-provider-%E7%99%BB%E9%8C%B2">Service Provider 登録</a></li>
<li><a href="#event-listener-%E7%99%BB%E9%8C%B2">Event Listener 登録</a></li>
<li><a href="#%E3%82%BD%E3%83%BC%E3%82%B7%E3%83%A3%E3%83%AB%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E5%AE%9F%E8%A3%85">ソーシャルログインの実装</a></li>
<li><a href="#%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D">動作確認</a></li>
<li><a href="#%E3%82%B3%E3%83%BC%E3%83%AB%E3%83%90%E3%83%83%E3%82%AF%E3%81%A7%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E6%83%85%E5%A0%B1%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B">コールバックでユーザー情報を取得する</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
今回の開発環境は以下の通りです。
<ul>
<li>CentOS 8</li>
<li>PHP 7.4</li>
<li>Laravel 7</li>
<li>Socialite 4.x</li>
</ul>
Socialite のバージョンに関して、本記事では４系を扱います。３系と互換性が無いので、３系の場合は<a href="/entry/33">こちら</a>の記事を参考にしてください。
また、本記事執筆時で最新の Laravel を使います。これ未満のバージョンの動作確認は行っていません。
<h2 id="laravel-socialite">Laravel Socialite</h2>
Laravel Socialite（ソーシャライト） は、ソーシャルログイン（OAuth認証）のインターフェースを提供するパッケージです。これを利用する事で、ソーシャルログインを簡単に実装する事ができます。
Laravel Socialite 
<a href="https://github.com/laravel/socialite" rel="noopener noreferrer" target="_blank">https://github.com/laravel/socialite</a>
Google / Twitter / GitHub / Facebook など、代表的な SNS やサービスなどは一応は網羅されていて、Socialite で導入できます。
他にも対応している SNS やサービスが沢山あるので、詳細は以下を確認してください。（Instagram とか YouTube とか LINE とかまである。Slack とかもいけるみたい）
Socialite Providers 
<a href="https://socialiteproviders.netlify.app/" rel="noopener noreferrer" target="_blank">https://socialiteproviders.netlify.app/</a>
Socialite 4.x を使うためには以下がシステム要件となっています。
<ul>
<li>PHP >= 7.1.3</li>
</ul>
要件としては PHP のバージョンだけですが、Laravel のバージョンも 5.6 以上には上げておく事を推奨します。
（PHP 7.1.3 以上が必要なのは 5.6 からなので個人的な推奨ラインとして。もちろん最新版が理想です。）
<h2 id="インストール">インストール</h2>
Socialite をインストールします。Laravel のルートディレクトリで以下の composer コマンドを実行します。
<pre><code class="hljs language-shell"># socialite install
composer require laravel/socialite
</code></pre>
今回は Twitter アカウントでのソーシャルログインを実装しますが、４系ではアダプタの提供がサービスごとに別々になったみたいなので、Twitter のアダプタもインストールします。
<pre><code class="hljs language-shell"># socialite twitter provider install
composer require socialiteproviders/twitter
</code></pre>
<h2 id="設定情報の追加">設定情報の追加</h2>
予め作成した SNS などの APP 情報設定ファイルに追加します。
<dl class="description_setting">
<dt>config/services.php</dt>
<dd>
<pre><code class="hljs language-php">'twitter' => [
 'client_id' => env('TWITTER_KEY'),
 'client_secret' => env('TWITTER_SECRET'),
 'redirect' => env('TWITTER_REDIRECT_URI'),
]
</code></pre>
</dd>
</dl>
<dl class="description_setting">
<dt>.env</dt>
<dd>
<pre><code class="hljs language-shell">TWITTER_KEY=xxxxxxxxxx
TWITTER_SECRET=xxxxxxxxxx
TWITTER_REDIRECT_URI=http://yourdomain.com/login/twitter/callback
</code></pre>
</dd>
</dl>
<h2 id="service-provider-登録">Service Provider 登録</h2>
サービスプロバイダを登録します。
<dl class="description_setting">
<dt>config/app.php</dt>
<dd>
<pre><code class="hljs language-php">'providers' => [
 .
 .
 .
 \SocialiteProviders\Manager\ServiceProvider::class, // 追加
],
</code></pre>
</dd>
</dl>
<h2 id="event-listener-登録">Event Listener 登録</h2>
イベントリスナーを登録します。
<dl class="description_setting">
<dt>app/Providers/EventServiceProvider.php</dt>
<dd>
<pre><code class="hljs language-php">// 追加
use SocialiteProviders\Manager\SocialiteWasCalled;


protected $listen = [
 Registered::class => [
 SendEmailVerificationNotification::class,
 ],
 // 追加
 SocialiteWasCalled::class => [
 //TwitterExtendSocialite::class,
 'SocialiteProviders\\Twitter\\TwitterExtendSocialite@handle',
 ],
];
</code></pre>
</dd>
</dl>
<h2 id="ソーシャルログインの実装">ソーシャルログインの実装</h2>
初期設定は完了したので、あとはルーティングやコントローラを作成して、OAuth認証を実装していきます。
この辺からのファイル名やパスは公式リファレンスに沿うので、適宜好きな名前やパスにしてください。
コントローラを作成します。以下の artisan コマンドを実行します。
<pre><code class="hljs language-shell">php artisan make:controller Auth/LoginController
</code></pre>
コントローラを定義します。
<dl class="description_setting">
<dt>app/Http/Controllers/Auth/LoginController.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

declare(strict_type=1);

namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use Laravel\Socialite\Facades\Socialite;

class LoginController extends Controller
{
 public function redirectToProvider()
 {
 return Socialite::driver('twitter')->redirect();
 }

 public function handleProviderCallback()
 {
 $user = Socialite::driver('twitter')->user();
 }
}
</code></pre>
</dd>
</dl>
<ul>
<li>redirectToProvider() では、SNS の OAuth認証画面へリダイレクトしています。</li>
<li>handleProviderCallback() では、OAuth認証後に SNS から戻ってきた時の処理（コールバック）を定義しています。ここでは、ユーザー情報を取得しています。</li>
</ul>
基本的にはこれだけです。簡単ですね。
今回は twitter だけですが、別の SNS やサービスの場合も、基本的にはこれと同じで、その分追加（もしくは共通化）すれば実現できると思います。
最後にルーティングを定義します。
<dl class="description_setting">
<dt>routes/web.php</dt>
<dd>
<pre><code class="hljs language-php">Route::get('login/twitter', 'Auth\LoginController@redirectToProvider');
Route::get('login/twitter/callback', 'Auth\LoginController@handleProviderCallback');
</code></pre>
</dd>
</dl>
Twitter でのソーシャルログインを行うためにアクセスしてきた場合のルーティング（上部）と、OAuth認証後に SNS から戻ってきた時のルーティング（下部）を定義しています。
<h2 id="動作確認">動作確認</h2>
実際にブラウザからアクセスして確認してみます。 
http<a href=""></a>://your-domain/login/twitter
Twitter の OAuth認証画面にリダイレクトされ、以下の画面が表示されました。
<div class="img_wrap"><img src="/images/posts/207/4rgJfKfN1u8xd9EPtS7P.png" width="800" height="836" alt="Twitter OAuth 認証画面"></div>
「連携アプリを認証」を押下すろと、ソーシャルログインが行われ、自分のサイトへ戻ってきます。
<div class="img_wrap"><img src="/images/posts/207/KMNWZ2zQblZFb6KALQ9j.png" width="800" height="175" alt="Twitter ソーシャルログイン コールバック"></div>
ここで、ユーザー情報なども一緒に渡ってくるので、あとはそれらを記録したり表示すれば、一連の流れは完了です。
<h2 id="コールバックでユーザー情報を取得する">コールバックでユーザー情報を取得する</h2>
最後に、ソーシャルログイン後のコールバックでユーザーインスタンスの取得後、ユーザー情報などを取得できるのでメモ程度に雑多に残します。
<pre><code class="hljs language-php">// コールバックでユーザーインスタンスを取得
$user = Socialite::driver('twitter')->user();


$user->getId(); // その SNS で一意の ID
// 123456789

$user->getNickname(); // twitter でいうところの @xxxx
// rito328

$user->getName(); // 名前
// rito

$user->getEmail(); // メールアドレス
// samole@example.com

$user->getAvatar(); // アイコンやアバターの画像 URL
// http://pbs.twimg.com/profile_images/1085152018702905344/jBBrHWeZ_normal.jpg

$user->accessTokenResponseBody;
// => Array
//(
// [oauth_token] => xxxxx-xxxxx
// [oauth_token_secret] => xxxxxxxxxx
// [user_id] => xxxxxxxxxx
// [screen_name] => xxxxx
//)
</code></pre>
$user->getXXX() は全プロバイダ共通なので、どのソーシャルログインでも一定値は取れると思います。
メールアドレスだけ、サービス、もしくは個人の設定、もしくは サービスで作成する APP の権限範囲によっては取得できない（空で返ってくる）とかはあるかもしれません。
$user->accessTokenResponseBody は、OAuth2 なのか OAuth1 なのかによって変わりそう。
<h2 id="まとめ">まとめ</h2>
Laravel Socialite の４系は記述がよりシンプルになったなと感じました。対応している SNS などのサービスも多いので、Laravel でソーシャルログインを実装するのであれば使わない手は無いなと思います。
ただ、Socialite 自体よりも、最近はソーシャルログインさせるための SNS の APP の作成が大変だなと思いました。（なかなか厳しくなってて気軽に作れない。理由書かされたりとか。）
Laravel でソーシャルログインを実装するのであれば Socialite を活用して安全に実現していきたいですね。
<a href="https://github.com/rito328/www.ritolab.com-sample-sources-laravel-socialite-4" rel="noopener noreferrer" target="_blank">[Github] サンプルコード</a>

Author