はじめに

最近はかなりのサイトで採用されているソーシャルログインですが、自分で実装したことがなかったので、調査のために環境構築から動作確認までやってみた備忘録です。
キャプチャを残してないので文字ばかりなのはご容赦ください。
バージョンは2023年9月当時のものとなります。
コマンドの実行は基本的にコマンドプロンプトでやっていますが、PowerShellでも問題ないはずです。

環境構築

PHP

PHP For Windows: Binaries and sources Releasesから「PHP 8.2 (8.2.9)＞VS16 x64 Thread Safe (2023-Aug-01 13:08:42)＞Zip」をダウンロード
「C:\php」に解凍
環境変数の「Path」にC:\phpを追加
php -vを実行してPHP 8.2.9と表示されたらOK

Composer

ComposerからComposer-Setup.exeをダウンロード＞実行してインストール（途中でDeveloper modeやProxyを聞かれるが、そのまま進む）
composer -vを実行してComposer version 2.5.8と表示されたらOK

Laravel

「C:\php\php.ini」をエディタなどで開いて、以下2行の先頭の「;」を削除（コメントアウトを外す）
```
;extension=fileinfo
;extension=zip
```
composer global require laravel/installerを実行
インストール開始時に以下のようなメッセージが出る
Changed current directory to D:/Users/xxxx/AppData/Roaming/Composer
環境変数の「Path」にD:\Users\xxxx\AppData\Roaming\Composer\vendor\binを追加（2で表示されたパスに\vendor\binを付けたもの）
laravel -vを実行してLaravel Installer 5.1.0と表示されたらOK

MySQL（MySQL 8 のインストール (Windows 版) - MySQL - ソーサリーフォースを参考にしました）

MySQL :: Download MySQL Installerからバージョンは8.0.34、OSはWindowsを指定してダウンロード（2種類あるけどオンライン／オフラインインストールの違いなのでどちらでも）
サインアップ画面が出るが無視して左下の「No thanks, just start my download.」というリンクからダウンロードする
ダウンロードしたmsiファイルを実行してインストール
Setup TypeはFullを指定
Account and Rolesでrootユーザのパスワードを任意に設定
Connect To Serverでパスワードチェック（設定したパスワードで接続確認）を行う
それ以外は変更せずにNext/Executeで進める
環境変数の「Path」にC:\Program Files\MySQL\MySQL Server 8.0\binを追加
mysql --versionを実行してmysql Ver 8.0.34 for Win64 on x86_64と表示されたらOK

プロジェクト作成

laravel new socialloginを実行（任意のプロジェクト名で）
質問は以下のように回答する
starter kit＞none
testing framework＞1
database＞mysql
cd socialloginでプロジェクトフォルダに移動
php artisan -vを実行してLaravel Framework 10.21.0と表示されたらOK

DB接続、migrate準備

プロジェクト内の以下のファイルを編集
.env
「DB_PASSWORD」にMySQLインストール時に設定したrootパスワードを記載
database\migrations\2014_10_12_000000_create_users_table.php
$table->string('password');を$table->string('google_id');に変更（パスワードログインはしない）
「C:\php\php.ini」をエディタなどで開いて、;extension=pdo_mysqlの先頭の「;」を削除

認証パッケージインストール、migrate実行

cd socialloginでプロジェクトフォルダに移動
composer require laravel/socialiteを実行（エラーが出ずに終了したらOK）
php artisan migrateを実行（データベースを作成するか聞かれるので、「yes」で進む）
mysql -u root -pを実行（パスワードを聞かれるのでrootパスワードを入力）
MySQLにログインできたらuse sociallogin;を実行
desc users;を実行して、passwordカラムがなく、google_idカラムががあればOK

SSL証明書設定（Googleからのリダイレクトがhttpsなので）

curlから「Documentation＞CA bundle＞cacert.pem」をダウンロードして任意の場所に置く
「C:\php\php.ini」をエディタなどで開いて、;curl.cainfo =の先頭の「;」を削除し、cacert.pemをフルパスで記載

