Laravelでログイン画面を入口にする方法とfaviconの設定
Laravelアプリのトップページをログイン画面につなぎ、faviconを設定してFly.io上で確認するまでの作業をまとめます。
今回のポイントは次の3つです。
-
/と/loginの役割をルート定義で明確にする -
php artisan optimize:clearとブラウザーのfaviconキャッシュを混同しない - Artisanコマンドを実行している場所と、そこで使われるDB設定を確認する
1. サイトの入口をログイン画面にする
Laravelでは、URLと処理の対応を routes/web.php に定義します。ここでは / を /login にリダイレクトし、/login でログイン画面を表示します。
use App\Http\Controllers\LoginController;
use Illuminate\Support\Facades\Route;
Route::redirect('/', '/login');
Route::get('/login', [LoginController::class, 'create'])->name('login');
Route::post('/login/submit', [LoginController::class, 'submit'])->name('login.submit');
この例では、GET /login が画面表示、POST /login/submit がログインフォームの送信先です。実際のフォームの action、コントローラー、CSRF対策に合わせてURIをそろえてください。
/ にアクセスしたときにリダイレクトせず、直接ログイン画面を表示したい場合は、次のようにも書けます。
Route::get('/', [LoginController::class, 'create'])->name('login');
この場合も /login を別に残すなら、name('login') はどちらか一方のルートにだけ付けます。名前付きルートを重複させないようにしましょう。
Bladeファイルの役割
共通レイアウトとページ固有の内容は、役割を分けておくと管理しやすくなります。
-
resources/views/layouts/app.blade.php:共通のHTML、head、ナビゲーションなど -
resources/views/auth/login.blade.phpなど:ログイン画面固有のフォームや表示 -
resources/views/home.blade.php:ログイン後のホーム画面の例
ログイン画面のBladeから共通レイアウトを継承できます。
{{-- login.blade.php --}}
@extends('layouts.app')
@section('content')
{{-- ログインフォーム --}}
@endsection
ログイン画面を表示するために login.blade.php を削除して、画面内容を app.blade.php に直接書く必要はありません。
auth ミドルウェアでページを保護する
ログイン画面は未ログインの利用者にも表示するため、通常は auth を付けません。auth はログイン後にだけ使える画面を保護するために使います。
Route::middleware('auth')->group(function () {
Route::get('/home', [HomeController::class, 'index'])->name('home');
// 設定画面や日々の記録など、ログイン後のページ
});
未認証の利用者が保護されたページにアクセスしたとき、Laravelは名前付きの login ルートへ誘導します。認証済みの利用者にログイン画面を再表示しないようにする場合は、guest ミドルウェアも検討します。認証の仕組み(独自実装、Laravel Breezeなど)に合わせて設定してください。
2. faviconを作成してLaravelに設置する
favicon(ファビコン)は、ブラウザーのタブやブックマークなどに表示される小さなアイコンです。複数のタブを開いているときにサイトを見つけやすくなり、サイトの印象や認知にも役立ちます。
今回は健康管理アプリのロゴからシンボル部分を切り出して使いました。元のロゴにある文字やキャッチコピーは、faviconのように小さく表示されると読みにくくなるためです。小さな表示でも見分けられるよう、シンプルな形にするのがポイントです。
16 × 16 px、32 × 32 pxはよく使われるサイズの例です。利用するブラウザーや用途に応じて、必要な形式・サイズを用意します。
public に画像を配置する
Webから直接参照する画像は、Laravelの public ディレクトリに置きます。
public/
└── images/
├── logo.png
└── favicon.png
Bladeのheadでfaviconを指定する
共通レイアウトなど、ページの <head> 内にfaviconを指定します。
<head>
<meta charset="UTF-8">
<title>Kenkou Task Manager</title>
<link rel="icon" type="image/png" href="{{ asset('images/favicon.png') }}">
</head>
asset('images/favicon.png') は、アプリのベースURLを考慮した画像のURLを生成します。faviconの指定は、本文にあたる <body> ではなく <head> に置きます。
3. 古いfaviconが表示されるときの確認
新しい画像を設定したのに以前のアイコンが表示される場合は、参照先、配信ファイル、ブラウザーやCDNのキャッシュを順に確認します。
- ページのソースを確認し、faviconのリンクが新しいパスを指しているか確認する。
-
public/favicon.ico、public/favicon.svg、apple-touch-icon.pngなど、以前のファイルが残っていないか確認する。 - 古い
<link rel="icon" href="/favicon.ico">が別のBladeに残っていないか検索する。 - 開発者ツールのNetworkで、faviconのリクエスト先、HTTPステータス、返された画像を確認する。
- 強制再読み込みやプライベートウィンドウ、別ブラウザーでも確認する。
キャッシュの影響が疑われる場合は、faviconのURLに版番号を付けてブラウザーに新しいURLとして取得させる方法があります。
<link rel="icon" type="image/png" href="{{ asset('images/favicon.png') }}?v=2">
php artisan optimize:clear が消すキャッシュ
php artisan optimize:clear は、Laravelが生成した最適化キャッシュや、既定のキャッシュストアにあるキーを削除するArtisanコマンドです。静的画像そのものや、ブラウザー/CDNが保持しているfaviconのキャッシュを直接消すものではありません。
そのため、faviconが更新されないときは、まずブラウザーから実際にどのURLへアクセスしているか、サーバーがどの画像を返しているかを確認します。optimize:clear はLaravelの設定やキャッシュに問題がある場合に検討し、ブラウザーキャッシュの解決策とは分けて考えます。
4. DockerとFly.ioでコマンドを実行する場所
ローカルのWindowsターミナル、Dockerコンテナ、Fly.ioのMachineは、それぞれ別の実行環境です。
今回のローカル設定では、DB_HOST=pgsql はDocker Compose内のデータベースサービス名でした。Dockerネットワークに参加していないWindows上から php artisan を直接実行すると、pgsql というホスト名を解決できず、次のような接続エラーになることがあります。
SQLSTATE[08006] [7] could not translate host name "pgsql"
optimize:clear 自体が常にデータベースを必要とするわけではありません。ただし、既定のキャッシュストアが database である場合など、アプリの設定によってはキャッシュ削除処理がDB接続を必要とし、エラーが表面化することがあります。エラーが出た場合は、コマンドを実行した場所に加えて .env、config/cache.php、DB_HOST、キャッシュストア、DB接続先を確認します。
Fly.ioのMachineでコマンドを実行する
fly machine start は、停止中の指定Machineを起動する操作です。ローカルのターミナルをMachine内へ移すものではありません。fly ssh console はFly.io上のMachineに接続してシェルを開きます。
fly machine list --app kenkou-app
fly machine start <machine-id> --app kenkou-app # 停止中の場合
fly ssh console --app kenkou-app
接続後、Laravelアプリの配置先を確認してから、アプリのディレクトリ内でコマンドを実行します。
cd /app # 実際のアプリ配置先に合わせる
php artisan optimize:clear
Machine IDは環境ごとに異なるため、fly machine list などで確認してから指定します。fly ssh console の接続先や選択されるMachineは、アプリの状態や指定オプションによって変わります。
Fly.io上でコマンドを実行しても、データベース接続が自動的に成功するわけではありません。Fly secretsや環境変数、DATABASE_URL / DB_HOST、Flyのプライベートネットワーク上にあるDB、選択したMachineのアプリ設定が適切である必要があります。
アプリのファイルやBladeを変更した場合は、通常 fly deploy で新しいイメージを反映してから公開サイトで確認します。Machineを起動する操作と、アプリをデプロイする操作は別です。ブラウザーキャッシュだけが原因の場合、再デプロイや optimize:clear では解決しないことがあります。
5. 今回の作業で確認したこと
-
/にアクセスしたときの動作は、routes/web.phpのルート定義で決める。 -
/を/loginにリダイレクトする形と、/で直接ログイン画面を表示する形がある。 -
authはログイン後のページを保護し、ログイン画面自体には通常付けない。 - faviconは小さいため、ロゴからシンボルを切り出してシンプルにする。
- faviconは
publicに配置し、Bladeの<head>から参照する。 - Laravelのキャッシュ、ブラウザーキャッシュ、CDNキャッシュは別々に確認する。
- Docker内の
pgsqlという名前は、WindowsやFly.ioから自動的に見えるとは限らない。 -
fly machine startはMachineの起動、fly ssh consoleはMachineへの接続を行う。 - Fly.ioからDBへ接続できるかは、環境変数やDBの配置・ネットワーク設定に依存する。