WebアプリケーションフレームワークでMVCという設計パターンがあります。Laravelもこの設計に則って開発できます。

MVCとはモデル、ビュー、コントローラと呼ばれるもので構成されていて、それぞれにきちんと役割があります。

モデルはアプリケーションデータやロジックに関する役割があり

ビューは見た目の役割、

コントローラはユーザからの入力に対してビューを返したり、モデルを呼び出したりします。

*   モデル：データやロジック
*   ビュー：見た目（画面）
*   コントローラ：ビューとモデルの仲介役

最初はなかなかイメージが沸かないと思うので、一つずつ見ていくことにします。

### モデル

アプリケーションデータやロジックに関する役割がモデルにはあるといいましたが、具体的には何があるでしょう？

Twitterを例にしてみます。

ユーザはツイートすることができますし、いいねすることができます。ツイートは何回でもできますが、いいねは1つのツイートに対して1回だけしかできません。

![](https://img.implist.dev/production/entry/body/Y3tbR01BMrNZjJspz2DX1BUeLQhmNj0QN2qyOTOV.png)

いいねしたツイートに対していいねをもう一回押せばいいねが消えます。  
ツイートやいいねなどのデータを作る役割がモデルにはあったり、  
いいねが1回しかできない、2回いいね押すと消えるなどのロジックがモデルにはあります。

モデルはデータを作ったり、どういう条件で〇〇するなどのロジックを書く場所だと思って問題ありません。

### ビュー

これはユーザが目にする部分です。

デザインであったりフォームであったり、Twitterのプロフィールやツイートの一覧などビューとなります。  
ビューは一つページ思えば良いでしょう。ま、画面のことですね。

![](https://img.implist.dev/production/entry/body/cdUafZFnsAQr92EYXuZmtzfSDQHDPUd1atxH8DhD.png)

これがTwitterのプロフィールのビューとなります。

### コントローラ

最後はコントローラです。これはビューとモデルとの仲介役です。

例えばツイッターのプロフィールのビューは、

1.  ユーザはコントローラに対してプロフィールの情報がほしいとリクエストをします
2.  コントローラはそのリクエスト通り、プロフィールに関するデータやロジックなどを持っているモデルに対して、〇〇アカウントのプロフィールをよこせといいます
3.  モデルはコントローラに命令されたとおり該当するプロフィールをコントローラに渡します
4.  その後コントローラはプロフィールのビューに取得したデータを渡します

![](https://img.implist.dev/production/entry/body/rxTTILbniQVM3bn9CfwRMc4LefXbbwENZBt4LJKT.png)

コントローラをビューとモデルの間に挟むことによって、柔軟にいろいろなリクエストに答えていくことができます。上の例ではプロフィールだけでしたが、ツイート情報やいいね情報もほしい場合にコントローラはツイート関連のモデルやいいね関連のモデルを呼び出すことで、色々なビューの要望に答えることができます。

これでMVCの概要は把握できたと思うので、次回よりコントローラやビュー、モデルを使って理解を深めて行きましょう。  
まずはコントローラだけを使ってルーティングという処理を行っていきます。

LaravelにおけるMVCとは？図解してみた

今回はルーティング経由でコントローラを呼び出し、さらにそこからビューを表示してみましょう。

イメージでいうと以下の通りです。

![](https://img.implist.dev/production/entry/body/XO1IsZD74NYgvkV2ETSQUTP9g3bFI7vPlBPR7cVk.png)

ユーザがブラウザで/usersにアクセスしたら、ルーティングを呼び出して、そこからコントローラ、ビューを呼び出すといった流れを作っていきます。

今回編集するファイルは3ファイルだけです。

![](https://img.implist.dev/production/entry/body/ac1whNy24WMdBasSE8oXX6BT2f61mcH2JwrJBzUK.png)

Laravelではコントローラはどこのディレクトリにおくとか、ビューはどこにおくとかが予めある程度きまっています。そのルールに従って今回も作成していきます。  
最初ディレクトリ構成が難しいと感じるかもしれませんが、プログラムを書いていくうちに慣れます。

### ルーティング→コントローラ→ビューを作成

#### ルーティングを記述

まずはhttpメソッドGETで/usersにアクセスしたら、UserControllerのallUsersというメソッドを呼ぶ処理を書きます。

```
こんにちは
```

**routes/web.php**  

```php
<?php

use App\Http\Controllers\UserController;  
use Illuminate\Support\Facades\Route;  

Route::get('/users', [UserController::class, 'allUsers']);
```

UserControllerというコントローラのallUsers()メソッドを呼び出すという処理ですね。

#### コントローラ作成

まだコントローラは無いのでUserControllerというコントローラを作成します。

**app/Http/Controllers/UserController.php**

```php
<?php  

namespace App\\Http\\Controllers;  
use App\\Http\\Controllers\\Controller;  

class UserController extends Controller  
{  
   public function allUsers()  
   {  
       return view("users/all");  
   }  
}
```

**return view("users/all");**でビューを呼び出しています。

#### ビュー作成

ビューは〇〇.blade.phpというファイル名で作成します。

**resources/views/users/all.blade.php**  
ユーザ一覧のビュー

最初は文字だけかいておきます。

それはブラウザで/usersにアクセスしてみましょう。すると以下のようにビューに書いた文字が表示されると思います。

![](https://img.implist.dev/production/entry/body/dUf5uuFTxGeF2iZXhg9bq4urIEGjytMSsAF8G2wu.png)

ここまでの流れを図にまとめると以下のようになっています。

![](https://img.implist.dev/production/entry/body/mISYEcmj2YGUFXzy0cUcSXieZXY6RObgekIAd4Jr.png)

### コントローラからビューに値を渡す

例ではビューに文字を表示しているだけですが、これだとあまりコントローラを挟んだ旨味がないので、コントローラからいろいろな値を渡してみましょう。

**UserController.php**
```php
public function allUsers()  
{  
    $value = "たけし";  
    return view("users/all", ["name" => $value]);  
}
```

連想配列でviewの第2引数に渡したい値を渡します。

**resources/views/users/all.blade.php**

```php
ユーザ一覧のビュー  
<div>{{ $name }}</div>
```

ビュー側では**{{}}**を使って$nameで値にアクセスできます。ちゃんと値が渡され表示されるのがわかります。

![](https://img.implist.dev/production/entry/body/bIXD8i8XXYtkYLq2FXAWSIpcdjWmEUb4sKT9t1mI.png)

#### リストを渡して表示してみる

次はユーザ名のリストを渡して見ましょう。

**resources/views/users/all.blade.php**
```php
public function allUsers()  
{  
    $users = [  
        "たけし",  
        "ボブ",  
        "トム",  
        "ジャック"  
    ];  
    return view("users/all", ["users" => $users]);  
}
```

**resources/views/users/all.blade.php**  
```php
ユーザ一覧のビュー  
@foreach($users as $user)  
 <div>{{ $user }}</div>  
@endforeach
```

@foreachで配列を繰り返して値を取り出すことができます。@endforeachまでが繰り返される感じです。  
今回の例だと**<div>{{ $user }}</div>**これが4名分繰り返されます。  
以下のように表示されます。

![](https://img.implist.dev/production/entry/body/Mi0OnEdEMbLi4Z5zjIpZXTprZCvJ2cowkJ1tZZDt.png)

少し工夫して以下のようにulタグとliタグを使って見ると

**resources/views/users/all.blade.php**
```php
ユーザ一覧のビュー  
<ul>  
  @foreach($users as $user)  
    <li>{{ $user }}</li>  
  @endforeach  
</ul>
```

ユーザの名前がリストで表示されます。

![](https://img.implist.dev/production/entry/body/Y17xRH8sIS0mbDLQHg8DoHkftN168yZjo2Baj87M.png)

繰り返しの処理は慣れないと最初イメージがしずらいので、何度も何度も書き直して動きを理解していきましょう。

次回はモデルについて見ていきます。モデルが一番むずかしいと思います。

モデルにはビジネスロジックを扱う側面とデータを扱う側面がありますが、話をシンプルにするため、このシリーズではデータを扱う側面に絞って解説していきます。  
ビジネスロジックを扱う側面については中級編とかでまた解説します。


Laravelのルーティングからコントローラを呼出し、値をビューに渡す

前回ビューとコントローラという概念が出てきました。

ここで学ぶルーティングは、実はビューとコントローラの間に位置するものになります。

ユーザからの色々なリクエストをLaravelのルーティングで受け取って、適切なコントローラへと受け渡します。

![](https://img.implist.dev/production/entry/body/nGLAiav7oEwLGqqP6GQy2hrXLPiWgxZ4KZsgjNMD.png)

図で表すとこんなイメージですね。

今回はコントローラは使わず、いろいろなリクエストをしてルーティングされているかどうか見ていきましょう。

まだLaravelをインストール・動かす環境が出来ていない方は以下を参考に作成してみてください。

[Laravel9+Sail（Docker）で環境構築してみた](https://implist.dev/entries/9cd66a5a4ac17b37907db499d83dce70)

上記記事では、LaravelのSailというツールを使って簡単に環境構築する方法を紹介しています。対象はMac OSですが、PCにDockerさえ入っていればWindowsでも簡単に構築出来ると思います。

### 簡単なルーティングを実践

ルーティングは以下のweb.phpというファイルに記述していきます。

**routes/web.php**  

```php
<?php

Route::get('/', function () {
   dd("ハロー"); // ddはvar_dump();してexit();という感じで、文字を表示して処理を停止させます。便利なので覚えましょう
});
```

ここで行っているのはGETメソッドで「/」にアクセスした時、「ハロー」と表示するということを行っています。

ブラウザ等で「/」にアクセスすると以下の通り表示されます。vagrantで環境を作っている人は「http://192.168.33.10:8080/」で、自分のPC上で環境を作った人は「http://localhost:8080/」でアクセス可能です。

![](https://img.implist.dev/production/entry/body/90iLLFt0mceNevdEpfUv8KBjTHqyT8GtmN2RUUcE.png)

### ごく基本的なルーティング

3つだけごく基本的なルーティングついて抑えておきましょう。この入門編ではこのくらい理解しておけば問題ありません。

**routes/web.php**  

```php
<?php  

Route::get('/users', function () {  
   dd("ユーザ一覧");  
});  

Route::get('/users/{name}', function ($name) {  
   dd("ユーザは$name");  
});  

Route::post('/users', function () {  
   dd("ユーザ登録");  
});
```

#### 1つ目

まず1つ目ははじめの例とやっていることは同じで、「/users」にアクセスしたら、「ユーザ一覧」という文字を表示するというものです。  
これは簡単ですね。

![](https://img.implist.dev/production/entry/body/311PKoAoQQAgmAVr9iXmP0rdoGMSuWz5bvdVK9Ig.png)

#### 2つ目

では2つ目。  
これは「/users/〇〇」に来た〇〇を$nameという変数にいれて、文字を表示するというものです。  
試しにブラウザで「/users/takeshi」とアクセスしてみましょう。以下のようになると思います。

![](https://img.implist.dev/production/entry/body/RHrlyk8KF7Z2QTw9PMjlwr2mOtASqj7SM5F1yIGi.png)

ユーザの詳細ページなどを作る時、ユーザIDをよくこの形式で渡したりします。

#### 3つ目

3つ目はどうでしょうか？  
postが出てきました。1つ目2つ目はgetとなっています。このgetやpostというのはhttpメソッドと呼ばれ、getは主に参照系（ユーザ一覧ページ）、postは登録系（ユーザの登録）などに使われたりします。

ブラウザでURLにアクセスした時すべてのリクエストはgetとなります。postを使用するにはhtmlでフォームを作ったり、Javascriptでpost通信を行ったりする必要があります。

```php
<form action="/users" method="post">  
  <button>送信</button>  
</form>
```

実はLaravelはセキュリティの観点から、上のフォームではPOST通信が拒否されます。

トークンを仕込んで...みたいなことをするのですが、また後の記事で詳しく解説します。  
ここでは、**POSTを使ったルーティングも出来る**ということだけ覚えておきましょう。

ちなみにこの他にもhttpメソッドは以下などがあります。

*   get
*   post
*   delete
*   put
*   patch
*   options

よく使うのはget、post、delete、putくらいです。とりあえずgetとpostだけ覚えておけばOKです。

最後に3つのリクエストとルーティングをまとめると以下の動きになります。どういうリクエストがどういう動きをするのかしっかりと理解しましょう。

![](https://img.implist.dev/production/entry/body/F28e0Z5cNOliHYZBf6gjth3QVHNYIvAA9xkE9qKA.png)

公式ドキュメントがとてもわかり易いので、もっと詳しく知りたい場合は以下を参考にしてください。

[https://readouble.com/laravel/9.x/ja/routing.html](https://readouble.com/laravel/9.x/ja/routing.html)

次回はルーティングからコントローラを使用していきます。

Laravelのルーティングの仕組みと一番簡単な使い方

今回からモデルを作成していきます。

このシリーズではモデルはデータを扱うものとして説明していきますが、モデルは他の側面もあるので、そのことは頭の片隅においておいてください。

### まずはデータを作る

モデルはデータを扱うものといいましたが、そのデータ自体を始めに用意してやる必要があります。コードを書くのはそれからです。

データベースはMySQL5.7という前提で勧めていきますので、用意しておいてください。

#### データベース作成

mysqlに接続しデータベースを作成します。

**SQL**  

```sql
CREATE DATABASE sample_app;
```

#### テーブルの作成

今回は話を簡単にするためusersテーブルだけを作成することにします。  
Laravelの場合は**テーブル名はすべて複数形でというルール**がありますので、userテーブルではなくて、usersテーブルとしています。

**SQL**  

```sql
CREATE TABLE `users` (
    `id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT 'ユーザID',
    `name` varchar(280) NOT NULL DEFAULT "" COMMENT '名前',
    `age` int unsigned NOT NULL COMMENT '年齢',
    `created_at` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '作成日',
 PRIMARY KEY (`id`)  
) COMMENT='ユーザテーブル';
``` 

名前と年齢と作成日くらいは用意しておくことにしましょう。

#### サンプルデータ投入

サンプルデータを一つだけ投入しておきましょう。

**SQL**

```sql
INSERT INTO `sample_app`.`users` (`name`, `age`) VALUES ('takeshi', '20');
```

※普通のシステムだと、例えばSNSサービスでいうと、usersというテーブルや、ユーザがコメントしたときのcommentsテーブルなど、いいねをしたなどのevaluationsテーブルなど作成したりします。

ちなみにDBクライアントツールは「TablePlus」がオススメです！

UIもオシャレで、操作性も抜群に良いです。使い方を、

[【TablePlusの使い方】DB接続してデータ操作をやってみる](https://implist.dev/entries/how-to-use-tableplus)で紹介しているので、ぜひ使ってみてください。

### MySQLとの接続設定

MySQLでデータベース、テーブル、データの用意はできました。  
ではどうやってLaravelとMySQLを接続するのでしょう？

接続の設定は「.env」というファイルを使って行っていきます。

#### .envの設定

.envファイルはプロジェクト直下にあるります。  
.envファイルとはLaravelアプリケーション全体で使ういろいろな設定ファイルのことです。

今回はDBに接続したいので、以下のように記述します。

```
DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=sample_app  
DB_USERNAME=root  
DB_PASSWORD=xjNPUpj.p51?
```

お使いの環境に合わせて行ってください。  
これの設定だけでDBに接続することが可能になります。

#### DBの接続確認

設定は終わりましたが、本当にDBに接続できるようになっているのでしょうか？

Laravelには便利なtinkerと呼ばれるものがあり、これを使うことでLaravelのいろいろな処理を呼び出すことができます。

プロジェクト直下で以下のようにコマンドを叩いてみてください。

```
docker-compose exec laravel.test php artisan tinker
```

これでtinkerの中に入れました

続いて、以下を実行してください

```php
DB::table('users')->get();
```

これはusersテーブルのデータを全件取得するというものです。以下のようにデータが取得できていれば、DBへの接続は成功しています。

![](https://img.implist.dev/production/entry/body/whWMSDo6OTydqkeSQImfMHBhHTGykIqgzVLaAwip.png)

#### DB接続失敗の例

ついでに接続失敗した例も見ておきましょう。

.envファイルのDBのパスワードをテキトーなものに変更してみてください。  
そしてもう一度tinkerにて以下を実行すると

```php
DB::table('users')->get();
```

以下のようにDBへのアクセス失敗のエラーがでます。

![](https://img.implist.dev/production/entry/body/hNYRUb4gf7biKdesefIQQTFjQpaZyrEqmb3PnOn4.png)

.envファイルによって、DBへ接続することが出来るということがわかりました。

次回はDBをLaravelのプログラム上（モデル）からアクセスして、データを取得、viewへの表示など行っていきましょう。  
LaravelをDBと絡めてプログラムを書いていくのは楽しいですよ〜。

Laravelのモデル作成前にDBを用意して、DBの接続確認を行う

前回はtinerを使って、DBに接続してデータを取得しました。  
今回は、プログラムコードを記述してデータを取得して、viewに表示してみるということを行っていきましょう。

データを取得するにはEloquentモデルというものを使います。序盤に説明していたモデルとはこのことを指しています。(<https://implist.dev/entries/17b6a921036f86354f4fe01dec99808b>)

「 Laravelのルーティングからコントローラを呼出し、値をビューに渡す」という記事で値をビューで表示するということを行っているので、データさえ取得できれば、あとは簡単ですね。

※テーブルやデータは前回の内容を使っているので作成していない方は、usersテーブルを作成して、データをinsertしておいてください。

### 特定のユーザーを取得して表示してみる

まずはidが1のユーザーを取得して、viewに表示していきます。

#### 新しいルーティングとviewを作成してデータを表示の準備

まずは、ルーティングとviewファイルを用意しておきましょう。これは今まで学習してきた内容ですね。

__routes/web.php__
```php
<?php    

use App\Http\Controllers\UserController;    
use Illuminate\Support\Facades\Route;    

Route::get('/users', [UserController::class, 'getUser']);  
```

**resources/views/users/index.blade.php**
```php
<div>    
   hello {{ $user->name }}    
</div>
```

#### モデルクラスの作成

**app/Models/User.php** 
```php
<?php  

namespace App\Models;    

use Illuminate\Database\Eloquent\Builder;    
use Illuminate\Database\Eloquent\Model;    

/**    
* @mixin Builder    
*/class User extends Model    
{    
}
```

まずはモデルクラスを作成します。これが必要な理由は、このクラスを通してDBと接続してデータを取得できるからです。Modelというクラスをextendsするだけで、いろいろなメソッドが使えるようになり、なおかつDBと接続してうまい具合に求めるデータを取得することができます。

クラスの命名には注意が必要で、DBにusersというテーブルがあり、このデータが欲しいとするとクラス名はUserにする必要があります。英語は単数形であることに注意です。

このようにDBのテーブルやPHPのクラス名なのをLaravelのルールに従って作成するとこで、データ取得の処理をうまい具合に処理してくれます。

更に詳しい説明はここを参照してください。  
<https://prograshi.com/framework/laravel/model-eloquent-and-query-builder/>

#### コントローラでモデルを使ってデータ取得

**app/Http/Controllers/UserController.php**  
```php
<?php    

namespace App\Http\Controllers;    

use App\Models\User;    
use Illuminate\View\View;    

class UserController extends Controller    
{    
   public function getUser(): View    
   {    
       $user = User::find(1);    
       return view("users/index", ["user" => $user]);    
   }    
}
```

controller内でmodelを使ってデータ取得を取得するコードはあまり良くないですが、今回は簡単に説明したいためcontrollerからモデルを呼ぶことにします。実際はrepositoryとかDaoというようなクラスを作って、データの取得はそこだけで行うようにしたりするのが良いです。

<https://zakkuri.life/laravel-repository/#Controller>  
repositoryというものを用いるのがなぜ良いのかは、こちらの記事の序盤で取り上げられているので、参照ください。

上記のコードで重要なのは、

**$user = User::find(1);**  

という部分ですね。先程作成したUserクラスのfindメソッドに1という引数を渡して、呼び出しています。  
これの意味するところは、「usersテーブルのidが1のデータを取得する」というものです。

今回はid(primary key)を指定して1件だけ取得するという内容ですが、この他にも、

* テーブルの全てのデータを取得する(all)
* 特定条件で複数データ取得する(where)
* 複数のテーブルを結合させて複数データを取得する（join）

などが存在します。

このようにデータの操作クラスであるこのUserクラスなどは、LaravelではEloquentモデルと呼ばれます。また、このようなEloquentモデルを総称して一般的にはORマッパーと呼ばれています。

Eloquentには、他にもたくさんのデータ取得メソッドが用意されているので、詳しくはこちらを参照ください。  
<https://readouble.com/laravel/9.x/ja/eloquent.html>

ちょっとここで$userに入ってるデータをプロットしてみましょう。  
dd()というlaravel付属の関数を使用すると、どういうデータがどのような形式で変数に入っているのかを見やすく閲覧することができます。

**dd($user);**

このように記述して、アクセスすると

![](https://img.implist.dev/production/entry/body/QFdbohg6D80vZkQ5N87wu0r6WtLfCdvyrlxBxTEN.png)

attributesというところに、取得したいデータがはいっています。ちゃんとデータが取得されている事がわかりますね。dd()は便利なので、覚えておくとよいです。

では、dd()の部分はもとに戻して、アクセスしてみます。

![](https://img.implist.dev/production/entry/body/XqeedPRnldpebYCS4lwmB3hd3L9QM6lMe930TbB2.png)

ちゃんとDBに入っているtakeshiというデータが表示されていますね。  
年齢も取得できているはずなのでviewをいじって表示させます。

**resources/views/users/index.blade.php**  
```php
<div>  
    hello {{ $user->name }}, 年齢は {{ $user->age }}歳です。  
</div>
```

![](https://img.implist.dev/production/entry/body/EwRzBLtV8yjkC259Uqb01Vj0o3qBmWGoMDglODZL.png)

ちゃんと年齢も取得できました。

### 全ユーザの取得と表示

次は全ユーザを取得して表示していましょう。  
今はデータが1件しか入っていないので、複数件データ追加しておきます。

```sql
INSERT INTO `myapp`.`users` (`name`, `age`) VALUES ('mitsuru', 23);  
INSERT INTO `myapp`.`users` (`name`, `age`) VALUES ('miho', 60);  
INSERT INTO `myapp`.`users` (`name`, `age`) VALUES ('arisawa', 40);  
INSERT INTO `myapp`.`users` (`name`, `age`) VALUES ('toshio', 50);  
INSERT INTO `myapp`.`users` (`name`, `age`) VALUES ('yokoya', 53);
```

controllerでデータの取得方法を変えていきます。

**app/Http/Controllers/UserController.php**  
```php
public function getUser(): View  
{  
    $users = User::all();  
    return view("users/index", ["users" => $users]);  
}
```

**User::all()**とするとusersテーブルの全てのデータが取得できます。複数のデータが入っているので一応変数名とviewに渡す名前を**users**にしています。

**resources/views/users/index.blade.php**
```php
<div>  
   @foreach($users as $user)  
       <div>  
           hello {{ $user->name }}, 年齢は {{ $user->age }}歳です。  
       </div>  
   @endforeach  
</div>
```

viewではlaravelのテンプレートエンジンであるbladeの機能、@foreachを使って、**$users**をまわしています。  
$userにユーザーのデータが1つずつ入っていくので、あとは先程と同様のコードです。divではさんで改行されるようにしてます。

![](https://img.implist.dev/production/entry/body/4ntkP35gdbV7sAB1OICkhQbtJav3gjvEmjGhKSLb.png)

ユーザーが繰り返し表示されていることが確認できました。このように1つだけのデータや複数のデータを取得するのもかなり簡単にできるのでEloquentの他のメソッドも試してみてください。  
条件を絞り込んだりすることもできるので、例えば30歳以下の人を取得して表示したり、最近追加された人で直帰3人だけ取得するなんてこともできます。

ひとまずデータの取得はこれで以上にになります。次回ユーザーデータの登録や更新、削除といった操作を行っていきます。

今回はデータ取得のみでしたが、次回の登録・更新・削除をマスターすることで、簡単なアプリケーションなら作れるようになります。  
基本的なアプリケーションはCRUDと呼ばれる操作が出来れば、考え方次第で何でも作れますよ。

※CRUDは登録(create)、読込(read)、更新(update)、削除(delete)を意味しています。


Laravel Eloquentモデルを使ってデータを取得して、viewに表示してみる

前回の記事でデータの登録は出来るようになりましたが、入力をチェックするバリデーションが実装されていません。  
ユーザーからの入力は必ずしも正しいものが来るとは限らず、場合によってはいたずらや不正な入力をされる可能性もあります。

Laravelではそれらの値をチェックして、実装者が意図するデータだけを通すというバリデーションの機能が充実しているので、それを簡単に見ていきましょう。  
また、不正な値を入力された場合のエラーメッセージもカスタマイズできます。

### controllerでバリデーションを記述して、エラー表示

まずはcontroller内でバリデーションを書いてみましょう。

**app/Http/Controllers/UserController.php**  

```php
public function create(Request $request)
{
    $request->validate([
        "name" => "required|min:2",  
        "age" => "required|integer|between:20,90"  
    ]);  

    User::create([
        "name" => $request->name,  
        "age" => $request->age,  
    ]);  

    return redirect("users");  
}
```

**$request->validate()** がバリデーションを実行してくれるメソッドです。

引数はkey value形式の連想配列となっており、

バリデーションしたいフィールド => ルール1|ルール2

というような記述となります。「**|**」つなぎでルールを記述することで複数条件のバリデーションが記述可能です。

今回、

* nameは、必須入力、最低文字2文字
* ageは、必須入力、整数、20〜90の数値

というバリデーションルールを設定してみました。  
※ageにしているbetweenは注意が必要で、integerというルールを指定してないと桁数としてバリデーションされるようです。20桁〜90桁の数値というルールになってしまうので気をつけましょう。[参考](https://halfpower.work/2022/04/19/laravel8-%E6%95%B0%E5%80%A4%E7%AF%84%E5%9B%B2%E3%83%90%E3%83%AA%E3%83%87%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%92%E3%81%97%E3%81%9F%E3%81%84%E3%81%AE%E3%81%AB%E6%A1%81%E6%95%B0%E3%83%90%E3%83%AA/)

以下で基礎的なバリデーションを紹介してるので、ざっと目を通してみてください。
[Laravel バリデーションの基礎9選をマスターしよう！](https://implist.dev/entries/laravel-basic-validation)

これらのルールに合致しなかった場合は、後続の処理、今回であればUser::createは呼ばれずに処理が終了します。

![](https://img.implist.dev/production/entry/body/1PUtr7pFPxJ7ZFtormvMrxP9JSaFduyrXkjDCNOg.png)

バリデーションが通らなければ、当たり前ですが後続の処理は実行しないで欲しいですからね。

#### エラー表示

ではバリデーションが通らず、エラーとなった場合はどうユーザーにそれを伝えるのでしょう？  
Laravelではエラーメッセージを簡単に表示することができます。

**resources/views/users/index.blade.php**  

```php
<div>  
    @if ($errors->any())  
        <ul>  
            @foreach ($errors->all() as $error)  
                <li>{{ $error }}</li>  
            @endforeach  
        </ul>  
    @endif  
</div>
```

`<form action="/users" method="post">`
以下省略

このようにエラーがあるかないかは、 __$errors->any()__ で取得でき、存在する場合は __$errors->all()__ で全てのバリデーションエラーが取得できるので、あとはそれを回して表示してあげるだけです。

例えば名前を「a」、年齢を「100」と入力したとすると、

![](https://img.implist.dev/production/entry/body/6CPr3NqkkFH4g6ivKzI3E1dn8SDMa12wWjjlUbFn.png)

このようにエラーが表示されます。  
今はエラーですが、後ほど日本語にカスタマイズしていきます。

### エラーとなった時に、入力した値をフォームに保持させる

上記の例だとバリデーションエラーとなった場合、エラーは表示されますが自分が入力した値が消されてしまいました。

せっかく入力したのに消されてはユーザビリティが悪いですね。  
間違っている入力にせよ、そこから修正できるように入力値は保持させておくのが良いです。

それにはLaravelのヘルパ関数の**old**というものを使用します。

**resources/views/users/index.blade.php**

```php
<form action="/users" method="post">  
    {{ csrf_field() }}  
    <div>  
        <label>名前</label>  
        <input type="text" name="name" value="{{ old('name') }}"/>  
    </div>  
    <div>  
        <label>年齢</label>  
        <input type="number" name="age" value="{{ old('age') }}"/>  
        <input type="submit" value="登録"/>  
    </div>  
</form>
```

nameとageのvalueにそれぞれ**{{ old('name' ) }}**、**{{ old('age') }}**という記述を追加しました。  
Laravelが一時的に入力データを保持しており、oldを使うとその値が取得され、valueにセットされるといった流れになっています。

![](https://img.implist.dev/production/entry/body/xNUpfK6EvQ3RqpNVfha0sUFDHi6Tig4QKxZsyq7Q.png)

実際にバリデーションエラーとなるように入力してみると、入力した値は保持されたままエラーメッセージが表示されているのが確認できます。

### 更新時のバリデーションと値保持

値の新規登録時にバリデーションをつけ、エラーメッセージを表示したり入力値の値保持を行ったりはできるようになりましたが、更新の場合も試してみましょう。

ルールとしては新規登録時と同じにすることにします。

**app/Http/Controllers/UserController.php**  

```php
public function update(Request $request)  
{  
    $request->validate([  
        "name" => "required|min:2",  
        "age" => "required|integer|between:20,90"  
    ]);  

    $user = User::find($request->userId);  
    $user->update([  
        "name" => $request->name,  
        "age" => $request->age,  
    ]);  

    return redirect("users");  
}
```

このバリデーションは新規登録時と同じですね。

次はviewですが、ここが若干変わります。

**resources/views/users/show.blade.php**  

```php
<div>  
    @if ($errors->any())  
        <ul>  
            @foreach ($errors->all() as $error)  
                <li>{{ $error }}</li>  
            @endforeach  
        </ul>  
    @endif  
</div>  

<form action="/users" method="post">  
    @method('PUT')  
    {{ csrf_field() }}  
    <input type="hidden" name="userId" value="{{ $user->id }}"/>  
    <div>  
        <label>名前</label>  
        <input type="text" name="name" value="{{ old('name', $user->name) }}"/>  
    </div>  
    <div>  
        <label>年齢</label>  
        <input type="number" name="age" value="{{ old('age', $user->age) }}"/>  
        <input type="submit" value="更新"/>  
    </div>  
</form>
```

エラーメッセージを表示するところは新規登録時と同じですが、入力した値を保持するところが変わっています。

ヘルパ関数であるoldに2つ目の引数を与えています。

**{{ old('name', $user->name) }}**

これの意味するところは、

* 第1引数: バリデーションエラー発生時に入力した値
* 第2引数: デフォルト値（今回であればDBに保存されている値）

です。  
つまりデフォルト値として、DBに保存されている値が設定されているので、  
詳細ページを開いた時はDBに保存されている値が表示され、  
更新してバリデーションエラーとなった場合は新しく入力した値が表示されるといった具合です。

詳しくは[こちら](https://readouble.com/laravel/9.x/ja/helpers.html#method-old)を参照ください

エラーが発生した場合でも、画面をリロードするとまたデフォルト値としてDBに保存されている値が表示されます。

![](https://img.implist.dev/production/entry/body/HqH9sqT4pVuBSHyTU9B6a3e5as2gDPkOMCl5GDOy.png)

実際にバリデーションエラーを発生させてみると、ちゃんと新しく入力した値が表示されていますね。

### バリデーションをまとめて簡単に書けるフォームリクエスト

先程までバリデーションのルールをcontrollerに記述してきましたが、基本的にはそのようなことはしません。  
なぜならcontrollerがごちゃごちゃするからです。また新規登録時、更新時に同じバリデーションのルールなのに、同じことを2回書くのもあまり良くありません。

バリデーションはバリデーションとして違うファイルで定義するのが良いです。この時使えるのがフォームリクエストです。

まずはapp/Http配下にRequestsディレクトリを作ります。  
そしてその中に以下ファイルを作成してください。

**app/Http/Requests/UserRequest.php**  

```php
<?php  

namespace App\Http\Requests;  

use Illuminate\Foundation\Http\FormRequest;  

class UserRequest extends FormRequest  
{
    public function rules()
    {
        return [
            "name" => "required|min:2",  
            "age" => "required|integer|between:20,90"  
        ];
    }
}
```

詳しい説明は省きますが、先程controllerに記述していたルールがそのまま、このクラスのrules()メソッドに記述されています。

このようにRequestsディレクトリ配下をバリデーションのルールを定義する場所とすると、見通しがよくなります。必要であれば更にディレクトリを作成してもいいでしょう。

フォームリクエストのファイルを作成するだけだと何もおこらないので、次はcontrollerを変更していきます。

**app/Http/Controllers/UserController.php**  

```php
<?php  

namespace App\Http\Controllers;  

use App\Http\Requests\UserRequest; // 追加  
use App\Models\User;  
use Illuminate\Http\Request;  
use Illuminate\View\View;  

class UserController extends Controller  
{  
    public function create(UserRequest $request)　// 変更  
    {  
        User::create([  
            "name" => $request->name,  
            "age" => $request->age,  
        ]);  

        return redirect("users");  
    }  
以下省略
```

createメソッド内のバリデーションはなくなっていますね。  
その代わりに、 **public function create(UserRequest $request)** という記述が増えました。

ここで先程作成したUserRequestクラスを指定しています。  
このように記述するだけで、バリデーションを実行してくれるんです。かなり便利ですよね。

Laravelの公式ドキュメントにも以下のように記述されています。

> どのようにバリデーションルールを実行するのでしょうか？必要なのはコントローラのメソッドで、このリクエストをタイプヒントで指定することです。やって来たフォームリクエストはコントローラメソッドが呼び出される前にバリデーションを行います。

この状態でバリデーションエラーを発生されるように新規登録をすると、

![](https://img.implist.dev/production/entry/body/59FfNb1U0pNLvNR4QZ7whKzvOveoWd0iCHSos6gx.png)

ちゃんとバリデーションが効いているのが分かります。

更新時も、新規作成時のメソッドと同様の記述をすれば、同じくバリデーションが適用されます。

**app/Http/Controllers/UserController.php**
```php
public function update(UserRequest $request)  
{  
    $user = User::find($request->userId);  
    $user->update([  
        "name" => $request->name,  
        "age" => $request->age,  
    ]);  

    return redirect("users");  
}
```

これで、以下ができるようになりました。

* バリデーションの適用
* バリデーションエラーの表示
* バリデーションロジックの共通化

最後にバリデーションエラーメッセージの日本語化を行っていきましょう。

### バリデーションエラーメッセージの日本語化

バリデーションエラーメッセージを日本語するにあたって必要なファイルは3つだけです。

1. バリデーションエラーメッセージのテンプレートファイル
2. アプリケーション言語変更ファイル
3. フォームリクエストファイル（先程作ったバリデーションを記述したクラス）

#### テンプレートファイル

まずはエラーメッセージが記述されているテンプレートファイルを見てみましょう。  
プロジェクト直下のlang/enというディレクトリ配下にvalidation.phpというファイルがあります。

![](https://img.implist.dev/production/entry/body/6zFo41l9ovbewD1cZJ3BoCxhj7l4ndcvH3zANQOO.png)

このファイルに記述されているのは、色々なバリデーションエラーが発生した場合、どういうメッセージを出すかというテンプレートになります。

![](https://img.implist.dev/production/entry/body/Y5gGQCqveakwUraUSj15nKMEB46KiBRQiIctKZTV.png)

ユーザーの新規登録時や更新時にはrequiredというルールを記述しましたが、このルールにマッチしなかった場合は（バリデーションエラーとなった場合）は、上記画像のようなエラーメッセージが表示されます。

![](https://img.implist.dev/production/entry/body/RBBzIqUjJcyEAqqeypmC9GeeI3b6NY6sQllvpn2e.png)

これのことですね。  
**:attribute**というのは、入力した箇所の属性名で、ここではnameと変換されているので、名前のバリデーションエラーになったんだと分かります。

このファイルの内容を変更すればエラーメッセージは変わるのですが、このファイルは変更しないほうが良いです。

なぜかと言うと、このvalidaiton.phpがあるのはlang/**en**というディレクトリの中で、この**en**はenglishを表しており英語版のバリデーションメッセージであるからです。

ほとんどの人が英語版のアプリケーションを作っているわけではないと思うので、日本語用のテンプレートを作成したほうが良いでしょう。enのまま日本語に変更していっても使えるは使えるのですが、正しいものを正しいところに配置するほうが良いので、日本語用テンプレートを作成しましょう。

![](https://img.implist.dev/production/entry/body/CNqzDihplFABpRRFKt10m1JkLsonuS9hkpJiuPZS.png)

と入っても簡単で、lang配下にjaディレクトリを作成して、validation.phpをenからコピーしましょう。  
まだ英語のままなので、以下のように日本語に変更してみます。

![](https://img.implist.dev/production/entry/body/JloAqqVHdEyh4RkHbdmjhCz09yosTB0AyfyehFZM.png)

全部をいきなり日本語化するのは大変なので、最初のうちは必要になったときに変更するくらいで良いでしょう。  
また公式ドキュメントに[日本語用のバリデーションテンプレート](https://readouble.com/laravel/9.x/ja/validation-php.html)もあるようなので、それを初めから使ってもいいかもしれません（日本語訳がおかしい場合があります）。

#### アプリケーション言語変更ファイル

ja用のディレクトリを作成した場合は、実はそのままだとそのファイルは認識されずenのままになってしまっています。

そこで、config/app.phpのlocaleというところをenからjaに変更します。

`'locale' => 'ja',`

こうすることで、jaディレクトリ配下のvalidation.phpが読まれるようになります。

ここで、試しに未入力で新規登録を行ってみると

![](https://img.implist.dev/production/entry/body/iHzVlOus9pfDaAAO5VjLkMUoITLVOekXyrjze26M.png)

ちゃんと日本語になっているのが確認できました。  
ただname、ageが英語のままです。これも日本語にしていきましょう。

### フォームリクエストファイルの修正して属性名を日本語化する

以下の:attribute（属性名）の部分を任意の日本語に変えていきます。

![](https://img.implist.dev/production/entry/body/NAmm1QhLq8A06ZEaBvV0a9ykukg7h9NnmxRsHGnO.png)

テンプレートファイルは変更せずに、先程作成したフォームリクエストのクラスを変更していきます。

**app/Http/Requests/UserRequest.php**  
```php
<?php  

namespace App\Http\Requests;  

use Illuminate\Foundation\Http\FormRequest;  

class UserRequest extends FormRequest  
{  
    public function rules()  
    {  
        return [  
            "name" => "required|min:2",  
            "age" => "required|integer|between:20,90"  
        ];  
    }  

    public function attributes()  
    {  
        return [  
            "name" => "名前",  
            "age" => "年齢",  
        ];  
    }  
}
```

追加したのは、attributes()というメソッドのみで、

* nameを名前
* ageを年齢

となるように修正しました。このようにすることで、バリデーションエラーを発生させてみると、

![](https://img.implist.dev/production/entry/body/D1kaMyY9mH6NZtIyqyE64e1e0Qes11G7foEBUNBi.png)

属性名もそれぞれ日本語に置き換えられ、すべてが日本語のバリデーションエラーメッセージとなりました。

これでバリデーションの実装と、エラーメッセージの表示が出来るようになったと思います。  
バリデーションルールは他にもたくさんありますし、新たにカスタムバリデーションという独自のバリデーションを作ることも出来るので、自身のアプリケーションで必要なれば適宜実装していってください。

これで、Laravel超入門編は完結です。おつかれさまでした。


Laravelでバリデーション実装！エラーメッセージを日本語で表示

Laravel 9.x でサイトマップを作成する方法を紹介します。また自動的に生成されるような設定も行っていきます。

手順

1. サイトマップ生成ライブラリのインストールと設定
2. サイトマップ生成コマンド作成・登録
3. 自動的に生成するようにコマンドを登録

このように、3ステップで簡単にsitemap.xmlが自動生成できます。では見ていきましょう。

以下を前提して話します。

* Laravel 9.x
* PHP 8.1
* composer 2.3.5
* 定期実行はcronを使用する

### サイトマップ生成ライブラリのインストールと設定

[spatie/laravel-sitemap](https://github.com/spatie/laravel-sitemap) というサイトマップ生成ライブラリをインストールします。基本的にはこのライブラリのREADMEに記述されている内容になりますので、不明点ある場合はそちらを参考にしてください。

```
composer require spatie/laravel-sitemap 
```

インストールが完了したら、以下コマンドでsitemapの設定ファイル作成します。

```
php artisan vendor:publish --provider="Spatie\Sitemap\SitemapServiceProvider" --tag=sitemap-config
```

上記が成功すると、**config/sitemap.php** というファイルが作成されます。この内部は特に編集する必要はありません。

このライブラリはguzzleというライブラリが内部で使用され、httpリクエストを自身のサイトに対して行うことでサイトマップを生成していきます。割と原始的ですね。

### サイトマップ生成コマンド作成・登録

インストールと設定が完了したので、次はサイトマップを生成するコマンドを作成します。

#### 作成

今から作るコマンドを実行することで先ほどのライブラリが動いて、sitemap.xmlを生成してくれます。

以下ファイルを作成してください。

**app/Console/GenerateSitemap.php**  
```php
<?php  
namespace App\Console;  

use Illuminate\Console\Command;  
use Spatie\Sitemap\SitemapGenerator;  

class GenerateSitemap extends Command  
{  
   protected $signature = 'sitemap:generate';  
   protected $description = 'サイトマップの生成を行う';  

   public function handle()  
   {  
       SitemapGenerator::create(config('app.url'))  
           ->writeToFile(public_path('sitemap.xml'));  
   }  
}
```

簡単に説明すると、**$signature**がコマンドになって、 **handle()** が実際のsitemap生成処理です。  
**sitemap:generate**というコマンドを実行するとapp.urlに設定されているURLにアクセスして、publicディレクトリにsitemap.xmlというファイルを生成するという意味ですね。

#### 登録

実はまだこのままだと、コマンドがLaravelから認識されていません。コマンド登録を行う必要があります。  
とは言っても簡単で、Kernel.phpにの「追記」の行を足してください。

**app/Console/Kernel.php**  
```php
<?php  

namespace App\Console;  

use Illuminate\Console\Scheduling\Schedule;  
use Illuminate\Foundation\Console\Kernel as ConsoleKernel;  

class Kernel extends ConsoleKernel  
{  
    protected $commands = [  
        GenerateSitemap::class // 追記  
    ];  

    protected function schedule(Schedule $schedule)  
    {  
    }  

    protected function commands()  
    {  
        $this->load(__DIR__.'/Commands');  

        require base_path('routes/console.php');  
    }  
}
```

こうすることで、php artisanで実行できるようになります。

#### 試しに実行してみる

以下コマンドを実行してみると、

```php artisan sitemap:generate```

public/sitemap.xmlが生成されます。

![](https://img.implist.dev/production/entry/body/zy1Qe5WpnWFlzzOElfG24NmX4gjkovVKwAnwbISu.png)

このようにsitemapが記述されているのが分かると思います。生成するときは単純なhttpリクエストによって解析されるので、非公開のルーティングや認証ありのページはここに載りません。

また、これはlocal環境（localの.env）で実行したのでlocalhostとなっています。  
sitemap.xmlは通常Laravelが稼働しているサーバー上で生成することになると思うので、.gitignoreにsitemap.xmlを追加しておくことを推奨します。gitで管理下としても意味がないので。

### 自動的に生成するようにコマンドを登録

ここまでで手動でサイトマップを生成できるようになりましたが、通常は定期的にsitemap.xmlを作成しもらいたいものです。  
そこで今回はcronの定期実行とLaravelのタスクスケジューラの機能を使って実現してみます。

cronは定期的に何らかのコマンドを実行するというもので、LaravelのタスクスケジューラはLaravel上の記法でどのタイミングで実行するかを記述するものとなっています。  
cronでも日時や1時間ごとなど設定はかけますが、その方法だと管理が大変になるのでLaravelを使う場合は通常タスクスケジューラを使用します。  
詳しくは[Laravel タスクスケジュール](https://readouble.com/laravel/8.x/ja/scheduling.html)を参照ください。

#### タスクスケジュールを記述する

まずはLaravelのタスクスケジュールを記述します。先程コマンドを登録したファイルをつかいます。  
「追記」の行を足してください。

**app/Console/Kernel.php**  
```php
<?php  

namespace App\Console;  

use Illuminate\Console\Scheduling\Schedule;  
use Illuminate\Foundation\Console\Kernel as ConsoleKernel;  

class Kernel extends ConsoleKernel  
{  
    protected $commands = [  
        GenerateSitemap::class  
    ];  

    protected function schedule(Schedule $schedule)  
    {  
        $schedule->command('sitemap:generate')->daily(); // 追記  
    }  

    protected function commands()  
    {  
        $this->load(__DIR__.'/Commands');  

        require base_path('routes/console.php');  
    }  
}
```

**$schedule->command('sitemap:generate')->daily();** は見ての通り、sitemap:generateコマンドを1日ごとに実行するという記述です。  
今回は1日に1回実行していきましょう。頻繁にサイトマップを更新したい場合は **hourly()** とかを使うと良いでしょう。

#### cronを設定する

最後にcronからLaravelのタスクスケジュールを実行してみましょう。

```
  * * * * * provider cd /path/to/app && /path/to/php artisan schedule:run >> /dev/null 2>&1
```

cronはご自身の環境に合わせて設定してください。**crontab -e**で記述しても良いですし、**/etc/cron.d/適当なファイル**に記述しても動きます。

* /path/to/app: Laravelアプリケーションを配置したディレクトリ
* /path/to/php: PHPのコマンドのパス

上記はご自身の環境に合わせて設定してください。

このcronは毎分laravelのタスクスケジュールを実行していますね。  
毎分実行することによって、分毎、時毎、日毎でも実行出来ると言った具合です。今回は1日ごとに実行されます。

検証するのであれば、 **daily()** の代わりに **everyMinute()** を使っても良いですね。

これでsitemap.xmlの生成は完了です。サイトマップを作成したならgoogle search consoleに登録するようにしましょう。google botが定期的に覗きに来てくれますよ。

質問等は[こちら](https://www.implist.dev/contact)で受け付けています。


Laravel 9.x で「sitemap.xml」をcronを使って定期的に自動生成する

LaravelにはSailと呼ばれる「Laravel環境を簡単に構築・起動」出来る機能があります。このSailはDockerを利用してMySQLやRedisなどの様々なミドルウェアを追加・Laravelと連携可能になります。メールサーバなども建てられちゃいます。

実際に環境構築を行ったところ、めちゃくちゃ簡単だったので、その方法を解説します。

対象環境は以下です。

* MacOSX
* PHP8.0以上
* Laravel9

### 構築方法

それでは構築を行います。インターネットにつながっている状態で以下コマンドを実行してください。

```
curl -s "https://laravel.build/laravel9-app" | bash
```

ここで「laravel9-app」となっている箇所の名前は何でも良いです。好きに命名してください。  
実行すると、laravelアプリケーションとvendor配下も作られます。  
「Please provide your password so we can make some final adjustments to your application's permissions.」このようなメッセージが出てきたらmacのパスワードを入力してあげてください。

実際にアプリケーションのフォルダ覗いてみましょう

```
cd laravel9-app  
ls
```

このようにディレクトリ群が作られていると思います。

![](https://img.implist.dev/production/entry/body/7gYncsZ7RvZ5kfUyqYYhc27hoJe2ZKiNw6CSSa5o.png)

これで構築は完了です。

### 起動方法

起動方法はsailを使っていきます。  
今まではphp artisanコマンドを使っていたと思いますが、sailコマンドを使います。  
sailコマンドはvendor配下に配置されているので、プロジェクト直下で以下の様に起動します。

```
./vendor/bin/sail up 
```

実行すると、デフォルトでSailが用意しているMySQLやRedis等のDockerコンテナが立ち上がります。  
初回の起動は各種Dockerイメージをダウンロードしてくるので遅いですが、2回目以降はダウンロードしないので高速に起動します。

![](https://img.implist.dev/production/entry/body/9zMOdvao87y9Qg6S04n3ZUObVXMmxo2kwx3RsFSh.png)

ちなみにデフォルトで起動するコンテナは以下のようなものがあります。

* MySQL  
   * データベース
* Redis  
   * キーバリューストア
* MeiliSearch  
   * 全文検索エンジン
* MailHog  
   * メールサーバ
* Selenium  
   * ブラウザ操作自動化ツール

これはプロジェクト直下のdocker-compose.ymlを見るとわかります。不要なものはこのファイルから消して置くと起動が若干早くなりますよ

各種コンテナイメージを取得して、コンテナが起動すると「http://localhost:80」でLaravelにアクセスできます。

![](https://img.implist.dev/production/entry/body/KyXBBYOnP2X3sE5cIZMnTS7f4p9djqVsWUGRMufT.png)

このような画面が表示されれば、成功です。右下にLaravel9.2/php8.1.1と記述されていますね。

ちなみにこのLaravelはDockerコンテナ上(PHPのコンテナ)で動作しています。以下のようなコマンドで、コンテナ上のコマンドが実行できます

```
docker-compose exec laravel.test  php -v  
docker-compose exec laravel.test ls
```

PHPのバージョンを確認したり、lsをすることでLaravelプロジェクトのディレクトリ群がコンテナ上にマウントされているのが分かります。  
「laravel.test」はPHPのコンテナ名です。変更することも可能です

### DB接続

mysqlのコンテナにアクセスしてみます。  
.envにユーザ名、パスワードが記述されているので、それを使ってmysqlコマンドにてアクセスします。

docker-compose exec mysql mysql -usail -ppassword

このようにmysqlの操作ができればOKです

```
mysql> show databases;  
+--------------------+  
| Database           |  
+--------------------+  
| information_schema |  
| laravel9_app       |  
+--------------------+  
2 rows in set (0.01 sec)
```

#### テーブル作成をartisanコマンドで行う

DBとの接続は確認できたので、phpコンテナ側からartisanを使って、テーブル作成を行ってみましょう。  
Laravelプロジェクト作成後、database/migrations/配下にマイグレーションファイルが作成されるのでこれを使います。

以下コマンドを実行します。

```
docker-compose exec laravel.test php artisan migrate:refresh
```

![](https://img.implist.dev/production/entry/body/b9cTmwtjqb5YGHf2bPJ1sbgtQ3MX2V2GL2GmcmBN.png)

このような結果がでればテーブル作成成功です。migrationsディレクトリ配下のマイグレーションファイル通りにテーブルが作成されているはずです。

```
docker-compose exec mysql mysql -usail -ppassword  
mysql> show databases;  
mysql> use laravel9_app;  
mysql> show tables;
```

![](https://img.implist.dev/production/entry/body/K3P4RMSgVuGSQBuR7DqrEpQkt4Rz7z6AL0Cxm0fI.png)

この様にテーブルが作成されていることが分かります。

### よく使うコマンドまとめ

最後によく使うコマンドだけまとめておきます。  
開発の際はこの辺をよく使うので、メモしておくと良いでしょう。

#### Laravel起動

```
./vendor/bin/sail up 
```

#### PHP関連

```
docker-compose exec laravel.test composer install
docker-compose exec laravel.test composer update
```

#### Laravel関連

コントローラファイルを生成する  
```
docker-compose exec laravel.test php artisan make:controller SampleController  
```

モデルファイルを生成する  
```
docker-compose exec laravel.test php artisan make:model Sample
```

#### DB関連

テーブル作成ファイル生成  
```
docker-compose exec laravel.test php artisan make:migration create_sample_users_table  
```

データ作成ファイル生成  
```
docker-compose exec laravel.test php artisan make:seeder SamplesTableSeeder  
```

テーブル・データの投入（すでにDBに入っている場合は削除して投入）  
```
docker-compose exec laravel.test php artisan migrate:refresh --seed
```

今回のようにSailを使わず、Docker+Laravelで環境構築をする方法は[こちら](https://www.implist.dev/entries/laravel8-mysql8-environment-for-docker)で紹介していますので、そちらを使いたい方は参考にしてみてください。

Laravel9+Sail（Docker）で環境構築してみた

LaravelのEloquentでwhere like検索が実行できます。

**ニュース**: Laravel9がリリースされました。[**Dockerを使ったLaravel9の環境構築方法**](https://implist.dev/entries/9cd66a5a4ac17b37907db499d83dce70)をまとめたので、興味ある方は覗いてください。

### やりたいこと

以下のようなusersテーブルがあるとします。  
このusersテーブルのemailカラムに対してlikeで検索をかけたいとします。

LaravelのEloquentを使ってどのように記述するか見ていきます。

```sql
CREATE TABLE `users` (  
 `id` bigint unsigned NOT NULL AUTO_INCREMENT,  
 `name` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL,  
 `email` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL,  
 `email_verified_at` timestamp NULL DEFAULT NULL,  
 `password` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL,  
 `remember_token` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL,  
 `created_at` timestamp NULL DEFAULT NULL,  
 `updated_at` timestamp NULL DEFAULT NULL,  
 PRIMARY KEY (`id`),  
 UNIQUE KEY `users_email_unique` (`email`)  
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
```

ダミーデータはseed+factoryを使って1,000件ほど生成しました。

### Eloquent where likeで前方一致

Eloquentではlikeメソッドなどは用意されていないため、where句の中にLIKEと直書きします。

```php
$users = User::where("name", "LIKE", "Bob%");  
dd($users->get());
```

以下のように取得できました。

![](https://img.implist.dev/production/entry/body/PgKtyaalwcLTJxhCRM07yB7qZTQu62IHYuFT2ZLo.png)

LIKEを使うときはタイプセーフにかけないので、スペルミスなどを注意する必要がります。

### Eloquent where likeで後方一致

%の位置を変えてあげるだけで良いです。

```php
$users = User::where("name", "LIKE", "Bob%");
dd($users->get());
```

### Eloquent where likeで部分一致

こちらも同様です。

```php
$users = User::where("name", "LIKE", "%Bob%");  
dd($users->get());
```

最後に、  
実行実態はSQLを発行しているだけなので、例えばemailにindexがついている場合、それが効くのは前方一致の場合のみです。  
実行されるクエリはtoSQL()などで確認できるので、実行計画を見ながらEloquent使うようにしましょう。


Laravel Eloquentの「where like」で「前方・後方・部分一致」検索する

前回はusersテーブルのデータを、Eloquentモデルを使って取得し表示するということを行いました。

今回はユーザーデータを新規で追加したり、すでにあるデータを更新したり削除したりしていきましょう。  
これが出来れば簡単な動きアプリケーションは作成できます。

以下の流れで行っていきます

1. 新規ユーザーの登録
2. ユーザー詳細ページの作成
3. 一覧に詳細ページへのリンクを付ける
4. 詳細ページでユーザーの更新
5. 詳細ページでユーザーの削除

それでは一つずつ実装していきましょう。

### 新規ユーザーの登録

一覧ページで、新規ユーザーを登録するフォームから作成していきます。

**resources/views/users/index.blade.php**  

```php
<div>
  <div>
    <form action="/users" method="post">
      {{ csrf_field() }}
      <div>
        <label>名前</label>
        <input type="text" name="name" />
      </div>
      <div>
        <label>年齢</label>
        <input type="number" name="age" />
        <input type="submit" value="登録" />
      </div>
    </form>
  </div>
</div>
```

inputのname属性はcontroller側で使うので、name・ageとDBと同じものにしておきます。  
ここで **{{ csrf_field() }}** という記述がありますが、これは一時的なトークンを生成してhiddenでinputに挿入するものです（追加、更新、削除で使用）。  
これはセキュリティのために行われるものですが、なぜそれが必要になるかは[ここ](https://readouble.com/laravel/9.x/ja/csrf.html)を参照してください。

foreachでユーザー一覧を表示しているコードは省略（前回の記事参照）

actionを **/users** 、methodを**post**としているので、routerは以下のような設定にします。

**routes/web.php** 
```php
Route::post('/users', [UserController::class, 'create']);
```

GETリクエスト比べると、**Route::post**になっているだけです。これでacitonがpostのリクエストを受け付けられるようになります。

controllerのメソッドは以下のように記述します。

**app/Http/Controllers/UserController.php**  
```php
public function create(Request $request)  
{  
    User::create([  
      "name" => $request->name,  
      "age" => $request->age,  
    ]);  

    return redirect("users");  
}
```

これがUserのEloquentモデルを通してusersテーブルにデータを書き込んでいるコードです。  
Eloquentモデルではcreateというメソッドが備えられていて、連想配列でusersテーブルの**カラム名=>値**とすることで追加（insert）を行っています。  
今回はformでnameとageを指定しているので、それぞれEloquentモデルでも指定して、新規追加を行っています。

最後の行のredirectは、引数内のパスにリダイレクトする処理です。つまり登録処理が終わったら **/users** に再アクセスされます。

Userクラスは以下のように変更しておいてください。

**app/Http/Models/User.php**  

```php
<?php  

namespace App\Models;  

use Illuminate\Database\Eloquent\Builder;  
use Illuminate\Database\Eloquent\Model;  

/**  
 * **@mixin** Builder  
 */  
class User extends Model  
{  
    const UPDATED_AT = null;  

    protected $fillable = [  
        'name',  
        'age'  
    ];  
}
```

**const UPDATED_AT = null;** はLaravelではデフォルトでupdated_atカラムに対してデータ入れようとするのですが、今回のusersテーブルはupdated_atが存在しないので、その処理を無効化するということをしてます。  
また$fillableに定義した配列では、Eloquentで操作可能なカラムをしていしています。これによりnameとageに対して書き込み処理をすることが可能になります。

実際に/usersにアクセスして、

![](https://img.implist.dev/production/entry/body/wu9MPn7NoWmRAz84GLgZ98XWjJMImV5NsqKCWdAV.png)

名前と年齢を入力し登録ボタンを押すと、新しく一覧に追加されるはずです。↓

![](https://img.implist.dev/production/entry/body/RzQN8d6GYY1KGyRnUrUsKrI610k0klYaAq9UYXhm.png)

### ユーザー詳細ページの作成

次はユーザーの詳細ページを作成していきましょう。

まずは、routerに以下を追加します。

**routes/web.php**  
```php
Route::get('/users/{userId}', [UserController::class, 'show']);
```

今までのルーティングと違って少し特殊で、pathに **{userId}** と入っています。  
ユーザーの詳細ページは **/users/1** や **/users/2** といったURLでアクセスするようにするのですが、この1とか2という数字を取得する必要があります。  
そこで **{}** を使って変数名 **userId** とすることで、controller側でこれが使えるようになります。

以下がユーザー詳細表示用のcontrollerのメソッドですが、 **$request->userId** のようにすることで、routerで指定したuserIdに数字が取得できます。  
ddを使って、dd($request->userId);として、 **/users/1** にアクセスすると1が表示されるので試してみてください。

**app/Http/Controllers/UserController.php**  
```php
public function show(Request $request)  
{  
    $user = User::find($request->userId);  
    return view("users/show", ["user" => $user]);  
}
```

ここではidが1のユーザーを取得して、その情報をusers/showというviewに渡していますね。

**resources/views/users/show.blade.php**
```php
<div>  
   <div>名前: {{ $user->name }}</div>  
   <div>年齢: {{ $user->age }}</div>  
</div>
```

ユーザーの詳細を表示してみます。以下のように表示されれば成功です。

![](https://img.implist.dev/production/entry/body/vBJysXF07U6domLIrP6zQqZrJElECp3tilRro1rP.png)

### 一覧に詳細ページへのリンクを付ける

一覧から詳細ページにリンクさせてみます。今のままだとidをURLに直接打たないといけないので、使いづらいからです。

といっても非常に簡単で、$usersにはidが含まれているので、それを使ってaタグでリンクを作成してあげればOKです（追加フォームは省略しています）。

**resources/views/users/index.blade.php**  
```php
@foreach($users as $user)  
 <div>  
   {{ $user->name }}, 年齢は {{ $user->age }}歳です。  
   <a href="/users/{{ $user->id }}">編集</a>  
 </div>  
@endforeach
```

以下のように表示されていれば問題ありません。実際に編集リンクをクリックすると、該当のユーザー詳細ページ遷移します。

![](https://img.implist.dev/production/entry/body/CHUOL1YuPVd7MyA1Mm3zX8TvFRqrY94MLzHSYAAt.png)

### 詳細ページでユーザーの更新

次は、ユーザーの更新を行います。  
先程作った詳細ページをフォーム化して、ユーザー情報を更新できるようにしていきます。

#### viewの変更

![](https://img.implist.dev/production/entry/body/32DHptXaZupNgPLviz2qj5RSTyPlwM71kdo5381L.png)

このような画面を作ります。URLはユーザーIDである7が入っています。この7という情報から、DBに保存されているデータを取得してフォームに表示していきます。

詳細ページのview配下のように書き換えてください。

**resources/views/users/show.blade.php**
```php
<div>
  <div>
    <form action="/users" method="post">
      @method('PUT')
      {{ csrf_field() }}
      <input type="hidden" name="userId" value="{{ $user->id }}" />
      <div>
        <label>名前</label>
        <input type="text" name="name" value="{{ $user->name }}" />
      </div>
      <div>
        <label>年齢</label>
        <input type="number" name="age" value="{{ $user->age }}" />
        <input type="submit" value="更新" />
      </div>
    </form>
  </div>
</div>
```

少し記述が一つずつ説明します。

##### **@method('PUT')**

formのactionとmethodについてですが、これはユーザー新規追加時と全く同じです。これでは新規追加の処理が実行されそうですが、

@method('PUT')という記述述により、methodをpostからputに上書きしています。  
実際のHTMLは以下のようになっています。 

**<input type="hidden" name="method" value="PUT">**

formタグのactionはgetとpostしかサポートしていないので、直接記述する方法はありません。ですが、Laravelの **@method** を使うと上記のHTMLが差し込まれ上書きされると言った具合です。

**{{ csrf_field() }}** は新規追加時と同様セキュリティのためです。

##### **<input type="hidden" name="userId" value="{{ $user->id }}"/>**

これはどのユーザーを更新するべきなのか判断するために使います。idを指定することで、controller側で該当のユーザーを検索し、入力された値で更新すると言った具合です。

##### すでに保存されているデータをデフォルト値として表示

以下の記述は、フォームにデフォルト値を設定するためのもです。新規追加時とほとんど一緒ですが、valueにnameやageを設定していることで、すでに入力済み（保存済み）のデータということがより分かりやすくなります。

**<input type="text" name="name" value="{{ $user->name }}"/>**  
**<input type="number" name="age" value="{{ $user->age }}"/>**

##### 更新処理のルーティング

routerは以下の様にしておきます。

**routes/web.php**  
```php
Route::put('/users', [UserController::class, 'update']);
```

formでPUTを指定していたので、ここでもputとしています。

#### controllerで更新処理記述

いよいよ更新処理です。これも結構簡単に記述することができます。

**app/Http/Controllers/UserController.php**  
```php
public function update(Request $request)  
{  
    $user = User::find($request->userId);  
    $user->update([  
        "name" => $request->name,  
        "age" => $request->age,  
    ]);  

    return redirect("/users");  
}
```

まず **<input type="hidden" name="userId" value="{{ $user->id }}"/>** でuserIdを送信していたので、$request->userIdを使って該当のユーザーIDを取得して、findで検索をかけます。

その後、$userには更新対象のユーザー情報が入っており、updateメソッドに連想配列を渡すことで、更新処理完了します。  
$userにはidがすでに入っている状態なので、nameとageだけを指定してあげれば、更新可能です。

処理が完了したら、/usersにリダイレクトして、一覧ページを表示するようにしています。 

![](https://img.implist.dev/production/entry/body/jdTiDH8AeHZIFza9Y4tckjZv8jseZpuvGNxvXMRl.png)

名前と年齢を変更して更新ボタンを押すと↓のように更新されていることが確認できます。

![](https://img.implist.dev/production/entry/body/e1HdaWFkFkS3Rpp9sHZKJVT7RXtOHVGSMY03OkUz.png)

ちゃんとbob2になっており、年齢も42に更新されていますね。

### 詳細ページでユーザーの削除

いよいよ最後のユーザー削除を実装していきます。

削除機能はユーザー詳細ページに追加します。以下のようになります。

![](https://img.implist.dev/production/entry/body/TXWRB5gce3lZW3nNKNMUNp8kGz5rmHQloNdvdVyn.png)

まずユーザー詳細のviewに追記をしていきます（更新フォーム部分は省略）。

**resources/views/users/show.blade.php**  
```php
<form action="/users" method="post">  
  @method('DELETE')  
  {{ csrf_field() }}  
  <input type="hidden" name="userId" value="{{ $user->id }}"/>  
  <input type="submit" value="削除"/>  
</form>
```

更新時と同様に **@method('DELETE')** でmethodを上書きしていき、 **{{ csrf_field() }}** でセキュリティ対策を行います。

削除処理は、ユーザーのIDさえ分かれば、実行できるので以下が重要です。

**<input type="hidden" name="userId" value="{{ $user->id }}"/>**

これを送信して、該当ユーザーを検索し削除していきます。

routerは以下になります。

**routes/web.php**  
```php
Route::delete('/users', [UserController::class, 'delete']);
```

controllerは以下になります。

**app/Http/Controllers/UserController.php**  
```php
public function delete(Request $request) 
{
    $user = User::find($request->userId);  
    $user->delete();  

    return redirect("/users");  
}
```

更新時と同様にユーザーを取得します。削除なのでdelete()を呼んでいます。  
削除処理が完了したら、/usersにリダイレクトさせています。

削除ボタンをクリックして以下のようにbob2が一覧から消えていることを確認しましょう。

![](https://img.implist.dev/production/entry/body/YFJzD69gS8mv97cacjLzxsqGwJp8xjEo6Q2WcK1a.png)

ここまで、Laravelを使ったデータの追加、更新、削除が行えるようになりました。  
こでCRUD処理はバッチリだと思いますので、色々テーブルを変えたりして試してみると良いでしょう。

ここまで出来た方は小さなアプリケーションであれば作れるようになっているはずです。

ただ今は名前や年齢が未入力の場合や、DB定義以上の文字列を入力された場合も処理を受け付けてしまいます。試しに未入力で登録をしようとすると以下のようなエラーが出ます。

![](https://img.implist.dev/production/entry/body/4Aqs9McR8ce6W5D4asmxZ2ZSMsi6rCRV1s3yrSor.png)

これはDBのusersテーブルのnameカラムは未入力（null）を許可していないので、入力しろとDBに言われています。  
DBではこのように弾かれるのですが、アプリケーションの利用者にこのようなエラーを出すとビックリしてしまうと思います。なので適切なメッセージをだしたり、DBの処理を呼ぶ前に事前にチェックしたいものです。

このチェックをバリデーションと呼び、バリデーションではアプリケーション提供者が意図する形式であることを保証することができます。  
次回は簡単なバリデーションを作成して、最低限安全でユーザーに優しいアプリケーションに改良していきましょう。


Laravel Eloquentでデータを追加・更新・削除を行う

Laravelではたくさんの認証の仕組みがあるのですが、その中でも一番スタンダードでユーザー登録機能やログイン機能がデフォルトでついている「Breeze」というものを使って、認証機能を作っていきます。

こちらが公式ドキュメントです▶[Laravel Breeze スターターキットドキュメント](https://readouble.com/laravel/9.x/ja/starter-kits.html)

Breezeを使うことで、認証に必要なルーティングやコントローラー、ビューなどが自動生成され、自分で実装する必要がありません。

もちろんカスタマイズすることも出来るので、認証時にあれこれチェックしたいなどあれば手を加えてみても面白いですよ。

Laravelをまだインストールしていない方は以下を参考にインストールしておいてください。

[Laravel9+Sail（Docker）で環境構築してみた](https://implist.dev/entries/9cd66a5a4ac17b37907db499d83dce70)

インストール時にデフォルトで作成されているユーザーモデルや、userテーブルなどを使用しようするので、初期状態が一番操作しやすいと思います。

### Breezeのインストール

まずはsail up。

sail upしてLaravelやMySQLなどのDockerコンテナを起動しておきましょう。

```
./vendor/bin/sail up 
```

バージョンが古いとBreezeのインストール後うまく機能しない場合がるので、composer updateを行って起きます（たまにバージョンのコンフリクトで怒られます）。

docker compose経由でコンテナ内のコマンドを実行しています。先に紹介した記事で環境構築した方は、以下の様にコンテナ内のコマンドを実行できます。

composer updateします。
```
docker compose exec laravel.test composer update
```
**docker compose exec laravel.test**をエイリアスと定義しておくとコマンド実行時便利です。

breezeのライブラリインストール
```
docker compose exec laravel.test composer require laravel/breeze --dev
```

breezeのセットアップ
```
docker compose exec laravel.test php artisan breeze:install
```
このコマンドを実行すると色々とインタラクティブで聞かれます。

![スクリーンショット 2023-02-11 23.10.17](//images.ctfassets.net/2kcyx6q7ww5g/3K429R0mbbTYT9UMXIoNmJ/514bd092ec3b11891fd7660d204df89d/____________________________2023-02-11_23.10.17.png)

今回はBladeで画面を作成していきたいので、最初の質問は0を指定します。

2番目の質問はダークモードにするかきかれています。かっこいいのでダークモードを選択するべくyesを入力します。

3はテストのツールに聞かれているんですが、これは今回どうでもよいのでnoとしておきましょう。

インストールが完了すると以下のように、ファイルがたくさん追加編集されているのが分かります（git statusです）。

![スクリーンショット 2023-02-11 23.13.34 1](//images.ctfassets.net/2kcyx6q7ww5g/7JQfil4mBYiSjWdFqTvs9u/aac99d9afbef28cf4c051ee9733fa2e0/____________________________2023-02-11_23.13.34_1.png)

追加編集されたファイルを眺めると、ルーティングが変更されていたり、ビューのbladeファイルが沢山追加されています。これで画面が構成されているようです。

また、デザイン周りで言えばtailwindが追加されています。エンジニアに人気のtailwindを入れてくれているのは結構嬉しいですね。

Tailwindはについては以下が参考になりますよ。

[■Tailwind環境をシンプルに構築](https://tech-lab.sios.jp/archives/31667)

テーブル作成
```
docker compose exec laravel.test php artisan migrate
```
データに関してはBreezeで追加されたものはありません。Laravelインストール時にデフォルトで入っているユーザーテーブルを使って登録やログインが可能です。楽ですね。

すでにあるアプリケーションにBreezeを入れようとした時、ルーティングのキャッシュが残っている可能性があるので、以下実行しておくと良いです。
```
docker compose exec laravel.test php artisan route:clear
```

あと少しです。tailwindはnpmを使ってビルドして上げる必要があるので、以下を実行しましょう。
```
docker compose exec laravel.test npm install
docker compose exec laravel.test npm run dev
```

これでtailwindがビルドされていい感じのデザインになります。tailwindビルドしなくてもログイン機能等に機能的な問題はないのですが、デザイン0の質素な画面になるのでモチベーションが下がります。

これで準備は全部おわりなので、「[http://localhost:80](http://localhost)」にアクセスしましょう。

すると右上にRegisterというリンクが出来ています。これを押すと

![スクリーンショット 2023-02-11 23.28.59](//images.ctfassets.net/2kcyx6q7ww5g/4EyOzeoUWAFvhfQZWbdhc5/8fe6c660c171a00ed9a1a3df8439d3f7/____________________________2023-02-11_23.28.59.png)

ユーザー登録画面に遷移します。ここで必要な情報を適当に入力して、REGISTERを押します。

![スクリーンショット 2023-02-11 23.23.37](//images.ctfassets.net/2kcyx6q7ww5g/44eEpBcPb6MS6AXSrP2YBt/87ef5ee9c03e5182e4bed12fb390332c/____________________________2023-02-11_23.23.37.png)

登録が完了したら以下のような画面になります。
これでユーザー登録が完了して、ログインもしている状態になります。

右上を見るとtestというユーザー名が表示されているので、ログインしていることが分かります。右上のtestを押すとログアウトボタンが出てくるので、ログアウトしてみてください。

![スクリーンショット 2023-02-11 23.23.44](//images.ctfassets.net/2kcyx6q7ww5g/51LlLTsWA2KdFnZ0Da9MCp/8f39b82102bc62c1f71d37b032b11312/____________________________2023-02-11_23.23.44.png)

またTOPに戻るので、右上のLog inを押して、ログインページに遷移します。

先程登録したメールアドレス、パスワードを入力してログイン出来ることを確認しましょう。

![スクリーンショット 2023-02-11 23.24.01](//images.ctfassets.net/2kcyx6q7ww5g/ub77b1r1UftpODa3lwKbq/20b76c3717f242e9c9e25d5c113501a2/____________________________2023-02-11_23.24.01.png)

これでユーザー登録、ログイン機能の実装ができました。

実装といっても、勝手にコードは生成されるので、コードとしては何ひとつ記述していません。

次からログイン画面を変更してみたり、ログイン中のユーザー情報を取得して、他のデータと紐付けたりして、よりアプリケーションっぽいものを作っていきます。

認証機能が使えるようになったら、様々なアプリケーションが作れるようになるので、開発の幅がぐっと広がります！


Laravel Breezeで「ユーザー登録・ログイン」認証機能を作る！

本記事ではLaravelで使うValidationの基礎且つ頻出の9つを紹介します。

例えばメールアドレスを入力する際に、ひらがなやカタカナなどの文字を使うことはないと思います。
そこで入力できる内容を限定しようというのがバリデーションです。

本記事では、基礎的でよく使う下記のバリデーションを紹介していきますので是非ご活用ください！

※具体的なコードの記述方法については下記の記事で紹介しております。
参考→[Laravelで簡単にバリデーションを実装してエラーメッセージを表示してみる（日本語化も）](https://implist.dev/entries/149d22b000f2dd4ce42510b9efb524a1)

1. required　====>　入力必須
2. email　====>　メールアドレス形式であるかどうか
3. numeric　====>　数値であるかどうか
4. integer　====>　整数であるかどうか
5. max:値、min:値　====>　最大（最小）入力文字数設定
6. between:min,max　====>　minからmaxの間であるかどうか
7. alpha_num　====>　英数字であるかどうか
8. date　====>　日付であるかどうか
9. nullable　====>　任意入力

### 「required」で入力を必須化するバリデーション

まずは入力必須とする「required」のバリデーションです。
会員登録の入力フォームやお問い合わせフォームなどでは、必ずと言ってよいほど使われています。

主に必ず入力してもらう必要があるものに設定され、お問い合わせフォームで使われる場合は、お名前や連絡先に「required」のバリデーションが使われることが多いです。

設定すると下の画像のように「required」を設定した項目に対して未入力のまま「登録」をクリックしてもエラーとなり、未入力のままではリクエストが受け付けられないようになります。

![laravel validation required](//images.ctfassets.net/2kcyx6q7ww5g/6LvEzC8hROn1YUrLxDodW1/bdf77200dfe581db6024b80ea7f6a636/required__1_.png)

尚、エラーメッセージは英語で表示されますが、日本語へ変更やカスタマイズも可能です。
詳しくは下記の記事で紹介していますので必要に応じて参照ください。

参考→[Laravelで簡単にバリデーションを実装してエラーメッセージを表示してみる（日本語化も）](https://implist.dev/entries/149d22b000f2dd4ce42510b9efb524a1)

### 「email」で入力をメールアドレス形式に限定するバリデーション

次はメールアドレス形式に限定する「email」のバリデーションです。
メールアドレス形式とは具体的には@の前後に何らかの文字等が入力されていないとエラーにしてくれます。

「email」を設定すると＠を含めなかった場合は下記の画像のようにエラーになり、リクエストが受け付けられないようになります。

![laravel validation email](//images.ctfassets.net/2kcyx6q7ww5g/61x6RlgZnxTXQq4YhNr1tI/6d3f091be7b8d366f9176a808f2d9724/email.png)

### 「numeric」で入力を数値に限定するバリデーション

次は入力を数値に限定する「numeric」のバリデーションです。
年齢などの「数値のみ」を受け付けるフォームによく使われます。

「numeric」を設定した年齢の欄に数値以外を入力するとエラーとなり、リクエストが受け付けられないようになります。

![laravel validation numeric](//images.ctfassets.net/2kcyx6q7ww5g/72MXlTEUl7Zc37bDDNM1QI/995be4b85d18065e38468b7715b67828/numeric__1___1_.png)

### 「integer」で入力を整数に限定するバリデーション

次は入力を整数に限定する「integer」のバリデーションです。
これも年齢を入力するフォームと相性が良いです。
「私は20歳と６か月だから20.5歳です」とは表現しないですよね。
したがって年齢は基本的に整数で入力されます。

上記の「numeric」は「20.5」のような小数点を含む数値でもリクエストが受け付けられることに対して、「integer」は「20」のような整数のみのリクエストが受け付けられるという違いがあります。

例えば「integer」を設定した年齢の欄に小数点を入力するとエラーとなり、リクエストが受け付けられないようになります。

![laravel validation integer](//images.ctfassets.net/2kcyx6q7ww5g/6usVjUyen1g3XLRYV0ZXHx/157a2d43138487eae197b11fc77d691e/integer__1___1_.png)

### 「max:値」、「min:値」で最大（最小）入力文字数を設定するバリデーション

次は入力文字数を設定する「max:値」と「min:値」のバリデーションです。

文字数に決まりがあるようなフォームによく使われます。
例えば日本人の名前の場合は漢字で書いた場合、フルネームでも10文字以上になる方はなかなかいらっしゃらないと思います。
そこで名前の入力フォームに「max:10」と設定すると、入力文字数は最大でも10文字以内となり、11文字以上入力するとエラーとなり、リクエストが受け付けられないようになります。

![laravel validation max](//images.ctfassets.net/2kcyx6q7ww5g/7ivozh1lQbn8EgiA6UNHfI/070fa0d3d4e69d4af83a74cb5cd5b1e8/max__1___1_.png)

#### 「max:値」または「min:値」を設定して数値を入力すると最大値と最小値が設定される

入力文字数を設定する以外に「max:値」または「min:値」は、数値を入力した場合は最大値と最小値を設定することになりますので注意が必要です。

例えば、年齢などの特定値以上を入力しなければならないフォームの場合は「min:1」と設定することで、1以上のみ入力できるようになります。
それはつまり、もし0歳の子供の代わりに親が入力する場合（あまりないと思いますが）、年齢欄に「0」と入力するとエラーになってしまいます。

![laravel validation min](//images.ctfassets.net/2kcyx6q7ww5g/3L75ELQ3ysgQx4rBl18u9i/048170febc46657b969c159e431190ff/min__1_.png)

なので上記の場合は「0」でも登録が可能にするために、「min:1」を設定するというよりかは最初に紹介した「required」を設定するという方法が良いでしょう。

### 「between:min,max」で入力値をminからmaxの間に限定するバリデーション

次は入力値をminからmaxの間に限定する「between:min,max」のバリデーションです。
範囲を指定できるのでこれも年齢と相性が良いと言えるでしょう。
例えば年齢の入力欄を0歳～100歳の範囲で設定することができます。
その場合「between:0,100」のようにminとmaxのところをそれぞれ数値に置き換えます。

「between:0,100」を設定している状態で「101」と入力するとエラーとなり、リクエストが受け付けられないようになります。

![laravel validation between](//images.ctfassets.net/2kcyx6q7ww5g/soInzFwbPFFYXf2yW02th/a0756cbaa431b11330e1187578918685/between__1_.png)

### 「alpha_num」で入力を英数字に限定するバリデーション

次は入力を英数字に限定する「alpha_num」のバリデーションです。
これは英数字のみの入力に限定したい場合と相性が良いです。

「alpha_num」を設定している状態で英数字以外の記号などを入力するとエラーとなり、リクエストが受け付けられないようになります。

![laravel validation alpha_num](//images.ctfassets.net/2kcyx6q7ww5g/1dyoC0SRYbbp7vSNWf6pJZ/9acdadfe0ca628e3cee244c25271370a/alpha_num__1_.png)

### 「alpha_num」は全角をチェックできないので要注意！

「alpha_num」は英数字に限定するバリデーションなのですが、実はその対象は半角文字だけです。

それはつまり全角文字のひらがなやカタカナ、漢字は英数字ではないにもかかわらずエラーになりませんので注意が必要です。
※英語を想定してつくられているので、そもそも日本語でしか使わない全角という概念がないことが要因と考えられます。

したがって下の画像のようにパスワードに「alpha_num」を設定していた場合で全角ひらがなで入力するとエラーにならず登録できてしまいます。

![laravel validation alpha_num 注意点](//images.ctfassets.net/2kcyx6q7ww5g/5S1sG4ZYGeGad4gdOGfxOF/e551e634a72687754b43ae4205e41a6e/alpha_num___________1_.png)

全角をエラーにする仕様も実装可能です。
しかし最初から準備されているバリデーションはないためバリデーションルールを自作する必要があります。
ここでそれを行うと長くなりすぎるので後日別の記事で紹介しようと思います。

### 「date」で入力を日付の形式に限定するバリデーション

次は入力を日付の形式に限定する「date」のバリデーションです。
誕生日や予約日などを設けている場合には是非活用したいところですね。

「yyyy-mm-dd」という西暦+月+日の形式の他に「yyyy-mm」という西暦+月の形式も可です。
※yのところに西暦、mのところに月、dのところに日が入ります。
　例えばこの記事の執筆日である2022年12月9日を指定する場合、「2022-12-09」のように入力します。

「date」を設定している状態でこのような形式以外を入力するとエラーとなり、リクエストが受け付けられないようになります。

![laravel validation date](//images.ctfassets.net/2kcyx6q7ww5g/IKA33iChoHxaimUumW3bU/abdcd695e3fadfa9c81179f6a0eab694/date__1_.png)

#### 日付+時刻という入力方法も可能

このdateのバリデーションは日付+時刻という形式でも入力が可能です。
具体的には下記のように入力することができます。
・「yyyy–mm-dd hh:mm」（hに時間、mに分が入ります）
　　→西暦+月+日+時：分　例：2022-12-09 16:39

・「yyyy–mm-dd hh:mm:ss」（hに時間、mに分、sに秒が入ります）
　　→西暦+月+日+時：分：秒　例：2022-12-09 16:39:00

![laravel validation date2](//images.ctfassets.net/2kcyx6q7ww5g/5MO3YFiM3KmA9NDNERdhna/c3c1dd66b30407ede0e3f046f898da89/date2__1_.png)

### 「nullable」で任意入力とするバリデーション

次は入力を任意にする「nullable」のバリデーションです。

「required」とは逆で何も入力しなくても登録できるというものです。
現在は履歴書にも記入は任意の項目となった性別など、必須ではない項目と相性が良いと言えるでしょう。

「nullable」のみを設定している項目はエラーにはならずリクエストが受け付けられます。

例えば性別に「nullable」を設定して登録を行うと、下記の画像のようにエラーにならず登録が完了します。

![laravel validation nullable](//images.ctfassets.net/2kcyx6q7ww5g/2jmfUzwrnorFEtHIoW1KG2/d0a6f207c9ad6346bf2026d183b568cf/nullable__1_.png)

この記事ではよく使うバリデーションを9つ紹介してしました。

入力フォームを伴う場合は本記事でご紹介したバリデーションは必須と言えるでしょう。
是非ご活用ください！


Laravel バリデーションの基礎9選をマスターしよう！ 

※DockerはLaravelのインストールとMySQLの起動にのみ使用します。**DockerでLaravelは起動させず、クライアントOS上で起動**させます。Docker内でLaravelを起動させるとマウント等の関係で、動作が重くなるのでお使いのMacやWindows上でPHPをインストールしてLaravelを起動させてください。

ここではLaravel8.0とMySQL8.0の環境構築をDockerを使って行っていきます。

※Laravel9の環境構築は以下を参考にしてください  
「[Laravel9+Sail（Docker）で環境構築してみた](https://implist.dev/entries/9cd66a5a4ac17b37907db499d83dce70)」

構築の流れとしては以下です。

1. composerのコンテナを用意して、Laravelのインストール
2. MySQLのDockerでの起動
3. LaravelとMySQLの連携

ディレクトリ構成も以下に示します。

```
.  
├── container  
│   └── mysql  
│       ├── Dockerfile  
│       ├── conf.d  
│       │   └── mysql.cnf  
│       └── init.d  
│           └── user.sql  
├── docker-compose.yml  
└── myApp　・・・Laravelプロジェクト  
   └── ・・・以下省略
```

この構成をみながらファイルを作成していってください。

### composerのコンテナを用意して、Laravelのインストール

#### composerのコンテナを用意する

docker-composeを使ってcomposerのコンテナを用意します。  
バージョンは2.0.8を指定します。常に最新版を使いたい場合は**image: composer:latest**のように記述しましょう。

**docker-compose.yml**  

```
version: "3"  
services:  
  composer:  
  image: composer:2.0.8  
  volumes:  
    - ${PATH_TO_COMPOSER_JSON:-./}:/app
```

volumesのマウントの設定でどのディレクトリのcomposer.jsonを読むかしていしています。ディレクトリを変更したい場合は、.envの**PATH_TO_COMPOSER_JSON**のパスを記述してください。

**.env**  

```
PATH_TO_COMPOSER_JSON=./
```

この2ファイルを作り終えたら、composerが使用できるか確認します。

```
$ docker-compose run composer composer -V
```

対象のイメージをダウンロードして、コンテナ內部のcomposerコマンドでバージョンを表示しています。以下のように表示されるかと思います。

```
Creating sample_composer_run ... done  
Composer version 2.0.12 2021-04-01 10:14:59
```

#### Laravelのインストール

以下コマンドでLaravelをインストールしていきます。

```
docker-compose run composer composer create-project --prefer-dist laravel/laravel=8.0 myApp
```

結構インストールするのに時間がかかるので気長に待ちましょう。  
インストールが完了すると、docker-compose.ymlがあるディレクトリにmyAppというLaravelのプロジェクト（ディレクトリ）が配置されます。

もし他のパス（一つ上や特定のディレクトリ配下等）にプロジェクトを配置したい場合は.envのPATH_TO_COMPOSER_JSONを変更してください。

続いてmyAppディレクトリに移動し、Laravelを起動しましょう

```
php artisan serve
```

※Laravel8はPHP7.3.0以上でしか動作しないので、インストールまたはアップデートしてください。

http://localhost:8000にアクセスするとLaravelの初期画面が確認出来ると思います。

![](https://img.implist.dev/production/entry/body/Yo2y9tPlV694PXgXr2WFQ34s2I3s0pJ2XJ5IN52B.png)

### MySQLのDockerでの起動

MySQLをDockerで起動させるために、先程のdocker-compose.ymlを以下のように書き換えてください。composerのセクションは同じです

**docker-compose.yml**

```yaml
version: "3"  
services:  

mysql:  
   build:  
     context: ./container/mysql  
     dockerfile: Dockerfile  
   environment:  
     MYSQL_DATABASE: ${DB_NAME:-myapp}  
     MYSQL_USER: user  
     MYSQL_PASSWORD: user!  
     MYSQL_ROOT_PASSWORD: root!  
     TZ: "Asia/Tokyo"  
   ports:  
     - ${MYSQL_PORT:-3306}:3306  
   volumes:  
     - mysql-data-store:/var/lib/mysql  
     - ./mysql/logs:/var/log/mysql  
     - ./container/mysql/init.d:/docker-entrypoint-initdb.d  
     - ./container/mysql/conf.d:/etc/mysql/conf.d  

composer:  
   image: composer:2.0.8  
   volumes:  
     - ${PATH_TO_COMPOSER_JSON:-./}:/app  

volumes:  
 mysql-data-store:
```

また.envも以下のように書き変えましょう

```
MYSQL_PORT=3306  
MYSQL_DATABASE=myapp  
MYSQL_USER=user  
MYSQL_PASSWORD=user!  
MYSQL_ROOT_PASSWORD=root!  
PATH_TO_COMPOSER_JSON=./
```

次はMySQLのDockerfileを作成します

**Dockerfile**  

```
FROM mysql:8.0.16  
LABEL maintainer "ucan"  

COPY conf.d/mysql.cnf /etc/mysql/conf.d/mysql.cnf  
RUN set -eux && \  
 mkdir /var/lib/mysql-files
```

COPYの行で以下のファイルをDockerコンテナ内にコピーしています。  

mysql.cnfはMySQLの設定を記述したものです。

**mysql.cnf**  

```
[mysql]  
default-character-set = utf8mb4  

[mysqld]  
character-set-server = utf8mb4  
collation-server = utf8mb4_bin
```

# caching_sha2_password to mysql_native_password  

```
default-authentication-plugin = mysql_native_password

# Error Log  
log-error = /var/log/mysql/mysql-error.log  

# Slow Query Log  
slow_query_log = 1  
slow_query_log_file = /var/log/mysql/mysql-slow.log  
long_query_time = 5.0  
log_queries_not_using_indexes = 0  

# General Log  
general_log = 1  
general_log_file = /var/log/mysql/mysql-query.log  

[client]  
default-character-set = utf8mb4
```

以下は初期データです。userテーブルとそのデータをMySQL起動時にインサートします。

**user.sql** 

```sql
CREATE TABLE `user` (  
 `user_id` BIGINT unsigned NOT NULL AUTO_INCREMENT COMMENT 'user id',  
 `name` VARCHAR(20) NOT NULL COMMENT 'user name',  
 `email` VARCHAR(256) NOT NULL COMMENT 'user email',  
 `created_at` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,  
 `updated_at` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,  
 PRIMARY KEY (`user_id`),  
 UNIQUE (`email`)  
);  

INSERT INTO `user` (`name`, `email`) VALUES ('testname', 'test@example.com');
```

この状態でdocker-compose upをするとMySQLが立ち上がるのが確認できます。

### LaravelとMySQLの連携

LaravelとMySQLが用意できたので、いよいよこれらを連携させていきます。  
とはいっても簡単で、myApp/.envを書き換えます。

DBの接続情報を今回作成したMySQLの設定通りに書き換えます。**※docker-composeの.envではないので注意してください**

**myApp/.env**  

```
DB_DATABASE=myapp  
DB_USERNAME=user  
DB_PASSWORD=user!
```

#### 他の設定  

次にmyApp直下でLaravelのtinkerを呼び出します。

```
php artisan tinker
```

これでLaravelの機能がコマンドラインから使えるようになるので、DBに接続できているか確認します。

```
>>> DB::select('select 1');
```

この結果以下のように表示されれば成功です。

```
=> [  
    {#3345  
      +"1": 1,  
    },  
  ]  
>>>
```

お疲れさまでした、これでLaravel+MySQLで開発することができます。


Laravel8.0+MySQL8.0の環境をDockerでインストールして起動する

Laravelのマルチログインを図解しながら実装

この記事ではWindowsでWSL2とUbuntuを使って、Docker環境を構築する方法を解説します。

無事に環境構築が完了してDockerをインストールできれば、Windowsの環境を壊すことなく
PHPをインストールしたり、PHP代表的なフレームワークであるLaravelなど起動したりすることができます。

余談ですがLaravelではDockerを利用した、Sailという機能があり、MySQLやRedisなどの複数のミドルウェア追加し、Laravelとシームレスに連携することができます。
また、Sailはメールサーバーの構築やLaravel環境のセットアップ・起動がとても簡単になるので、開発者にとっては大変便利なツールです。

尚、Macユーザの場合の環境構築は[こちら](https://implist.dev/entries/9cd66a5a4ac17b37907db499d83dce70 "Laravel9+Sail（Docker）で環境構築してみた")をご参照ください。

Windowsユーザの場合は、Dockerの起動方法とLaravelの構築方法は上のMacユーザ向けと同じなのですが、
その前の環境構築が少し複雑であるため、つまづきがちです。

そこで今回はWindowsユーザ向けの環境構築について解説していきます。

Laravelについては、Laravel9.xの超入門シリーズとして[こちら](https://implist.dev/series/laravel-beginner-introduction "PHPのMVCフレームワーク 「Laravel 9.x 」超入門　セットアップから基本構文まで")にまとめていますので、ご参照ください。

今回の対象環境は以下の通りです。

- Windows11
- PHP 8.1.13
- Laravel9

### 環境構築

手順は下記のとおりです。

1. Ubuntuをダウンロード
2. コントロールパネルから「Linux用Windowsサブシステム」と「仮想マシンプラットフォーム」にチェックを入れる
3. x64 マシン用 WSL2 Linux カーネル更新プログラム パッケージをダウンロード
4. ダウンロードしたデータをインストール
5. Ubuntuを開いてユーザ名とパスワードを入力
6. Docker Desktopをダウンロード
7. Docker Desktopの初期設定
8. Windows Powershellでlinux環境を起動

以下順番に解説します。

#### 1.Ubuntuをダウンロード

まずはUbuntuをダウンロードします。

![【laravel9-sail-docker-windows】①ubuntuダウンロード](//images.ctfassets.net/2kcyx6q7ww5g/19Cll39UQH0vZ5ogvrks7y/05007661989d6b0cb7c826dfcd5db8f7/___laravel9-sail-docker-windows______ubuntu__________________.png)

Microsoft Storeで「ubuntu」と検索し、Ubuntuをダウンロードします。
※今回はUbuntu20.04.5 LTSをダウンロードしました。

#### 2.コントロールパネルから「Linux用Windowsサブシステム」と「仮想マシンプラットフォーム」にチェックを入れる

次にコントロールパネル→プログラム→Windowsの機能の有効化または無効化、の順番に進みます。
![【laravel9-sail-docker-windows】②-1コントロールパネルのプログラム](//images.ctfassets.net/2kcyx6q7ww5g/7xRDFoUUdhHcphdxTa2Rvr/dc3f23ea4e9d8c775afc1114d8ed9bd0/___laravel9-sail-docker-windows______-1_____________________________________________.png)

「Windowsの機能の有効化または無効化」の画面で、「Linux用Windowsサブシステム」と「仮想マシンプラットフォーム」にチェックを入れ、OKをクリックします。
![【laravel9-sail-docker-windows】②-3【チェック】linux用Windowsサブシステム](//images.ctfassets.net/2kcyx6q7ww5g/5yCMYeP7Wq4usBN9tRgjFV/53b7739db70687d8f2c5b9a0efd240b4/___laravel9-sail-docker-windows______-3__________________linux___Windows__________________.png)

![【laravel9-sail-docker-windows】②-4【チェック】仮想マシンプラットフォーム](//images.ctfassets.net/2kcyx6q7ww5g/7w3S6sXygrKZimqey8tjOi/340e2265040d51de334e846bd8f1efbe/___laravel9-sail-docker-windows______-4_________________________________________________________.png)

設定変更後、再起動する必要があるのでいったん再起動を行います。

![【laravel9-sail-docker-windows】②-5コントロールパネル変更後](//images.ctfassets.net/2kcyx6q7ww5g/2pPbKjvYzxXYaQOK0R1i4L/c4b35d3b6de5f6869946fee6654b189f/___laravel9-sail-docker-windows______-5____________________________________.png)

#### 3.x64 マシン用 WSL2 Linux カーネル更新プログラム パッケージをダウンロード

次に[こちら](https://aka.ms/wsl2kernel "https://aka.ms/wsl2kernelへのリンク")にアクセスしてx64 マシン用 WSL2 Linux カーネル更新プログラム パッケージをクリックしてダウンロードします。

![【laravel9-sail-docker-windows】③-1ubuntuカーネル](//images.ctfassets.net/2kcyx6q7ww5g/1Ho39H2Q2b6NPSGnrvjuPZ/10d7b538840daefe6526cc583a6e8070/___laravel9-sail-docker-windows______-1ubuntu____________.png)

#### 4.ダウンロードしたデータをインストール

次に3.でダウンロードしたデータをインストールします。
ダウンロードしたデータを実行してNext→Finishの順番に進みます。

![【laravel9-sail-docker-windows】③-2ubuntuカーネル初期設定1](//images.ctfassets.net/2kcyx6q7ww5g/4YRYl3ECx539a7dDJnTDVV/84deac62bb4c87201e5405d357297a00/___laravel9-sail-docker-windows______-2ubuntu________________________1.png)

![【laravel9-sail-docker-windows】③-3ubuntuカーネル初期設定2](//images.ctfassets.net/2kcyx6q7ww5g/7oDZu3jfkl0iNPsNpqtU9H/caa0a6bfebf415ad28c387b9d1d07ec2/___laravel9-sail-docker-windows______-3ubuntu________________________2.png)

#### 5.Ubuntuを開いてユーザ名とパスワードを入力

次にUbuntuを開いて、Ubuntu上で使うユーザ名とパスワードを入力します。
操作によってはこのユーザ名とパスワードの入力を求められることがあるので、必ずメモしておきましょう。

パスワードを設定する際は、パスワードを入力しても表示されませんのでご注意ください。
表示されていないだけで、入力はできているので、間違いなく確実に入力するようにしてください。

#### 6.Docker Desktopをダウンロード

次にhttps://www.docker.com/products/docker-desktop にアクセスしてDocker Desktopをダウンロードします。

![【laravel9-sail-docker-windows】⑤-1docker](//images.ctfassets.net/2kcyx6q7ww5g/35JL1CEHD5OKXQPlYWDqBi/ce79c901448d53ad8c3297340becb032/___laravel9-sail-docker-windows______-1docker.png)

ダウンロードしたデータを実行し初期設定を行います。
ショートカットをデスクトップに作るために「Add shortcut to desktop」にチェックを入れてOkをクリックします。

![【laravel9-sail-docker-windows】⑤-2dockerインストール1](//images.ctfassets.net/2kcyx6q7ww5g/5BMtjXe7lKxalOcdOOeu2q/6dd3472aa9405388d0925c39e91fca70/___laravel9-sail-docker-windows______-2docker__________________1.png)

インストール後に再起動を行うとインストールが完了します。

![【laravel9-sail-docker-windows】⑤-3dockerインストール2](//images.ctfassets.net/2kcyx6q7ww5g/7yKOs77t4Lv11Lens58v8G/9e75b8f0fe0f85f62641dc8f0191b24d/___laravel9-sail-docker-windows______-3docker__________________2.png)

#### 7.Docker Desktopの初期設定

次にデスクトップに作成したショートカットからDocker Desktopを起動します。

ホーム画面右上の歯車のマークをクリックし、設定画面に進みます。

![【laravel9-sail-docker-windows】⑤-4docker home](//images.ctfassets.net/2kcyx6q7ww5g/2qM3KNR3MMzHEBD6WdAMij/bd2d5e7cdfb210ece9bbc142a3227618/___laravel9-sail-docker-windows______-4docker_home.png)

下の画像の①Resources→②WSL Integrationの順に進みます。
③「Enable integration with my default WSL distro」にチェックを入れます。
④「Ubuntu-20.04」左のボタンをクリックしてonの状態にします。

![【laravel9-sail-docker-windows】⑤-5docker setting](//images.ctfassets.net/2kcyx6q7ww5g/4bew2pqDDYSIiEZ7bV12DW/1ea70aa2a9ebfffae8a6a5713e382309/___laravel9-sail-docker-windows______-5docker_setting.png)

⑤「Apply & restart」をクリックし、再起動してDocker Desktopの初期設定は完了です。

#### 8.Windows Powershellでlinux環境を起動

次にlinux環境を起動します。

Windowsボタン→検索するには、ここに入力しますをクリックして、「powershell」と入力するとWindows PowerShellアプリが表示され、それをクリックします。

![【laravel9-sail-docker-windows】⑧-1linux環境を起動](//images.ctfassets.net/2kcyx6q7ww5g/6kGALOi1ijFzg303mERziB/80daeacc49c3b582b6292d6bdb42892c/___laravel9-sail-docker-windows______-1linux_______________.png)

上の画像のように「wsl -d Ubuntu-20.04」と入力してエンターキーを押します。

![laravel9-sail-docker-windows -2linux](//images.ctfassets.net/2kcyx6q7ww5g/3kmdYa0FeiO4GT6S6iQxSC/9103b9ef1a3f5b81ebcf62432768aa18/___laravel9-sail-docker-windows______-2linux_______________.png)

新たに表示された行の文字が緑色と青色になれば起動できている状態です。

### LaravelのSailを使ってDocker起動確認

Dockerが起動することを確認するため、Dockerfileを作成して起動してもいいのですが、
せっかくなので冒頭に説明した、「PHPのフレームワークであるLaravel」をインストールして起動してみましょう。
LaravelにはSailというツールがあり、これを使って様々なDockerコンテナを起動することができます。

結構簡単に複数コンテナ起動できます。

具体的なインストール起動方法は[こちら](https://implist.dev/entries/9cd66a5a4ac17b37907db499d83dce70#起動方法 "Laravel9+Sail（Docker）で環境構築してみた")で解説していますのでご参照ください。

#### DB接続

DB接続は[こちら](https://implist.dev/entries/9cd66a5a4ac17b37907db499d83dce70#db接続 "Laravel9+Sail（Docker）で環境構築してみた")で解説していますのでご参照ください。

#### よく使うコマンドまとめ

よく使うコマンドまとめは[こちら](https://implist.dev/entries/9cd66a5a4ac17b37907db499d83dce70#よく使うコマンドまとめ "Laravel9+Sail（Docker）で環境構築してみた")で解説していますのでご参照ください。

Windowsを使っていて環境構築がうまくいかず困っている方は、参考にして構築してみてください！

Windowsで「WSL2+Ubuntu」を使ってDocker環境構築

本記事ではLaravelで使うValidationの応用編の7つを紹介します。

例えばメールアドレスを入力する際に、ひらがなやカタカナなどの文字を使うことはないと思います。
そこで入力できる内容を限定しようというのがバリデーションです。

本記事では、応用編のバリデーションを紹介していきますので是非ご活用ください！

※基礎的でよく使うバリデーションについては下記の記事で紹介しております。
参考→[Laravel バリデーションの基礎9選をマスターしよう！](https://implist.dev/entries/laravel-basic-validation)

※具体的なコードの記述方法については下記の記事で紹介しております。
参考→[Laravelで簡単にバリデーションを実装してエラーメッセージを表示してみる（日本語化も）](https://implist.dev/entries/149d22b000f2dd4ce42510b9efb524a1)

本記事で扱うバリデーションは下記の7つです。

1. starts_with:〇　
    - 〇から始まっているかどうか
3. after_or_equal:tomorrow
    - 明日もしくは明日以降の日付かどうか
5. url
    - 　URLの形式であるかどうか
7. digits_between:〇, □（数字）
    - 〇桁～□桁の間であるかどうか
9. mimes:〇〇,□□（拡張子）
    - 〇〇や□□に指定した拡張子の形式かどうか
11. confirmed
    - （パスワードなどの）値が同じであるかどうか
13. unique
    - 入力された内容が一意（オンリーワン）であるかどうか

### 「starts_with:〇」で〇から始まる値に限定するバリデーション

電話番号は国内であれば必ず「0」から始まりますよね。
ということは「0」以外（例えば「a」など）で始まっているものは国内の電話番号として機能しません。

この場合、「0」以外から始まるものをはじくことができれば、上記のように機能しない内容を少しでも防ぐことができますよね。

「starts_with:0」を設定すると下の画像のように、「0」以外から始まる内容を入力して「登録」をクリックしてもエラーとなり、リクエストが受け付けられないようになります。

![starts with](//images.ctfassets.net/2kcyx6q7ww5g/2TO53UhjhBJBBoRHfTXpDZ/639dd6d7d859c67ccff6652b05bd5574/starts_with.jpg)

尚、エラーメッセージは英語で表示されますが、日本語へ変更やカスタマイズも可能です。

詳しくは下記の記事で紹介していますので必要に応じて参照ください。

参考→[Laravelで簡単にバリデーションを実装してエラーメッセージを表示してみる（日本語化も）](https://implist.dev/entries/149d22b000f2dd4ce42510b9efb524a1)

### 「after_or_equal:tomorrow」で明日もしくは明日以降の日に限定するバリデーション

これは予約フォームで予約日付を入力する場合によく使われます。

「after_or_equal:today」で設定すれば本日以降の日に限定するバリデーションとして使えます。

「after_or_equal:tomorrow」を設定し、過去の日付を入力して「登録」をクリックしてもエラーとなり、リクエストが受け付けられないようになります。

![after or equal tomorrow](//images.ctfassets.net/2kcyx6q7ww5g/5sjFul1RVy0YPnZNMDTpe3/b3bee7785c3df98b92c6e7e3fc290029/after_or_equal_tomorrow.jpg)

### 「url」でURLの形式に限定するバリデーション

URLの形式以外の入力内容のリクエストをはじいてくれます。

例えば下の画像のように「abcdefg」と入力して「登録」をクリックしてもエラーとなり、リクエストが受け付けられないようになります。

![url](//images.ctfassets.net/2kcyx6q7ww5g/35ha2VEsj1wkP23OBu9mI6/8e475acfba99109fead52ac613872608/url.jpg)

### 「digits_between:〇, □（数字）」で〇桁～□桁の間に限定するバリデーション

これはパスワードによく使われます。
パスワードの設定で「4文字以上、8文字以下でパスワードを設定してください」というエラーを見たことがある人は多いのではないでしょうか。

例えば下の画像のように3桁だけを入力して「登録」をクリックしてもエラーとなり、リクエストが受け付けられないようになります。

![digits](//images.ctfassets.net/2kcyx6q7ww5g/5XcklSm2uIW611ng6ree0g/9d6ef5356062df10bca51b84d814713c/digits.jpg)

### 「mimes:〇〇,□□（拡張子）」で〇〇と□□の拡張子に限定するバリデーション

各種申請のフォームで添付資料が必要な場合によく使われます。

画像等の資料を添付する場合、このバリデーションを設定することよってデータの拡張子を限定することができます。

今回はjpegとtxtの拡張子に限定しています。

この状態でpdfのデータを添付して「登録」をクリックしてもエラーとなり、リクエストが受け付けられないようになります。

![mimes1](//images.ctfassets.net/2kcyx6q7ww5g/68NNOoJTLczPIIeniRfXIi/afa14deefc15d50452a3af239950809c/mimes1.jpg)

そこで拡張子がtxtのデータを添付して「登録」をクリックすると、リクエストが受け付けられてデータが登録されます。

![mimes2](//images.ctfassets.net/2kcyx6q7ww5g/2PNmEEQ5Y1xozunZtt0Itb/063da652618fb482534b94333932c63b/mimes2.jpg)

### 「confirmed」でパスワードなどの値と同じ値に限定するバリデーション

これはみなさん一度は経験されたことがあるのではないでしょうか。
パスワードの入力ミスを防ぐために非常に有効な手段の一つと言えます。

それぞれ違うパスワードを入力した状態で「登録」をクリックしてもエラーとなり、リクエストが受け付けられないようになります。

![confirmed](//images.ctfassets.net/2kcyx6q7ww5g/7l7WeaQRD0Y2FJ4D4iS4AV/2984a2df0b34ec31c392245b7fc60d7e/confirmed.jpg)

### 「unique」で入力された内容が一意（オンリーワン）の値に限定するバリデーション

大体のサービスでは同じユーザーIDのアカウントは作れないですよね。
つまり「unique」のバリデーションが使われる機会は多いということが言えます。

すでに登録されているユーザーネームと同じユーザーネームを入力した状態で「登録」をクリックしてもエラーとなり、リクエストが受け付けられないようになります。

![unique](//images.ctfassets.net/2kcyx6q7ww5g/2Hy0KottBmYep6UL2AZoPR/87a3fbb88fcdcc22eb84b75785c84257/unique.jpg)

以上、今回の記事ではLaravelで使うValidationの応用編の7つを紹介しました。

Laravelのバリデーション基礎9選と併せてご活用ください！

参考→[Laravel バリデーションの基礎9選をマスターしよう！](https://implist.dev/entries/laravel-basic-validation)

Laravel バリデーションの応用7選をマスターしよう！

**Reactのバージョン: 18.2.0**

### useStateとは何か？

#### useStateの概要
React Hooksの1つであり、関数コンポーネント内で状態(state)を管理する機能です。
useStateは以下のような形で示されます。

`const [変数, 関数] = useState(初期値) `

#### stateとレンダリング
Reactではコンポーネントが呼び出されることをレンダリングと言います。
何らかの入力により変数(state)が変更されるときに関数が呼び出されます。

useStateでは以下のプロセスを経て画面表示を行っています。

1. stateの変更、更新
2. stateに紐づく関数コンポーネントの呼び出し
3. 変更の前後での差分を出す
4. 差分をDOMに反映
5. 画面表示

次の章で具体的な使い方を説明します。

### useStateの使い方

#### 変数
ここではまず変数の取り扱いについてサンプルコードを用いて解説します。

##### カウンターの実装

カウンターの実装では以下のような機能を実装します。

- 初期値に対して+1するカウントアップ
- 初期値に対して-1するカウントダウン
- 初期値に戻すリセット機能

以下にサンプルコードを記載します。

```javascript
import React, {useState} from 'react';

function Counter() {
 const [count, setCount] = useState(0);

 return (
   <>
     <h1>Counter App</h1>
     <p>{count}</p>
     <button onClick={() => setCount((prevCount) => prevCount + 1)}>count up!</button>
     <button onClick={() => setCount((prevCount) => prevCount - 1)}>count down!</button>
     <button onClick={() => setCount(0)}>reset!!!</button>
   </>
 );
}

export default Counter;
```

このサンプルコードでは変数count(初期値0)および関数コンポーネントsetCountを定義しています。

buttonタグでカウントアップ/カウントダウン/リセットの各ボタンを作成し、それぞれのボタンがクリックされた際にonClickイベントでsetCountをレンダリングし変数countの値の変化を表示しています。
実際には以下のように変化しています。

##### カウントアップ

<ボタンクリック前>
![image9](//images.ctfassets.net/2kcyx6q7ww5g/5FhjD6AUNrpIgC1gc5ze11/fbb44493a3b0f75de8a9647615c9f21b/image9.png)

<ボタンクリック後>
![image1](//images.ctfassets.net/2kcyx6q7ww5g/5LOvWjzYCUmvrTo7MMa9bg/2bf2baab5e98829841a60d085d15d052/image1.png)

##### カウントダウン
![image15](//images.ctfassets.net/2kcyx6q7ww5g/2Iri9GT3GdDip6OspX3NLY/3e58c3ec9657e63bf0861472f9873d77/image15.png)

##### リセット
![image10](//images.ctfassets.net/2kcyx6q7ww5g/28hjwvL3F1QVpTJPBF0IA/abeb153106fe4ee87fa6f2ff730f9e8e/image10.png)

#### 入力値に更新する
ここでは<input>タグで入力した内容に書き換える機能を実装しています。

以下にサンプルコードを記載します。
```javascript
import React, {useState} from 'react';

function Edit() {
 const [text, setText] = useState("");
 const [result, setResult] = useState("sample");

 return (
   <>
     <h1>Text Edit App</h1>
     <input type='text' value={text} onChange={(e) => setText(e.target.value)} />
     <button onClick={()=>setResult(text)}>更新</button>
     <button onClick={()=>setResult("sample")}>リセット</button>
     <p>{result}</p>
   </>
 );
}

export default Edit;
```

このサンプルコードではまずinputタグを用意し、文字列等を入力できるようにします。
inputタグ内のonChange関数によりsetTextがレンダリングされ入力された値を保持します。
その後更新ボタンを押すことでsetResultがレンダリングされ、inputに入力された文字列に書き換えられます。

実際には以下のような画面になります。

##### 更新
<入力前>
![image5](//images.ctfassets.net/2kcyx6q7ww5g/5OdU0w0Pxq2DlRZLiQXntb/81c6ba0f56c66b768244be936891a458/image5.png)

<入力し更新>
![image12](//images.ctfassets.net/2kcyx6q7ww5g/WYOQXRISTQGCmq87U040l/0d02f269d62bc9f1850c3be47b0a38fd/image12.png)

##### リセット
![image8](//images.ctfassets.net/2kcyx6q7ww5g/3XTrPcjIj4HBPr0gfJ3tBm/2e0738262dfac0e075d7fe3912e06f07/image8.png)

#### 配列
配列を取り扱う上で以下の機能を実装しました。

- inputタグで入力した値を配列に追加
- 配列の特定の値を削除

以下にサンプルコードを記載します。

```javascript
import React, {useState} from 'react';

function Array() {
   const [num, setNum] = useState();
   const [result, setResult] = useState([]);

    return (
       <>
       <h1>Array Edit App</h1>

       <input type="number" value={num} onChange={(e) => setNum(e.target.value)} />
       <button onClick={()=>setResult([...result, num])}>追加</button>
       <div>
         <p>array</p>
         <p>{ result }</p>

         <h3>Array Edit</h3>
         <ul>
           {result.map((num, index) => (
             <li>
               { num }
               <button onClick={() => setResult(result.filter((n) => (n != num)))}>削除</button>
             </li>
           ))}
         </ul>
       </div>
       </>
   );
}

export default Array;
```

このサンプルコードでは配列への追加および削除を行っています。

##### 配列への追加
inputタグで入力された値をonChangeによりレンダリングされたsetNumに保持します。

その後onClickを押すことでせtResultがレンダリングされ配列に追加されます。

`[...result, num]`では今までの配列(result)の末尾に入力値(num)を追加するということです。
画面表示時にはmap関数を使い配列を一つずつ表示します。

##### 削除
削除ボタンをクリックするとsetResultがレンダリングされ配列resultの中から該当する要素をフィルタリングします。
削除ボタンはmapで取り出した各要素ごとに設置されています、
そのため押した削除ボタンに該当する要素以外をresultに保存するという処理を行っています。
実際には以下のような画面になります。

##### 追加
<追加前>
![image14](//images.ctfassets.net/2kcyx6q7ww5g/2TnoipfXQcLpUaevzJ6bjl/3ab372004efb7d87c1dcf5cfe51e16ac/image14.png)

<入力し追加>
![image7](//images.ctfassets.net/2kcyx6q7ww5g/2Xz0p7v5Ldddsen7FflMCd/59ac9688be3b9168e1b0d3a6d3f5a84e/image7.png)

![image11](//images.ctfassets.net/2kcyx6q7ww5g/3QS6Az58Aed6qAHMVD5xIW/1094a612c7a8d2994a91776bd11ec279/image11.png)

##### 削除
<削除ボタンを押し削除>
![image4](//images.ctfassets.net/2kcyx6q7ww5g/5SuQDxI9n0ioeXCrxao7tL/eb0b917cb53cd26757b7e210864fd1e8/image4.png)

#### オブジェクト
オブジェクトを取り扱う上で以下の機能を実装しました。

- DBのような形でkeyごとのinputを作成し、入力値を追加
- 削除の実装

以下にサンプルコードを記載します。

```javascript
import React, {useState} from 'react';

function Object() {
   const [name, setName] = useState("");
   const [age, setAge] = useState();
   const [users, setUsers] = useState([]);

   return (
       <>
       <h1>Object Edit</h1>

       name : <input value={ name } onChange={(e) => setName(e.target.value)} />
       age : <input type="number" value={ age } onChange={(e) => setAge(e.target.value)} />
       <button onClick={() => setUsers([...users, { name: name, age: age}])}>追加</button>

       <ul>
         { users.map((user) => (
           <li>
             名前 : { user.name }, 年齢 : { user.age }
             <button id="obj_delete_btn" onClick={() => setUsers(users.filter((n) => (n != user)))}>削除</button>
           </li>
         ))}
       </ul>
       </>
   );
}

export default Object;
```

このサンプルコードではusersオブジェクトへの追加、削除を行っています。

追加および削除のやり方は配列と同じですがオブジェクトでは追加時のinputタグをkeyに合わせて用意する必要があります。

また表示する際には`{ user.name }`のように「オブジェクト名.key」とする必要があります。
実際には以下のような画面になります。

##### 追加
<初期値>
![image13](//images.ctfassets.net/2kcyx6q7ww5g/10w9UY4vIIOZ3t0btvAg2V/8212fc7ac87f8fe06ebc29bc8fb814a7/image13.png)

<入力し追加>
![image6](//images.ctfassets.net/2kcyx6q7ww5g/AWKZIXblXWVNujvsYD2I7/31d8f3fcee1a20d2f9941f1366d9c40b/image6.png)

![image3](//images.ctfassets.net/2kcyx6q7ww5g/5ThT04CjqGVDOZOoEHoqSt/f60e7275082754071c3021d9cdbb8d0a/image3.png)

##### 削除
![image2](//images.ctfassets.net/2kcyx6q7ww5g/2YCtrXsjXKW3UQTxkPgTwp/ca62d4efa47604ec51fe5818ceb8bcd9/image2.png)


React入門 useStateの使い方　変数・配列・オブジェクトを操作してみる

## 【Laravel】Collectionの使い方とよく使うメソッド

### LaravelのCollectionとは

LaravelのCollectionは、PHPの配列をより便利に使うためのラッパークラスです。

PHPの配列だけでやると複雑になってしまうことを、メソッドを通して簡潔に行えます。

#### Collectionを生成する方法

`collect()`に配列を渡すことで、`Illuminate\Support\Collection`インスタンスが生成されます。

```php
$collection = collect([1, 2, 3, 4, 5]);
```

また、DBファサードやEloquentのクエリビルダーの結果がCollection（またはその拡張）です。

#### Collectionは「イミュータブル」

Collectionを使う上で注意点があります。

Collectionの多くのメソッドは、呼び出し元の配列に変更を加えず、新しいCollectionを返します（この特性をイミュータブルと表現します）

つまり、メソッドの返す値を変数で受け取らないと、変更が反映されません。

```php
$collection = collect([1, 2, 3, 4, 5]);

// mapメソッドで各要素に2をかける
$multiplied = $collection->map(function ($item) {
    return $item * 2;
});

// $collectionの中身は[1, 2, 3, 4, 5]のまま
// $multipliedの中身は[2, 4, 6, 8, 10]
```

### よく使うメソッド

Collectionには様々なメソッドがありますが、よく使う以下のメソッドの使い方を紹介します。

- toArray
- map
- each
- filter
- where

### toArray

Collectionは配列を内部に保持するラッパークラスであり、配列そのものではありません。

`toArray`は配列そのものが欲しいときに使うCollectionのメソッドです。

```php
$collection = collect([1, 2, 3]);

$arr = $collection->toArray();  // [1, 2, 3]
```

なお、`all`メソッドもCollectionの中身を配列として返してくれますが、`toArray`と違いネストされたCollectionは配列になりません。

### map

`map`メソッドは、各要素にコールバック関数に書いた処理を加えて、値に変更が加わった新しいCollectionを生成します。

そのまま値を返すと変更が加わらないので、条件分岐などを使って柔軟な対応ができます。

例えば、Collection内の数値を2倍にした新しいCollectionを生成する場合は以下のようになります。

```php
$collection = collect([1, 2, 3, 4, 5]);

$multiplied = $collection->map(function ($item, $key) {
    return $item * 2;
});

// $multipliedは[2, 4, 6, 8, 10]を持つ新しいCollection
```

### each

`each`メソッドは、各要素をクロージャに渡して反復処理します。

`map`メソッドに似ていますが、新しいCollectionは返さず、また元の値にも影響を与えません。

```php
$collection = collect([1, 2, 3, 4, 5]);

$collection->each(function ($item, $key) {
    echo "{$item}, ";
});

// 「1, 2, 3, 4, 5, 」がechoされる
// $collectionの中の配列は[1, 2, 3, 4, 5]のまま
```

### filter

`filter`メソッドは、条件を満たす要素を選び出して、新しいCollectionを返します。

条件はコールバック関数で指定します。

例えば、偶数の数値だけを含む新しいCollectionを作成する場合は以下のようになります。

```php
$collection = collect([1, 2, 3, 4, 5]);

$evenNumbers = $collection->filter(function ($item) {
    return $item % 2 === 0;
});

// $evenNumbersは[1 => 2, 3 => 4]を持つ新しいCollection
```

ここで注目してほしいのは、filterで抽出された要素のインデックスまでそのままである点です。

連番のCollectionを得るには`values`メソッドを使います。

```php
$evenNumbers2 = $evenNumbers->values();

/*
    $evenNumbers2は[0 => 2, 1 => 4]を持つ新しいCollection
*/
```

### where

`where`メソッドは、key=>value形式のCollectionから、条件を満たす要素だけを持つ新しいCollectionを返します。

以下の例が、key=>value形式のCollectionです。

クエリビルダーの結果はこのようなCollectionです。

```php
$users = collect([
    ['name' => 'サザエ', 'gender' => 'female', 'age' => 24],
    ['name' => '波平', 'gender' => 'male', 'age' => 54],
    ['name' => 'フネ', 'gender' => 'female', 'age' => 50],
    ['name' => 'マスオ', 'gender' => 'male', 'age' => 28],
]);
```

例えば、性別がfemaleのユーザーだけを含む新しいCollectionを作成する場合は以下のようになります。

```php
$femaleUsers = $users->where('gender', 'female');

/*
$femaleUsers->toArray()：
    [
        0 => ['name' => 'サザエ', gender='female', 'age' => 24],
        2 => ['name' => 'フネ', gender='female', 'age' => 50],
    ]
*/
```

オプションとして、 `!==`や`<`などのオペレーターを指定することもできます。

例えば、年齢が30歳未満のユーザーだけを含む新しいCollectionを作成する場合は以下のようになります。

```php
$youngUsers = $users->where('age', '<', '30');

/*
$youngUsers->toArray()：
    [
        0 => ['name' => 'サザエ', gender='female', 'age' => 24],
        3 => ['name' => 'マスオ', gender='male', 'age' => 28],
    ]
*/
```

なお、ここでも`filter`メソッドと同様にインデックスがそのままですが、`values`メソッドを使って連番にできます。

```php
$youngUsers = $users->where('age', '<', '30')->values();
```

#### filterとwhereの違い

filterもwhereも条件を満たす要素を抽出して新しいCollectionを返すという点でよく似ていますが、使いどころが異なります。

違いを押さえておきましょう。

* filterはクロージャーを渡せるので、より複雑な処理を書くことができる。
* filterはkey=>value形式でなくても対応できる。
* whereはkey=>value形式に限定されるが、その形式であれば記述量が少なくて済む。

### メソッドを組み合わせて宣言的に書こう

Collectionはメソッドを続けて呼び、連続して操作を行うことができます。

これをメソッドチェーンといいます。

例えば、年齢が30歳未満の女性ユーザーだけを含む新しいCollectionを作成する場合は以下のようになります。

```php
$selectedUsers = $users
                    ->where('gender', 'female')
                    ->where('age', '<', 30)
                    ->values();
/*
$selectedUser->toArray()：
    [
        ['name' => 'サザエ', gender='female', 'age' => 24],
    ]
*/
```

このように、Collectionのメソッドを有効に組み合わせて、宣言的なコードを書くことを意識しましょう。

宣言的とは、何がしたいかが一目でわかるような書き方のことです。

上記の例では「genderがfemaleでageが30未満のuserがほしい」ことを簡潔に書いています。


PHP Laravel Collectionの使い方！each/map/filter/whereを使いこなす

### LaravelのCollectionとは

LaravelのCollectionは、PHPの配列をより便利に使うためのラッパークラスです。

[前回の記事](https://implist.dev/entries/laravel-collection-use)ではCollectionの基本、toArray、map、each、filter、whereメソッドをご紹介しました。

Collectionのメソッドはまだたくさんありますが、その知識を習得すればするほど、実務において非常に役立つと感じられるでしょう。

この記事では新たに、以下のメソッドを学んでいきましょう。

- sort
- sortBy
- count
- groupBy
- pluck

### sort

`sort`メソッドは、要素を並べ替えるために使います。

例えば、ばらばらの大きさで並んでいる数値の配列を、昇順（小さい順）に並べ替えるときに役立ちます。

[前回の記事](https://implist.dev/entries/laravel-collection-use)でお話ししたように、このメソッドも元のCollectionに変更を加えずに、新しいCollectionを返します。

```php
$numbers = collect([3, 1, 5, 2, 4]);

$asc = $numbers->sort();

/*
$asc->toArray()：
    [
        1 => 1,
        3 => 2,
        0 => 3,
        4 => 4,
        2 => 5,
    ]
*/
```

降順（大きい順）に並べ替えたいときは`sortDesc`メソッドを使います。

```php
$desc = $numbers->sortDesc();

/*
$desc->toArray()：
    [
        2 => 5,
        4 => 4,
        0 => 3,
        3 => 2,
        1 => 1,
    ]
*/
```

注意していただきたいのは、確かに並べ替えられたものの、キーは元のままである点です。

連番の配列がほしいときはどうすればいいのでしょうか。

#### キーを連番にリセットするvaluesメソッド

順番は変わったのにキーが元のままということは、Collectionではよくあることです。

こういうときは、キーを連番にリセットする`values`メソッドの出番です。

`sort`に続けて使ってみましょう。

```php
$numbers = collect([3, 1, 5, 2, 4]);

$sorted = $numbers->sort()->values();

/*
$sorted->toArray()：
    [
      0 => 1,
      1 => 2,
      2 => 3,
      3 => 4,
      4 => 5,
    ]
*/
```

#### sortにクロージャを渡す

`sort`で並べ変えることができるのは数値だけではありません。

`sort`は文字列も並べ替えてくれます。

```php
$events = collect([
    '11/23 勤労感謝の日',
    '5/5 こどもの日',
    '1/1 元日',
    '11/3 文化の日',
]);

$sorted = $events->sort()->values();

/*
$sorted->toArray()：
    [
        0 => "1/1 元日",
        1 => "11/23 勤労感謝の日",
        2 => "11/3 文化の日",
        3 => "5/5 こどもの日",
    ]
*/
```

並べ替えられましたが違和感があります。

機械的な文字の順番としてはこの並びが正しいのですが、文字列の先頭が日付であるという人間の意図が反映されていません。

こういうときは`sort`にクロージャを渡すことで、並び替えの条件を具体的に指定することができます。

```php
// 例えば'1/1 元日'を'01/01 元日'に変換する
function padDate($str) {
    $exploded = explode(' ', $str);  // ['1/1', '元日']
    $name = $exploded[1];

    $exploded2 = explode('/', $exploded[0]);  // ['1', '1']
    $mon = Str::padLeft($exploded2[0], 2, '0');
    $day = Str::padLeft($exploded2[1], 2, '0');

    return "$mon/$day $name";
}

$sorted2 = $events->sort(function($a, $b) {
    return strcmp(padDate($a), padDate($b));
})->values();

/*
$sorted2->toArray()：
    [
        0 => "1/1 元日",
        1 => "5/5 こどもの日",
        2 => "11/3 文化の日",
        3 => "11/23 勤労感謝の日",
    ]
*/
```

### sortBy

key=>value形式のCollectionを昇順に並べ替えたいときは、`sortBy`メソッドが便利です。

降順に並べ替える`sortByDesc`メソッドもあります。

```php
$users = collect([
    ['name' => 'サザエ', 'gender' => 'female', 'age' => 24],
    ['name' => '波平', 'gender' => 'male', 'age' => 54],
    ['name' => 'フネ', 'gender' => 'female', 'age' => 50],
    ['name' => 'マスオ', 'gender' => 'male', 'age' => 28],
]);

$sorted = $users -> sortBy('age');

/* 
$sorted->toArray()：
    [
        ['name' => 'サザエ', 'gender' => 'female', 'age' => 24],
        ['name' => 'マスオ', 'gender' => 'male', 'age' => 28],
        ['name' => 'フネ', 'gender' => 'female', 'age' => 50],
        ['name' => '波平', 'gender' => 'male', 'age' => 54],
     ]
*/
```

### count

`count`メソッドは、Collection内の要素の数を返します。

```php
$items = collect(['apple', 'banana', 'orange']);

$count = $items->count(); // $countには3が代入される
```

### groupBy

`groupBy`メソッドは、key=>value形式のCollectionの要素を指定したキーに基づいてグループ化します。

例えば、ユーザーを男女に分けたいときに便利です。

```php
$users = collect([
    ['name' => 'サザエ', 'gender' => 'female', 'age' => 24],
    ['name' => '波平', 'gender' => 'male', 'age' => 54],
    ['name' => 'フネ', 'gender' => 'female', 'age' => 50],
    ['name' => 'マスオ', 'gender' => 'male', 'age' => 28],
]);

$grouped = $users->groupBy('gender');

/* 
$grouped->toArray()：
    [
        'female'=> [
            ['name' => 'サザエ', 'gender' => 'female', 'age' => 24],
            ['name' => 'フネ', 'gender' => 'female', 'age' => 50],
        ],
        'male' => [
            ['name' => '波平', 'gender' => 'male', 'age' => 54],
            ['name' => 'マスオ', 'gender' => 'male', 'age' => 28],
        ]
    ]
*/
```

### pluck

`pluck`メソッドも、key=>value形式のCollectionに対して使うメソッドで、特定のkeyを持つ値だけを抽出してCollectionを作ってくれます。

例えば、ユーザー情報が手元にあるけど、そこからユーザー名だけの配列を作りたいというときに便利です。

```php
$users = collect([
    ['name' => 'サザエ', 'gender' => 'female', 'age' => 24],
    ['name' => '波平', 'gender' => 'male', 'age' => 54],
    ['name' => 'フネ', 'gender' => 'female', 'age' => 50],
    ['name' => 'マスオ', 'gender' => 'male', 'age' => 28],
]);

$names = $users->pluck('name');
/*
$names->toArray()：
    ['サザエ', '波平', 'フネ', 'マスオ']
*/
```

### 組み合わせて使ってみよう

Collectionのメソッドは単発で使うだけでも、生の配列を処理するよりも簡潔に書けますが、組み合わせて使うとき、特にその簡潔さが際立ちます。

例えば、ユーザーの年齢の昇順の配列が欲しいとき、このように書くことができます。

```php
$users
    ->pluck('age')
    ->sort()
    ->values()
    ->toArray();

/*
    [24, 28, 50, 54]
*/
```

次に、ユーザーを若い順に並び替え、男女別に分けてみましょう。

```php
$names = $users
    ->sortBy('age')
    ->groupBy('gender')
    ->toArray();

/*
    [
        'female'=> [
            ['name' => 'サザエ', 'gender' => 'female', 'age' => 24],
            ['name' => 'フネ', 'gender' => 'female', 'age' => 50],
        ],
        'male' => [
            ['name' => 'マスオ', 'gender' => 'male', 'age' => 28],
            ['name' => '波平', 'gender' => 'male', 'age' => 54],
        ]
    ]
*/
```

いずれの場合も、生の配列でやろうと思うと、書くのも読むのも億劫なコードになってしまいます。

Collectionを上手に使うことで、きれいで保守性の高いコードを書くことを心がけましょう。


Laravel Collection 並び替えやグループ化 sort/groupby/pluckなど


Laravelは、開発者が効率的にアプリケーションを構築できるPHPフレームワークです。しかし、データベースとアプリケーションとの間でのデータのやり取りにおいて、"N+1問題"に遭遇する可能性があります。この記事では、N+1問題とその解決策であるEager Loadingについて、Laravelを使用した具体的なコード例とともに解説します。


## **N+1問題とは**

N+1問題は、データベースとのデータのやり取りにおいて、データを取得する際に遭遇するパフォーマンス上の問題です。

この問題は、1つのクエリで取得したデータを基に、さらにN回のクエリが発行され、結果として合計でN+1回のクエリが実行される状況を指します。


### **N+1問題の例：記事とコメント**

例えば、ブログの記事とそれに対するコメントを取得する状況を考えます。モデルの関係は以下のようになります。

```php
class Post extends Model
{
    public function comments()
    {
        return $this->hasMany(Comment::class);
    }
}
```

N+1問題が発生するコード例は以下の通りです。

```php
$posts = Post::all();

foreach ($posts as $post) {
    foreach ($post->comments as $comment) {
        echo $comment->content;
    }
}
```

上記のコードは、最初のクエリで全てのポストを取得し(1回)、その後、各記事に対してコメントを取得するクエリを発行します(N回)。

例えば、10個の記事がある場合、



* 10個の記事を1回のクエリで取得（1回のクエリ）
* 10個の記事それぞれに対してコメントを取得（10回のクエリ）

合計で11回のクエリが発行されることになります。これがN+1問題の典型的な例です。

この問題は、データベースへのアクセス回数が増えるにつれ、よりアプリケーションのパフォーマンスに悪影響を与える可能性があります。特に、レコード数が多い場合や複雑なクエリを実行する場合、この影響は顕著になります。

次のセクションでは、このN+1問題を解決するための、Laravelの一般的なアプローチであるEager Loadingについて詳しく説明します。


## **Eager Loading（イーガーローディング）とは**

Eager Loadingは、LaravelのEloquent ORMにおいて、リレーションシップのデータを効率的に取得するためのテクニックです。これは、データベースからデータをフェッチする際に、関連するデータも一緒に取得することで、N+1問題を解決します


### **Eager Loadingの基本的な使用方法**

Eager Loadingは、主にwithメソッドを使用して実装されます。このメソッドを使用すると、指定したリレーションシップのデータを初めのクエリで一緒に取得することができます。これにより、後続の操作で追加のクエリを発行する必要がなくなり、データベースへのクエリ数が大幅に削減されます。

以下のコードは、Eager Loadingを使用して、記事とそれに関連するコメントを2回のクエリで取得する例です。

```php
$posts = Post::with('comments')->get();

foreach ($posts as $post) {
    foreach ($post->comments as $comment) {
        echo $comment->content;
    }
}
```

このコードでは、with('comments')を使用することによって、2つのクエリを発行します。最初のクエリは、すべての記事を取得するためのものです。次に、取得したすべての記事に紐づくCommentを一度のクエリで取得します。

この方法で記事の数に関係なく、紐づくCommentを取得するためには常に1つのクエリしか発行されません。これにより、N+1問題が解消されます。


### $post->comments と $post->comments() の違い

Laravelのリレーションシップを扱う際、$post->comments と $post->comments() は似ているように見えますが、実際には大きく異なります。



* $post->comments
    * Eager Loadingによって事前に取得したリレーションデータを参照します。この場合、追加のデータベースクエリは発行されません。
* $post->comments()
    * このメソッドは新しいクエリをデータベースに発行してリレーションデータを取得します。Eager Loadingの利点を活かすためには、このメソッドの使用は避けるべきです。

この2つの違いは、()の有無だけですが、その影響は大きいです。特に、パフォーマンスを最適化するためにEager Loadingを使用する際には、この違いを正確に理解し、適切に使用することが重要です。

詳細はこちらの[Laravelの公式ドキュメント](https://readouble.com/laravel/10.x/ja/eloquent-relationships.html#eager-loading)を参照してください。


## **応用例：Eager Loadingの利用シーン**

ここまではEager Loadingの基本的な使い方を見てきましたが、このセクションではその応用的な使い方を実例を通して見ていきましょう。


### **リレーションデータの条件付き取得**

Eager Loadingを使用する際、特定の条件に基づいてリレーションデータを取得することも可能です。これは、関連データが多く、その中から特定のデータのみをフェッチしたい場合などに非常に便利です。

```php
$posts = Post::with(['comments' => function ($query) {
    $query->where('is_active', true);
}])->get();
```

上記のコードでは、記事ごとのコメントを取得しますが、commentテーブルのis_active カラムが true であるデータのみを取得します。この方法で、不要なデータを省き、必要なデータのみを効率的に取得できます。


### **ネストされたリレーションデータの取得**

複数のリレーションを持つデータを扱う場合、ネストされたリレーションデータを一度のクエリで取得することもできます。以下のようなデータの関係性を例に説明します。



* Post: ブログの記事を表すモデルです。
* Comment: ブログの記事に対するコメントを表すモデルです。各Commentは特定のPostに紐づいています。
* Author: コメントの著者を表すモデルです。ここでは、コメントを書いたユーザーを指します。各Commentは特定のAuthorに紐づいています。

```php
$posts = Post::with('comments.author')->get();
```

このコードは、各記事と、記事に紐づくコメント、さらに各コメントの著者を一度のクエリで取得します。これにより、後続の操作で各リレーションを個別にクエリする必要がなくなり、パフォーマンスが向上します。


### **既に取得された親データに対するリレーションデータの追加取得**

すでに取得された記事のデータに対して、後からリレーションデータを取得することも可能です。これは、特定の条件下でのみ追加のリレーションデータが必要な場合などに役立ちます。


```php
$posts = Post::all();

$posts->load('comments');
```

ここでは、全ての記事を取得した後、それぞれの記事に紐づくコメントを追加で取得しています。load メソッドを使用することで、既存のモデルインスタンスに対して追加のリレーションデータを後から取得できます。

この例では以下のようなクエリを発行します。

```sql
SELECT * FROM posts;
SELECT * FROM comments WHERE post_id IN (1, 2, 3, ...);
```

ここでの(1, 2, 3, ...)は取得された記事のIDのリストを示しています。

合計で、データベースへのクエリは2回発行されます。

このようにすでに取得されている記事データに対して$posts->load('comments')を使うことで、複数の記事に紐づくコメントを1回のクエリで取得することができます。

これらの応用例を通して、Eager Loadingはアプリケーションのパフォーマンスを向上させ、DB操作を最適化する強力なツールであることがわかります。

適切に利用することで、データベースへのアクセスの効率を向上させられる可能性があります。


## **Eager Loadingの注意点とその適切な使用法**


### **リレーションメソッドの使用とその影響**

LaravelのEager Loadingは、データベースとのデータのやりとりを効率化するための強力な機能です。しかし、その使用方法によっては、その利点が損なわれることがあります。特に、リレーションメソッドの使用方法には注意が必要です。


### **リレーションメソッドの誤った使用例**

```php
$posts = Post::with('comments')->get();

foreach ($posts as $post) {
    $comments = $post->comments()->where('approved', true)->get();
    foreach ($comments as $comment) {
        echo $comment->content;
    }
}
```

上記のコードでは、with('comments')を使用してcommentsリレーションをEager Loadingしているにも関わらず、foreach文の中でcomments()メソッドを使用して新しいクエリを発行しています。このcomments()メソッドは、新しいクエリをデータベースに発行しているため、Eager Loadingの本来の目的である、データベースへのクエリ数を減らすことを無効にしてしまいます。


### **正しいリレーションデータのアクセス方法**

```php
$comment = $post->comments;
```

こちらのコードは、Eager Loadingによって事前に取得されたcommentsリレーションデータにアクセスしています。commentsプロパティは、動的プロパティとしてリレーションデータを取得します。これにより、新しいクエリが発行されず、キャッシュされたリレーションデータが使用されるため、パフォーマンスが向上します。

N+1問題は、ORMを使用したデータベースの操作において、パフォーマンスのボトルネックとなる可能性があります。Eager Loadingは、Laravelアプリケーションにおけるデータベース操作でクエリを投げる回数を減らせる可能性があります。

しかし、間違った使い方ではその利点が損なわれることがあるため、適切な使用と注意点を理解し、アプリケーションの各部分で効果的に利用することで、パフォーマンスの向上を目指しましょう。

LaravelのN+1問題を「Eager loading」で解決する

## 記事の対象者

この記事は、Laravelは経験があるがLivewireは初めて使う方を対象にしています。Livewireの使い方を素早く理解できるよう内容を絞り込んでいますが、理解の幅を広げたい方のために公式ドキュメントへのリンクも積極的に取り入れています。

通常のLaravelの機能については詳しく解説していませんのでご了承ください。


### Livewireとは

LivewireはLaravel向けのフレームワークです。ページやコンポーネントに状態を持たせることができ、フルページリロードの必要がないSPA的なページをLaravelの簡潔さを損なわずに実装することができます。


### Livewireのバージョンについて

Livewire3は最近（2023年8月）公式リリースされたので、検索してもLivewire2の記事が多く出てきます。後方互換性がかなりあるようなので、2のスタイルで書いてもたいていは動きますが、この記事では3の公式ドキュメントのスタイルを優先します。


## 超簡易アプリの作成を通してLivewireを理解しよう

超簡易記事投稿アプリの作成を通して、Livewireの書き方を高速で体験してください。


### インストール

通常のLaravelプロジェクトをお好きな方法で構築してください。

参考記事：[Laravel9+Sail（Docker）で環境構築してみた](https://implist.dev/entries/9cd66a5a4ac17b37907db499d83dce70)

プロジェクトが作成されたら、Livewireをインストールします。

```bash
composer require livewire/livewire
```

これだけでLivewireの機能が使えるようになります。


### テーブル・モデルを作成する

テーブルやモデルについてはLaravelの基本機能をそのまま使います。このチュートリアルで使用するテーブル・モデルを作成しましょう。

```bash
php artisan make:model Post -m
```

database/migrations/xxxx_xx_xx_xxxxxx_create_posts_table.php（xxxxは作成日時）

```php
Schema::create('posts', function (Blueprint $table) {

    $table->id();

    $table->string('title');

    $table->timestamps();

});
```


### まずはページを作る

Livewireの基本要素は[Livewireコンポーネント](https://livewire.laravel.com/docs/components)です。Laravelのコンポーネントと似ていますが、状態をリクエスト間で維持できるのがウリです。このコマンドで作成できます。

```bash
php artisan make:livewire CreatePost
```

以下のファイルが自動生成されました。クラスとBladeビューが作成されます。Laravelのテンプレートと似ていますね。

* app/Livewire/CreatePost.php
* resources/views/livewire/create-post.blade.php

[Bladeテンプレート内に配置](https://livewire.laravel.com/docs/components#rendering-components)することもできますが、ルートに指定してページとして扱うこともできます（[フルページコンポーネント](https://livewire.laravel.com/docs/components#full-page-components)）

routes/web.php

```php
use App\Livewire\CreatePost;

Route::get('/', CreatePost::class);
```


#### レイアウトを用意する

しかし、この時点でアクセスしてもエラーが出ます。Livewireコンポーネントを包むレイアウトが存在しないからです。`resources/views/components/layouts/app.blade.php`がデフォルトのレイアウトに指定されているので、作成しましょう（レイアウトのパスを変更したい場合は[こちら](https://livewire.laravel.com/docs/components#global-layout-configuration)）

```bash
php artisan make:component layouts.app --view
```

resources/views/components/layouts/app.blade.php

```html
<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
        <title>高速！Livewire3入門</title>
    </head>
    <body>
        {{ $slot }}
    </body>
</html>
```

エラーが出ずに真っ白なページが表示されれば動作確認OKです。


### Livewireコンポーネントの中身を書く


#### クラス側

Livewireコンポーネントのクラスのpublicなプロパティやメソッドは特別な意味を持っています。

publicプロパティは値の内容はリクエスト間で維持され、フロント側のフォームの内容と同期を取ることができます。ReactやVueをご存じの方はステートをご存じでしょう。同じことがPHPコードでできます（[Livewireプロパティ](https://livewire.laravel.com/docs/properties)）

publicメソッドはBladeビューから呼び出すことができます（[Livewireアクション](https://livewire.laravel.com/docs/actions)）

app/Livewire/CreatePost.php

```php
<?php

namespace App\Livewire;

use App\Models\Post;
use Livewire\Component;

class CreatePost extends Component
{
    public $title = '';  // ←Livewireプロパティ

    public function render()
    {
        return view('livewire.create-post');
    }

    public function create()  // ←Livewireアクション
    {
        $post = new Post;

        $post->title = $this->title;

        $post->save();
    }
}
```


#### Bladeビュー側

続いて、Bladeビュー側で`wire:`から始まるディレクティブ使って挙動を定義します。

`wire:model`にはLivewireプロパティ名を指定し、フォーム要素の内容とPHP変数の内容を同期します。

`wire:submit`にはLivewireアクション名を指定し、submitイベントを合図にサーバー側のメソッドを呼び出すことができます。他にも`wire:click`など[あらゆるブラウザイベントに対応](https://livewire.laravel.com/docs/actions#event-listeners)しています。

`wire:key`はループでレンダーする要素に忘れずにつけましょう。そうしないとLivewireが要素を特定できなくなり、不具合の原因になります。

resources/views/livewire/create-post.blade.php

```html
<div>
    <form wire:submit="create">
        <input wire:model="title" />
        <button>投稿</button>
    </form>
    <div>
        @foreach(App\Models\Post::all() as $post)
            <p wire:key="{{ $post->id }}">{{ $post->title }}</p>    
        @endforeach
    </div>
</div>
```


### バリデーションを実装する

Livewireプロパティはプロパティごとにバリデーションを記述することができます。DBにデータを保存する前にバリデーションチェックをしましょう。


#### クラス側

バリデーションルールは`#[Rule]`を使ってプロパティに直接指定することができます。通常のLaravelと同じバリデーションルールを使います。

app/Livewire/CreatePost.php

```php
<?php

namespace App\Livewire;

use App\Models\Post;
use Livewire\Attributes\Rule;  // ←追加
use Livewire\Component;

class CreatePost extends Component
{
    #[Rule('required|string|max:10')]  // ←追加

    public $title = '';

    public function render()
    {
        return view('livewire.create-post');
    }

    public function create()
    {
        $this->validate();  // ←追加

        $post = new Post;

        $post->title = $this->title;

        $post->save();
    }
}
```


#### Bladeビュー側

Bladeビュー側にエラーを表示しましょう。表示方法は通常のLaravelと全く同じです。

resources/views/livewire/create-post.blade.php

```
<div>
    <form wire:submit="create">
        <input wire:model="title" />
        <button>投稿</button>

        {{-- ↓追加 --}}
        @error('title')
            <span>{{ $message }}</span>
        @enderror  

    </form>
    <div>
        @foreach(App\Models\Post::all() as $post)
            <p>{{ $post->title }}</p>    
        @endforeach
    </div>
</div>
```


### 完成

極めて簡素ですが、記事投稿アプリの完成です。Laravel単体で実装すと

* ルート定義
* コントローラー
* バリデーション

の記述などで煩雑になりそうですが、Livewireで簡潔に書くことができました。


## さらに学びを深めよう

Livewireはシンプルに見えますが、多機能で奥が深いです。以下は筆者が実務で便利だと感じた機能へのお役立ちリンク集です。

* [Url Query Parameters](https://livewire.laravel.com/docs/url) - この機能は感動です。検索条件が多いページなどを簡潔に実装できます。
* [Locked Properties](https://livewire.laravel.com/docs/locked) - Livewireはサーバー側の変数がフロントに疑似的に晒されるため、セキュリティ上の懸念があります。筆者はフロントでの変更を意図しないLivewireプロパティには全て`#[Locked]`を付けています。
* [wire:loading](https://livewire.laravel.com/docs/wire-loading) - 二重送信対策に便利なのがこのディレクティブ。
* [Alpine.jsからアクセス](https://livewire.laravel.com/docs/actions#calling-actions-from-alpine) - JSでしかできないようなことをPHPでできてしまうLivewireですが、Alpine.jsを使った方が便利なときがあります。


Laravel Livewire入門！PHPでreact/vueライクなアプリケーション開発

## 記事の概要

Laravelに含まれているテンプレートエンジンBladeは大変便利ですが、多機能ゆえに意外と知らない書き方があったり、何度も同じ事を調べてしまいがちです。

[こちら](https://laravel.com/docs/10.x/blade)に網羅的な公式ドキュメントがありますが、タスキに長しという感があります。

この記事では筆者が業務でよく使用するものに絞り込んで、Bladeテンプレートの書き方をご紹介します。

## PHP変数の展開

### {{ $v }}

BladeテンプレートにPHP変数の中身を表示するには`{{ $v }}`を使います。

この方法はただ変数の中身をHTMLに展開するだけでなく、セキュリティ対策として、ブラウザがHTMLタグとして解釈できないよう[特定の文字](https://www.php.net/manual/ja/function.htmlspecialchars.php)をエスケープしてくれます。

例えば、`$v`の中に`<script>`が含まれていてもブラウザはJavascriptを実行しません。

### {!! $v !!}

BladeテンプレートにPHP変数の中身を**エスケープせずにそのまま**表示するには`{!! $v !!}`を使います。

しかし、びっくりマークが使われていることからもわかるように、この書き方にはリスクが伴います。

悪意のあるコードはどこにでも紛れ込みうるものと考えて、常に`{{ $v }}`を使うべきです。

### {!! nl2br(e($v)) !!}

`{!! $v !!}`の使用を回避すべきことの例外として、PHP変数の改行文字`"¥n"`を`<br>`に変換して出力したいケースがあります。

`{{ nl2br($v) }}`と書くと「`<br>`」が文字としてそのまま表示されてしまいます。

そこで、`e()`で特定の文字をエスケープしたのちに、`nl2br()`を適用しそのまま出力することで、`<br>`がエスケープされるのを回避します。

### エスケープとは

ここでいうエスケープとは、上記例の`$v`の中身がブラウザによってHTMLとして認識されないようにすることを言います。

例えば、`$v`がユーザーが投稿したメッセージである場合、悪意あるコードを実行する`<script>`タグが記述されている可能性があります。

これをブラウザが読み込んで実行する恐れがあるため、Bladeで変数の中身をHTMLに展開するときは、常にエスケープすることが推奨されます。

## 条件分岐

### @if

PHPの`if`と同じように表示内容を制御できます。条件分岐には[様々なディレクティブ](https://laravel.com/docs/10.x/blade#blade-directives)が存在しますが、`@if`で再現できるものが多いので、差し当たり`@if`を知っていれば大丈夫でしょう。

```php
@if (count($records) === 1)
    一件のレコードが存在します！
@elseif (count($records) > 1)
    複数件のレコードが存在します！
@else
    レコードが存在しません！
@endif
```

### @switch

PHPの`switch`と同じように表示内容を制御できます。

`@break`がないと次の`@case`以下のコードが実行されてしまうため、それを意図しない場合は`@break`を忘れないようにしましょう。

自信がなければ`@if`でも代替できるので、`@switch`を無理に使う必要はありません。

```php
@switch($i)
    @case(1)
        ケース１...
        @break
    @case(2)
        ケース２...
        @break
    @default
        その他のケース...
@endswitch
```

## ループ

### @for

PHPの`for`と同じように表示内容を繰り返すことができます。

```php
@for ($i = 0; $i < 10; $i++)
    <p>現在の値は {{ $i }}</p>
@endfor
```

### @foreach

PHPの`foreach`と同じように、配列・コレクションに含まれている要素の数だけ、表示内容を繰り返すことができます。ループ内では、取り出した値（以下の例では`$user`）を使うことができます。

```php
@foreach ($users as $index => $user)
    <p>{{ $index }}番目のユーザーのIDは {{ $user->id }}</p>
@endforeach
```

### @forelse

配列・コレクションが空のとき、その旨を表示したいことが多々あります。`@foreach`と`@if`を組み合わせても実装できますが`@forelse`を使うと簡潔に記述できるのでオススメです。

```php
@forelse ($users as $user)
    <li>{{ $user->name }}</li>
@empty
    <p>ユーザーが登録されていません</p>
@endforelse
```

### $loop

ループ内では`$loop`という特別な変数を宣言なしで使えます。`$loop`は[様々なプロパティ](https://laravel.com/docs/10.x/blade#the-loop-variable)を持っており、わざわざこれを使わなくても実装できることの方が多いですが、ご紹介しておきます。

以下は、１回目のループならばture、それ以外ならfalseである`first`プロパティを使った例です。

あとで紹介する`@class`とTailewind CSSを併用して、最初の要素には上下に、それ以外の要素には下にだけボーダーを表示しています。

```php
@foreach ($users as  $user)
    <p @class([
        'border-y' => $loop->first,
        'border-b' => !$loop->first,
    ])>このユーザーのIDは {{ $user->id }}</p>
@endforeach
```

## 条件付きクラス

### @class

特にTailwind CSSを使っているとき、条件を満たすときだけクラスを指定したいことがあります。そういうときは`@class`の出番です。

```php
<span @class([
    'p-4',                      {{-- 常にclassに含まれる --}}
    'bg-red-500' => $hasError,  {{-- $hasErrorが真のときclassに含まれる --}}
])>テキスト</span>
```

### @style

`@class`と同じように、`style`属性に対しても条件指定できます。

```php
<span @style([
    'padding: 1rem',                       {{-- 常にstyleに含まれる --}}
    'background-color: red' => $hasError,  {{-- $hasErrorが真のときstyleに含まれる --}}
])>テキスト</span>
```

## PHPコード

### @php

`@php`を使うことでBladeテンプレートにPHPコードを記述することができます。`@php`ブロック内で定義した変数をブロック外で使うこともできます。

```php
@php
    $hasError = true;
@endphp

<span @class([
    'p-4',
    'bg-red-500' => $hasError,
])>テキスト</span>

```

### @php()

`@php()`を使えば`@endphp`が不要なので、１行でコードを書けます。

```php
@php(dd($hasError))
```

## コメント

### {{-- コメント --}}

Bladeテンプレート内でのコメントには`{{-- コメント --}}`を使います。

HTMLのコメントである``も使えますが、こちらはレンダーされたHTMLに残るため、開発者ツールを通してユーザーに晒されてしまいます。

## バリデーション

### @error()

formリクエストの際にPHP側の`validate()`でエラーが生じたとき、エラーメッセージの表示には`@error()`を使います。引数として対象となるフォームデータ名を渡します。

エラーメッセージはブロック内で使える特別な変数`$message`に格納されています。

```php
<input name="email" />

@error('email')
    <span class="text-red-500">{{ $message }}</span>
@enderror
```

```php
$request->validate([
    'email' => 'required|email',
]);
```

## コンポーネント

### コンポーネントとは

コンポーネントとは、ボタンやヘッダーメニューなど複数ページで繰り返し使うBladeの記述を別ファイルに保存し、ページで呼び出して部品のように配置できる機能です。

コンポーネントには、クラスとBladeテンプレートの２ファイルから構成される[通常のコンポーネント](https://laravel.com/docs/10.x/blade#components)と、Bladeテンプレートだけで構成される[匿名コンポーネント](https://laravel.com/docs/10.x/blade#anonymous-components)があります。

匿名コンポーネントの方が管理しやすく、おそらく通常のコンポーネントにしかできないことはないので、筆者は匿名コンポーネントばかり使っています。

この記事では匿名コンポーネントの使い方に絞って解説します。

### ファイルの作り方

以下のコマンドで作ることもできますが、`/resources/views/components`配下に空のファイルを自分で作ることもできます。拡張子は`.blade.php`です。

```bash
php artisan make:component フォルダ名.コンポーネント名 --view
```

### 配置方法

他のBladeテンプレートでコンポーネントを呼び出して配置するには、`<x-フォルダ名.コンポーネント名/>`タグを記述します。例えば`/resources/views/components/form/input.blade.php`の場合は`<x-form.input/>`です。なお、コンポーネント内から他のコンポーネントを呼び出して配置することもできます。

### データの受け渡し

コンポーネントが受け取るデータを定義するには`@props`を使います。デフォルト値を指定することもできます。

/resources/views/components/proverb.blade.php

```php
@props(['name', 'message' => '天は人の上に人を作らず'])

<div>
    {{ $name }}曰く「{{ $message }}」
</div>
```

タグに属性を指定するようにして、コンポーネントにデータを渡すことができます。PHP変数を渡したい場合は、属性名の前に`:`を付けます。

```php
@php($message='学問は米をつきながらも出来るものなり')

<x-proverb name="福沢諭吉" :message="$message" />  {{-- 簡略形として:$messageとすることもできる --}}
```

注意点として、属性名の前に`:`を付けることができるのは、コンポーネントだけであり、普通のHTMLタグの属性名の前に:を付けて変数を渡しても、その記述がそのままレンダーされるだけです。

### $attributes

受け渡しする属性の名前を全て指定する必要はありません。加工したり変数展開する必要がなければ`$attributes`でまとめて渡せます。

以下の例では`$attributes`に`x-on:click="submit" class="px-4 py-2"`の部分が展開されます。

/resources/views/components/submit-button.blade.php

```php
<button {{ $attributes }}>送信</button>
```

```php
<x-submit-button x-on:click="submit"  class="px-4 py-2" />
```

### $attributes->merge()

Tailwind CSSを使っていると、コンポーネント側で基本スタイルを指定しておき、配置するとき色だけ指定したいことがあります。単に属性を渡すだけだと`class`属性が２つになり衝突してしまうため、マージする必要があります。

/resources/views/components/submit-button.blade.php

```php
<button {{ $attributes->merge(['class' => 'px-4 py-2']) }}>送信</button>
```

```php
<x-submit-button class="bg-blue-200" />
```

注意点として、Tailewind CSSの同じ種類のクラスはマージされません。例えば、コンポーネントに基本スタイルとして`bg-red-200`が指定されており`bg-blue-200`が渡されきたとすると、`class="bg-red-200 bg-blue-200"`のように展開されてしまい、どちらの色になるかわかりません。この問題に対処するには[別パッケージ](https://github.com/gehrisandro/tailwind-merge-laravel)の導入が必要ですが、この記事では立ち入りません。

### $attributes->class()

`class`属性のマージには簡略形があり、上記の例は以下のように記述することができます。

/resources/views/components/submit-button.blade.php

```php
<button {{ $attributes->class('px-4 py-2') }}>送信</button>
```

さらに`class()`は`@class`のように条件指定ができます。

```php
@props(['hasError' => false])

<span {{ $attributes->class([
    'p-4',                      {{-- 常にclassに含まれる --}}
    'bg-red-500' => $hasError,  {{-- $hasErrorが真のときclassに含まれる --}}
]) }}>テキスト</span>
```

### $slot

HTMLタグと同じようにコンポーネントにも、文字やタグ、さらには別のコンポーネントを入れ子にすることができます。

```php
<x-button>
    <span class="text-red-500">絶対に押すな</span>
</x-button>
```

これをコンポーネントで表示するには`$slot`という名前の変数を展開します。この変数は宣言なしで使えます。

/resources/views/components/button.blade.php

```php
<button>{{ $slot }}</button>
```

### <x-slot:スロット名>

複数のスロットが必要なら`<x-slot:スロット名>`の出番です。以下の例ではheaderという名前の追加スロットを使用しています。

/resources/views/components/article.blade.php

```php
<div {{ $attributes }}>
    <header>{{ $header }}</header>
    <main>{{ $slot }}</main>
</div>
```

```php
<x-article>
    <x-slot:header>タイトル</x-slot>
    本文....
</x-article>
```

`x-slot`に渡した属性を展開することもできます。もちろん`$attributes`のメソッドも使えます。

/resources/views/components/article.blade.php

```php
<div {{ $attributes }}>
    <header {{ $header->attributes }}>{{ $header }}</header>
    <main>{{ $slot }}</main>
</div>
```