Google Cloud Platform（以降はLaravel SocialiteでGoogleログインを実現するを参考にしました）

プロジェクトを作成
「認証情報＞認証情報を作成＞OAuthクライアントID」を以下のように作成
アプリケーションの種類：ウェブアプリケーション
名前：任意
承認済みJavaScript生成元：http://localhost
承認済みのリダイレクトURI：http://localhost/login/callback
クライアントIDとクライアントシークレットが発行される（後で使うのでメモっておく）

実装

cd socialloginでプロジェクトフォルダに移動
php artisan make:controller GoogleLoginControllerを実行してコントローラーを作成

プロジェクト内の以下のファイルを編集
.env

GOOGLE_CLIENT_ID=Google Cloud Platformで発行されたもの
GOOGLE_CLIENT_SECRET=Google Cloud Platformで発行されたもの
GOOGLE_CALLBACK_URL=http://localhost/login/callback（Google Cloud Platformの承認済みのリダイレクトURIと合わせる）

config\services.php
末尾に以下を追記

'google' => [
	'client_id' => env('GOOGLE_CLIENT_ID'),
	'client_secret' => env('GOOGLE_CLIENT_SECRET'),
	'redirect' => env('GOOGLE_CALLBACK_URL'),
],

routes\web.php
末尾に以下を追記（自動で作られていたルーティングは削除）

Route::get('/', [GoogleLoginController::class, 'getGoogleAuth']);
Route::get('/login/callback', [GoogleLoginController::class, 'authGoogleCallback']);

app\Models\User.php
以下のように実装

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Sanctum\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, HasFactory, Notifiable;

    /**
     * The attributes that are mass assignable.
     *
     * @var array<int, string>
     */
    protected $fillable = [
        'name',
        'email',
        'email_verified_at',
        'google_id',
    ];

    /**
     * The attributes that should be hidden for serialization.
     *
     * @var array<int, string>
     */
    protected $hidden = [
        'remember_token',
    ];

    /**
     * The attributes that should be cast.
     *
     * @var array<string, string>
     */
    protected $casts = [
        'email_verified_at' => 'datetime',
    ];
}

app\Http\Controllers\GoogleLoginController.php
以下のように実装

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Laravel\Socialite\Facades\Socialite;

class GoogleLoginController extends Controller
{
    public function getGoogleAuth()
    {
        return Socialite::driver('google')->redirect();
    }

    public function authGoogleCallback()
    {
        $googleUser = Socialite::driver('google')->stateless()->user();
        $user = User::firstOrCreate([
            'email' => $googleUser->email
        ], [
            'email_verified_at' => now(),
            'name' => $googleUser->name,
            'google_id' => $googleUser->getId()
        ]);
        Auth::login($user, true);
        return view('welcome');
    }
}

動作確認

cd socialloginでプロジェクトフォルダに移動
php artisan serve --port=80でアプリを起動
http://localhostに接続するとGoogleアカウント選択画面が表示される
アカウントを選択するとログインが実行され、Laravelのウェルカムページが表示される
MySQLにログインしてusersテーブルにログインしたユーザーのメールアドレスその他が登録されていたらOK

おわりに

環境構築～実装～動作確認のボリュームの尻すぼみ感がすごいですが、実際に設定さえできてしまえば、「Socialiteの機能を使ってGoogle認証に飛ばす＞認証できたら設定したリダイレクト先に飛ばす」だけという、お手軽な実装でソーシャルログインが動きました。
この後はログアウト処理を入れたり、サーバーに乗せて動かそうと考えているので、ネタが溜まったら続編を書くかもしれません。
ソーシャルログインを実装してみようと思っている方の参考になれば幸いです。
また、記事のために実際のコードとは少し変えている箇所があるので、間違いや動かないなどの指摘があればコメントお願いします。

Windowsのローカル環境でLaravelのGoogleログインを実装してみた話