はじめに

Laravel で新規登録機能を実装する方法について、手順とサンプルコードをまとめました。個人の備忘録程度の走り書きとなっておりますが、温かい目で見守っていただければ幸いです。

書こうと思ったきっかけ

個人的に PHP のキャッチアップをしたくて Laravel を学習中です。その過程で、簡単なユーザー登録機能を実装しましたので、忘れないように備忘録として記録します。

内容

ステップ一覧（新規登録機能）

① users テーブルの確認

初期のマイグレーションで含まれています。確認コマンド：

docker compose exec php-app php artisan migrate:status

create_users_table が [Ran] でなければ以下でマイグレーションを実行：

docker compose exec php-app php artisan migrate

② User モデルを確認

app/Models/User.php にあり、編集はまだ不要。

③ AuthController の作成

docker compose exec php-app php artisan make:controller AuthController

④ コントローラの編集

app/Http/Controllers/AuthController.php

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;

class AuthController extends Controller
{
    public function showRegisterForm()
    {
        return view('auth.register');
    }

    public function register(Request $request)
    {
        $validated = $request->validate([
            'name' => 'required|max:255',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:6|confirmed',
        ]);

        User::create([
            'name' => $validated['name'],
            'email' => $validated['email'],
            'password' => Hash::make($validated['password']),
        ]);

        return redirect('/register')->with('success', 'ユーザー登録が完了しました');
    }
}

⑤ ルート設定を追加

routes/web.php

use App\Http\Controllers\AuthController;

Route::get('/register', [AuthController::class, 'showRegisterForm']);
Route::post('/register', [AuthController::class, 'register']);

⑥ Blade テンプレート作成

resources/views/auth/register.blade.php

<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <title>ユーザー登録</title>
</head>
<body>
    <h1>ユーザー登録フォーム</h1>

    @if (session('success'))
        <p style="color:green">{{ session('success') }}</p>
    @endif

    @if ($errors->any())
        <ul style="color:red;">
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    @endif

    <form method="POST" action="/register">
        @csrf
        <label>名前: <input type="text" name="name" value="{{ old('name') }}"></label><br>
        <label>メールアドレス: <input type="email" name="email" value="{{ old('email') }}"></label><br>
        <label>パスワード: <input type="password" name="password"></label><br>
        <label>パスワード（確認）: <input type="password" name="password_confirmation"></label><br>
        <button type="submit">登録</button>
    </form>
</body>
</html>

アクセス確認

ブラウザで次の URL にアクセス：

http://localhost:8080/register

実際の画面

PW制御画面

DB登録後画面

まとめ

Laravel ではコマンドとディレクトリ構成が整理されており、登録機能の追加も簡単でした。

今回のステップを覚えておけば、今後のログイン機能やバリデーション処理にも応用できると思いました...！