はじめに

Laravelを理解するため実際に簡単なシステムを作ってみよう！それを後で見返せるようにしておこう！という記録です。

もともとPHPの学習のために「PHPのみ」で作っていたものを、Laravelで再現しようとしています。

元のシステム

ログイン
アカウント作成
アカウント情報編集
アカウント一覧
アカウント削除

今回はLaravelのインストールから初期設定や起動まで行います。

Laravelのインストール

composer create-project laravel/laravel hoge

最初にやること

■依存パッケージのインストール

// コンポーザーのインストール
composer install

// npmのインストール
npm install

Composerとは

・PHPの部品係
・composer.jsonに部品のリストがあり、comporser installでそれをプロジェクトのvenderフォルダに入れてくれる。
・データベース用の部品や暗号化の部品などがvenderフォルダに入る。
・venderがないとLaravelは動かない。
・バージョンもチェックして組み合わさるセットだけを選んでくれる。

npmとは

・JavaScript の部品係
・フロント側の部品係でpackage.jsonに部品のリストがあり、npm installで部品を集めてnode_modulesフォルダに入れてくれる。
・npm run devなどのように部品を動かすこともしてくれる。
・Laravelでは主にViteやTailwind CSSのために使われる
・Vite … CSS や JavaScript をまとめて、ブラウザが読める形にする
・Tailwind … ボタンやレイアウトの見た目を整える
Laravel を動かすだけなら Composer だけで足りることもあります。きれいな画面やスタイルを使うなら、npm も必要になります。

■.envファイルの作成

//最低限の内容

APP_NAME="Hoge" //アプリ名
APP_ENV=local // 開発環境
APP_KEY= // アプリケーションキー（空欄だと動かない。php artisan key:generateで生成する）
APP_DEBUG=true // 開発中はエラー詳細を表示
APP_URL=http://127.0.0.1:8000 // 起動用のURL
APP_LOCALE=ja // デフォルトの言語
APP_FALLBACK_LOCALE=ja // 翻訳がない場合のフォールバック（予備選択）
APP_FAKER_LOCALE=ja_JP // Seeder / Factory用
APP_TIMEZONE=Asia/Tokyo // タイムゾーン
DB_CONNECTION=mysql // 接続するデータベースの種類
DB_HOST=127.0.0.1 // データベースのホスト
DB_PORT=8889 // データベースのポート
DB_DATABASE=hoge_db // データベース
DB_USERNAME=root // データベースのユーザー名
DB_PASSWORD= // データベースのパスワード

■アプリケーションキーの生成

php artisan key:generate

セッション暗号化・CSRF などに必要
.env の APP_KEY に生成されたキーが反映する

■日本語化

1.翻訳ファイルの用意

Laravel13ではlangディレクトリが含まれていないので生成する

php artisan lang:publish

lang/en/ に auth.php, validation.php などが作成される。

2.日本語訳の追加

バリデーション・認証メッセージなどをまとめて日本語化できます。
AかBのどちらかを行う。
| やること | A.Laravel-Lang | B.breezejp |
|:---|:---:|:---:|
| lang/ja/validation.php など | ✅ 作る | ✅ 作る（上書き） |
| .env の日本語設定 | ❌ しない | ✅ する |
| config/app.php の変更 | ❌ しない | ✅ する |

// A.Laravel-Lang（翻訳ファイルのみ）：翻訳ファイルjaの追加だけ
composer require laravel-lang/lang laravel-lang/publisher --dev
php artisan lang:add ja

// B.breezejp（設定変更も自動）：翻訳ファイルの配置 + 設定ファイルの書き換え
// 今回はこちらを使用
composer require askdkc/breezejp --dev
php artisan breezejp

Breeze 等のスターターキットは使わなくても、バリデーション日本語化だけ利用できます。

3.固有メッセージの日本語化

システム固有の文言は翻訳ファイルではなく、コントローラや Blade に直接書くか、lang/ja/messages.php を自作して __('messages.login_failed') のように呼び出す

// lang/ja/messages.php（自作例）
return [
    'login_failed' => 'ログイン情報が正しくありません。',
    'logout' => 'ログアウトしました。',
    'login_required' => 'ログインしてください。',
];

4.日本語化の確認

php artisan tinker
>>> __('validation.required', ['attribute' => 'メールアドレス'])

日本語メッセージが返れば OK

ここまででphp artisan serveを実行してもDBを設定できていないのでエラーが出る。
以下でデータベースも設定していく。

DBの用意

1.データベースの作成

左メニューまたは「データベース」タブを開く
データベース名 login_db_laravel を入力
照合順序 utf8mb4_unicode_ci を選択
作成

utf8mb4_unicode_ciについて

・「文字をどう並べ替えて、どう比べるか」のルール

utf8mb4  _  unicode  _  ci
   │          │         │
   │          │         └─ 大文字小文字を区別しない（case insensitive）
   │          └─ 世界中の文字を Unicode ルールで比較
   └─ 4バイト UTF-8（絵文字も保存できる）

・ciはAdmin と admin を同じとみなす
・Laravel のデフォルトもこれ（database.php）
・日本語含む一般的なWebアプリで一般的に使われている
【よく選ばれている理由】
・Laravel のデフォルトと一致する → 設定ミスが起きにくい
・日本語・英語・記号・絵文字をまとめて扱える
・ログイン時のユーザー名比較で、大文字小文字の違いを吸収できる（ci）
・Webアプリではよく使われる定番で、情報も多い

2.DBとの接続を確認

php artisan migrate:status

// まだマイグレーションしていないので　Migration table not found. が出ていればOK

3.マイグレーションの実行

Laravelインストール時にデフォルトで存在しているマイグレーションを実行する

php artisan migrate

作成される主なテーブル:

テーブル	用途
`users`	ユーザー（ログイン認証）
`sessions`	セッション（デフォルト driver が database の場合）
`cache`	キャッシュ（デフォルトが database の場合）
`jobs`	キュー（使用時）

シンボリックリンク

今回はアイコン画像の設定のためにユーザーが画像をアップロードする仕組みを作るため、画像にアクセスできるように以下を実行する

php artisan storage:link

シンボリックリンク...?

・ブラウザからはpublicディレクトリのみ見える
・ユーザーがアップロードした画像はpublicに保存しないほうがいい
・public：ユーザーがアイコンを変更したりで古いファイルが残り続ける＆手動で掃除が必要
・storage：Laravelが古いファイルを自動で削除してくれる！
・storage/app/publicに保存するのが良い　←　ブラウザから見えない...!

・シンボリックリンク（ショートカットみたいなもの）を使うことで、 public/storage/ → storage/app/public/ への近道ができる

実際のアクセス:                                                                          ブラウザ: http://localhost:8000/storage/icons/user123.jpg
              ↓                                                                        public/storage/icons/user123.jpg （入口・近道）
              ↓                                                                        storage/app/public/icons/user123.jpg （実際の場所）

サーバーの起動

php artisan serve

これでLaravelのプロジェクトが問題なく起動します！