概要
Laravel10から11では大きく変更されているが、11から12では大きな変更は無い。
Laravel 11から12への変更点とアップデート方法【注目の新機能まとめ！】 | 東京のWeb制作会社 株式会社クーシー
https://coosy.co.jp/blog/laravel-12/
書籍【Laravel の教科書】Laravel11 対応サポートガイド
https://www.socym.co.jp/download/1408/Laravel11_Support_Guide_1_2.pdf
Laravel 11がリリースされたのだ【Laravel 11 新機能・変更点】 #PHP - Qiita
https://qiita.com/7mpy/items/4f4f7608c5fe44226d3c
環境構築
■準備
\\wsl$\Ubuntu-20.04\home\refirio\docker\laravel\code
C:/windows/System32/drivers/etc/hosts
127.0.0.1 laravel.local
■インストール
$ cd docker
$ curl -s https://laravel.build/laravel | bash
以下を実行。（「./vendor/bin/sail」ではなく「sail」で実行するには、あらかじめ .profile での設定が必要。詳細は Laravel10.txt を参照。）
$ cd laravel
$ sail up -d
Laravel12では、最初にマイグレーションを行っておく必要がある。
マイグレーションを行っていない場合、以下のようなエラーが表示される。
「SQLSTATE[HY000] [2002] Connection refused」
「SQLSTATE[42S02]: Base table or view not found: 1146 Table 'laravel.sessions' doesn't exist」
$ sail artisan migrate
これで、以下のいずれかにアクセスするとLaravelの初期画面が表示される。
http://laravel.local/
http://127.0.0.1/
以下のとおり、Laravel12がインストールされた。
$ sail
Laravel Sail
$ sail artisan
Laravel Framework 12.19.3
以下で終了できる。
$ sail down
次回からは、以下のように利用できる。
$ cd docker/laravel
$ sail
$ sail up -d
$ sail artisan
$ sail shell
$ sail mysql
$ sail npm run dev
$ sail npm run build
$ sail down
バージョンは以下のとおり。
$ sail php -v
PHP 8.4.8 (cli) (built: Jun 9 2025 13:50:18) (NTS)
$ sail composer -V
Composer version 2.8.9 2025-05-13 14:01:37
$ sail artisan -V
Laravel Framework 12.19.3
$ sail node -v
v22.17.0
$ sail npm -v
11.4.2
■トラブル
この「Laravel10.txt」の「トラブル」を参照。
初期設定
■環境の調整
詳細は Laravel10.txt を参照。
docker/8.4 に対して設定を行う。
■デバッグバーの導入
Laravel10.txt と同じ手順で導入。
■認証機能の作成
Breezeは非推奨らしいが、特に警告なども無くインストールできた。
Laravel 12でBreezeが非推奨に？Blade派のための選択肢 - arms inc. Engineers' Blog
https://tech.arms-soft.co.jp/entry/2025/05/28/090000
Laravel12にBreezeをインストールする方法：php.newとBunで環境構築 | 40代からプログラミング！
https://biz.addisteria.com/php_new/
Laravel 12/Sail/WSL/Breeze 開発環境構築まとめ | WEBxREAL
https://webxreal.com/laravel-12-sail-wsl-breeze/
Laravel10のときにあわせて、以下の設定でインストールした。
ただしテストは「Pest」がデフォルトの選択肢となっていた。
$ sail artisan breeze:install
Which Breeze stack would you like to install?
Blade with Alpine
Would you like dark mode support?
No
Which testing framework do you prefer?
PHPUnit
■日本語化
askdkc/breezejp をインストールすると、config/app.php が以下の設定に変更されていた。
'timezone' => 'Asia/Tokyo',
'locale' => env('APP_LOCALE', 'en'),
'faker_locale' => env('APP_FAKER_LOCALE', 'en_US'),
.env では以下の設定に変更されていた。
APP_LOCALE=ja
APP_FAKER_LOCALE=ja_JP
なお APP_FALLBACK_LOCALE は「en」のままだったが、これは「デフォルトの言語に翻訳文字列が含まれていない場合に使用される」言語らしい。
よって上記設定で良さそう。
11.x 多言語化 Laravel
https://readouble.com/laravel/11.x/ja/localization.html
論理削除に対応したCRUDの新規作成例（分類管理を作成）
Laravel10.txt と同じ手順で実装。
複雑なCRUDの新規作成例（記事管理を作成）
Laravel10.txt と同じ手順で実装。
プログラムメモ
> 以下は app/Http/Controllers/Auth/PasswordController.php の内容です。
> ユーザ情報のパスワードを更新しているように見えますが、Userモデルを呼び出していないように見えます。
> どのような仕組みで、パスワードを更新しているのですか？
Laravelの標準認証ではconfig/auth.phpでprovidersに指定されたモデル（通常はApp\Models\User）が使われます。
なので、$request->user()はUserモデルインスタンスを返すことが保証されています。
> $request->user() でUserモデルを扱えるのに、app/Http/Controllers/Auth/RegisteredUserController.php では $request 経由ではなく User::create() のようにユーザモデルを直接扱っています。
> $request で扱っていない理由は何ですか？
「まだユーザがログインしていない状態だから、$request->user()では取得できない」
というのが理由です。
管理画面のレイアウトを変更
左にサイドバーを設けたレイアウトにしてみる。
■resources/views/layouts/app.blade.php
<!DOCTYPE html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="csrf-token" content="{{ csrf_token() }}">
<title>{{ config('app.name', 'Laravel') }}</title>
<!-- Fonts -->
<link rel="preconnect" href="https://fonts.bunny.net">
<link href="https://fonts.bunny.net/css?family=figtree:400,500,600&display=swap" rel="stylesheet" />
<!-- Scripts -->
@vite(['resources/css/app.css', 'resources/js/app.js'])
</head>
<body class="font-sans antialiased bg-gray-100">
<div class="min-h-screen flex flex-col sm:flex-row">
<!-- Sidebar -->
<aside class="bg-white w-full sm:w-64 border-b sm:border-b-0 sm:border-r border-gray-200">
<!-- Logo -->
<div class="h-16 flex items-center justify-between px-4 border-b border-gray-200">
<a href="{{ route('dashboard') }}" class="flex items-center space-x-2">
<x-application-logo class="block h-8 w-auto fill-current text-gray-800" />
<span class="font-semibold text-lg">{{ config('app.name', 'Laravel') }}</span>
</a>
</div>
<!-- Menu -->
@include('layouts.menu')
</aside>
<!-- Main Content -->
<div class="flex-1 flex flex-col">
<!-- Navigation -->
@include('layouts.navigation')
<!-- Page Content -->
<main>
{{ $slot }}
</main>
</div>
</div>
</body>
</html>
■resources/views/layouts/menu.blade.php （新規作成）
<nav class="px-4 py-4 space-y-2 hidden sm:block">
<x-nav-link :href="route('dashboard')" :active="request()->routeIs('dashboard')" class="block w-full">
{{ __('Dashboard') }}
</x-nav-link>
<x-nav-link :href="route('entry.index')" :active="request()->routeIs('entry.index')" class="block w-full">
記事
</x-nav-link>
<x-nav-link :href="route('category.index')" :active="request()->routeIs('category.index')" class="block w-full">
分類
</x-nav-link>
<x-nav-link :href="route('profile.edit')" :active="request()->routeIs('profile.edit')" class="block w-full">
{{ __('Profile') }}
</x-nav-link>
</nav>
■resources/views/layouts/navigation.blade.php
<nav x-data="{ open: false }" class="bg-white border-b border-gray-100">
<!-- Primary Navigation Menu -->
<div class="mx-auto px-4 sm:px-6 lg:px-8 shadow">
<div class="flex justify-between h-16">
<div class="flex">
<!-- Logo -->
<div class="shrink-0 flex items-center">
{{ $header }}
</div>
</div>
<!-- Settings Dropdown -->
<div class="hidden sm:flex sm:items-center sm:ms-6">
<x-dropdown align="right" width="48">
<x-slot name="trigger">
<button class="inline-flex items-center px-3 py-2 border border-transparent text-sm leading-4 font-medium rounded-md text-gray-500 bg-white hover:text-gray-700 focus:outline-none transition ease-in-out duration-150">
<div>{{ Auth::user()->name }}</div>
<div class="ms-1">
<svg class="fill-current h-4 w-4" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20">
<path fill-rule="evenodd" d="M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z" clip-rule="evenodd" />
</svg>
</div>
</button>
</x-slot>
<x-slot name="content">
<x-dropdown-link :href="route('profile.edit')">
{{ __('Profile') }}
</x-dropdown-link>
<!-- Authentication -->
<form method="POST" action="{{ route('logout') }}">
@csrf
<x-dropdown-link :href="route('logout')"
onclick="event.preventDefault();
this.closest('form').submit();">
{{ __('Log Out') }}
</x-dropdown-link>
</form>
</x-slot>
</x-dropdown>
</div>
<!-- Hamburger -->
<div class="-me-2 flex items-center sm:hidden">
<button @click="open = ! open" class="inline-flex items-center justify-center p-2 rounded-md text-gray-400 hover:text-gray-500 hover:bg-gray-100 focus:outline-none focus:bg-gray-100 focus:text-gray-500 transition duration-150 ease-in-out">
<svg class="h-6 w-6" stroke="currentColor" fill="none" viewBox="0 0 24 24">
<path :class="{'hidden': open, 'inline-flex': ! open }" class="inline-flex" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16" />
<path :class="{'hidden': ! open, 'inline-flex': open }" class="hidden" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
</svg>
</button>
</div>
</div>
</div>
<!-- Responsive Navigation Menu -->
<div :class="{'block': open, 'hidden': ! open}" class="hidden sm:hidden">
<!-- Responsive Settings Options -->
<div class="pt-4 pb-1 border-t border-gray-200">
<div class="px-4">
<div class="font-medium text-base text-gray-800">{{ Auth::user()->name }}</div>
<div class="font-medium text-sm text-gray-500">{{ Auth::user()->email }}</div>
</div>
<div class="mt-3 space-y-1">
<x-responsive-nav-link :href="route('profile.edit')">
{{ __('Profile') }}
</x-responsive-nav-link>
<!-- Authentication -->
<form method="POST" action="{{ route('logout') }}">
@csrf
<x-responsive-nav-link :href="route('logout')"
onclick="event.preventDefault();
this.closest('form').submit();">
{{ __('Log Out') }}
</x-responsive-nav-link>
</form>
</div>
</div>
</div>
</nav>
■resources/views/components/nav-link.blade.php
@props(['active'])
@php
$classes = ($active ?? false)
? 'inline-flex items-center px-1 pt-1 font-medium leading-5 text-gray-900 focus:outline-none transition duration-150 ease-in-out'
: 'inline-flex items-center px-1 pt-1 font-medium leading-5 text-gray-500 hover:text-gray-700 focus:text-gray-700 transition duration-150 ease-in-out';
@endphp
<a {{ $attributes->merge(['class' => $classes]) }}>
{{ $slot }}
</a>
■その他
必要に応じて各ページで、コンテンツ用のdivを以下のように調整する。
<div class="py-12">
<div class="max-w-7xl mx-auto sm:px-6 lg:px-8 space-y-6">
↓
<div class="py-8">
<div class="mx-auto sm:px-6 lg:px-8 space-y-6">
引き続き
ファイルアップロードなど必要そうな機能の実装を試すか。
リポジトリを使用するかどうかも考える。