JWT (JSON Web Token) 認証とは、Webアプリケーションでユーザーの認証と承認を行うためのオープンスタンダードのこと。以下がポイント。 ①トークンベースの認証JWTは、ユーザーがログインするときに生成されるトークンを使用する。このトークンは、ユーザーの認証情報を含むJSON形式のデータ。 ②セッション管理の代替セッションベースの認証では、サーバーがユーザーのセッション情報を保持するが、JWTではクライアント側がトークンを保持する。これにより、サーバーの負荷が軽減され、スケーラビリティが向上する。 ③セキュリティJWTは署名されており、改ざんされていないことを保証する。署名には秘密鍵が使用され、サーバーだけがその秘密鍵を知っている。

JWT認証とは

任意のプロジェクトディレクトリに移動し、下記コマンドでJWT認証のパッケージをインストールする。 <code>composer require tymon/jwt-auth</code>

パッケージのインストール

<code>php artisan vendor:publish --provider="Tymon\JWTAuth\Providers\LaravelServiceProvider"</code>

設定ファイル(config/jwt.php)を生成

<code>php artisan jwt:secret</code>

.envにJWTの秘密鍵を生成

config/auth.phpを下記のように書き換える。 <pre><code>'guards' =&gt; [
&nbsp; &nbsp; 'api' =&gt; [
&nbsp; &nbsp; &nbsp; &nbsp; 'driver' =&gt; 'jwt',
&nbsp; &nbsp; &nbsp; &nbsp; 'provider' =&gt; 'users',
&nbsp; &nbsp; ],
],</code></pre>

Guardの変更

下記のようにUserモデルに追記する。 <pre><code>use Tymon\JWTAuth\Contracts\JWTSubject;


class User extends Authenticatable implements JWTSubject
{
&nbsp; &nbsp; public function getJWTIdentifier()
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; return $this-&gt;getKey();
&nbsp; &nbsp; }


&nbsp; &nbsp; public function getJWTCustomClaims()
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; return [];
&nbsp; &nbsp; }
}</code></pre>

Userモデルの設定

<code>php artisan make:controller AuthController</code> <pre><code>&lt;?php


namespace App\Http\Controllers;


use Illuminate\Http\Request;
use Tymon\JWTAuth\Facades\JWTAuth;
use App\Models\User;


class AuthController extends Controller
{
&nbsp; &nbsp; public function login(Request $request)
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; $credentials = $request-&gt;only('email', 'password');


&nbsp; &nbsp; &nbsp; &nbsp; if (! $token = JWTAuth::attempt($credentials)) {
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json(['error' =&gt; 'Unauthorized'], 401);
&nbsp; &nbsp; &nbsp; &nbsp; }


&nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'message' =&gt; 'Login successful',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'token' =&gt; $token
&nbsp; &nbsp; &nbsp; &nbsp; ]);
&nbsp; &nbsp; }


&nbsp; &nbsp; public function register(Request $request)
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; $user = User::create([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'name' =&gt; $request-&gt;name,
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'email' =&gt; $request-&gt;email,
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'password' =&gt; bcrypt($request-&gt;password),
&nbsp; &nbsp; &nbsp; &nbsp; ]);


&nbsp; &nbsp; &nbsp; &nbsp; $token = JWTAuth::fromUser($user);


&nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'message' =&gt; 'Registration successful',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'token' =&gt; $token
&nbsp; &nbsp; &nbsp; &nbsp; ]);
&nbsp; &nbsp; }
}</code></pre>

コントローラー作成

routes/api.php を編集。 <pre><code>Route::post('login', [AuthController::class, 'login']);
Route::post('register', [AuthController::class, 'register']);</code></pre>

ルートの作成

実装手順

postmanを使用して確認する。 <blockquote>名前 : test1 メールアドレス : test1@example.com パスワード : password</blockquote> 上記のユーザーを登録。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/f1fc7e271feb4e5eba46460c2944f3c4/image.png" alt="">

登録

登録したユーザーでログインを確認する。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/48e68fe7f33e463196462b1bbbd8927f/image.png" alt="">

動作確認

【Laravel】JWT認証機能の実装

下記リンクからインストール可能（MacとWindowsでインストーラが変わるため注意）<a href="https://www.docker.com/get-started/" target="_blank" rel="noopener noreferrer">https://www.docker.com/get-started/</a>

（前提）Docker のインストール

任意の場所にプロジェクトディレクトリを作成する。 <code>mkdir laravel11-docker</code><code>cd laravel11-docker</code> ★ディレクトリ構造<pre><code>laravel11-docker/
├── docker/
│&nbsp; &nbsp;├── mysql/
│&nbsp; &nbsp;│&nbsp; &nbsp;└── (MySQL関連ファイル)
│&nbsp; &nbsp;├── nginx/
│&nbsp; &nbsp;│&nbsp; &nbsp;├── logs/
│&nbsp; &nbsp;│&nbsp; &nbsp;├── default.conf
│&nbsp; &nbsp;│&nbsp; &nbsp;└── Dockerfile
│&nbsp; &nbsp;└── php/
│&nbsp; &nbsp; &nbsp; &nbsp;├── Dockerfile
│&nbsp; &nbsp; &nbsp; &nbsp;└── php.ini
├── src/
│&nbsp; &nbsp;└── (Laravelプロジェクトファイル)
└── docker-compose.yml</code></pre>

プロジェクトディレクトリの作成

docker-compose.ymlファイルを作成し、以下の内容を記述する。 <pre><code>services:
&nbsp; nginx:
&nbsp; &nbsp; container_name: "laravel11-nginx"
&nbsp; &nbsp; build:
&nbsp; &nbsp; &nbsp; context: ./docker/nginx
&nbsp; &nbsp; ports:
&nbsp; &nbsp; &nbsp; - "80:80"
&nbsp; &nbsp; volumes:
&nbsp; &nbsp; &nbsp; - ./src:/var/www/html
&nbsp; php:
&nbsp; &nbsp; container_name: "laravel11-php"
&nbsp; &nbsp; build:
&nbsp; &nbsp; &nbsp; context: ./docker/php
&nbsp; &nbsp; volumes:
&nbsp; &nbsp; &nbsp; - ./src:/var/www/html
&nbsp; &nbsp; &nbsp; - ./docker/php/php.ini:/usr/local/etc/php/php.ini
&nbsp; mysql:
&nbsp; &nbsp; image: mysql:8.0
&nbsp; &nbsp; container_name: "laravel11-mysql"
&nbsp; &nbsp; environment:
&nbsp; &nbsp; &nbsp; MYSQL_ROOT_PASSWORD: root
&nbsp; &nbsp; &nbsp; MYSQL_DATABASE: laravel
&nbsp; &nbsp; volumes:
&nbsp; &nbsp; &nbsp; - ./docker/mysql:/var/lib/mysql
&nbsp; &nbsp; ports:
&nbsp; &nbsp; &nbsp; - "3306:3306"</code></pre>

docker-compose.ymlの作成

docker/nginxフォルダ内にDockerfileとdefault.confを作成し、以下の内容を記述する。 ・Dockerfile<pre><code>FROM nginx:1.21
COPY default.conf /etc/nginx/conf.d/</code></pre> ・default.conf<pre><code>server {
&nbsp; &nbsp; listen 80;
&nbsp; &nbsp; server_name localhost;
&nbsp; &nbsp; root /var/www/html/public;
&nbsp; &nbsp; index index.php index.html;


&nbsp; &nbsp; location / {
&nbsp; &nbsp; &nbsp; &nbsp; try_files $uri $uri/ /index.php?$query_string;
&nbsp; &nbsp; }


&nbsp; &nbsp; location ~ \.php$ {
&nbsp; &nbsp; &nbsp; &nbsp; fastcgi_pass laravel11-php:9000;
&nbsp; &nbsp; &nbsp; &nbsp; fastcgi_index index.php;
&nbsp; &nbsp; &nbsp; &nbsp; include fastcgi_params;
&nbsp; &nbsp; &nbsp; &nbsp; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
&nbsp; &nbsp; }
}</code></pre>

Nginxの設定

docker/phpフォルダ内にDockerfileとphp.iniを作成し、以下の内容を記述する。 ・Dockerfile <pre><code>FROM php:8.2-fpm

# 必要なパッケージのインストール
RUN apt-get update &amp;&amp; apt-get install -y \
&nbsp;&nbsp;zip \
&nbsp;&nbsp;unzip \
&nbsp;&nbsp;git \
&nbsp;&nbsp;&amp;&amp; docker-php-ext-install pdo_mysql

# Composerのインストール
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

COPY php.ini /usr/local/etc/php/</code></pre> ・php.ini<pre><code>[PHP]
display_errors = On</code></pre>

PHPの設定

プロジェクトフォルダ内で以下のコマンドを実行してLaravelプロジェクトを作成する。 <code>docker compose run --rm php composer create-project --prefer-dist laravel/laravel src</code>

Laravelプロジェクトの作成

<code>docker-compose up -d</code>

Dockerコンテナの起動

DockerによるLaravel環境の構築

ブラウザでアクセスしウェルカムページが表示されるかを確認する。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/93e2745c8ecd40a780f071c3d932c7bd/image.png" alt="">

【Docker】Laravel 11 環境の構築

Docker社が開発している、コンテナ型の仮想環境を作成、配布、実行するためのプラットフォーム。

Dockerとは

Dockerコンテナはコード化されたファイルを共有することで、ローカル環境と本番環境の違いをなくし、一貫した動作の環境のもと開発を行うことができる。Dockerはミドルウェアのインストールや各種環境設定をコード化して管理できる。

メリット

Docker

下記リンクからインストール可能（MacとWindowsでインストーラが変わるため注意）<a href="https://www.docker.com/get-started/" target="_blank" rel="noopener noreferrer">https://www.docker.com/get-started/</a>

任意の場所にディレクトリを作成する。 <code>mkdir php-docker</code><code>cd php-docker</code> (ディレクトリ構造)<pre><code>php-docker/
├── Dockerfile
├── docker-compose.yml
├── index.php
└── その他のPHPファイルやディレクトリ</code></pre>

ディレクトリの作成

Dockerfile とは、PHPのベースイメージに対して追加のPHP拡張モジュールをインストールするためのもの。プロジェクトディレクトリ内に Dockerfile を作成し、以下の内容を記述する。 <pre><code># ベースイメージとしてPHPを使用
FROM php:7.4-apache


# 作業ディレクトリを設定
WORKDIR /var/www/html


# プロジェクトファイルをコンテナにコピー
COPY . /var/www/html


# 必要なPHP拡張モジュールをインストール
RUN docker-php-ext-install mysqli</code></pre>

Dockerfileの作成

docker-compose.yml は、複数のDockerコンテナを一括で定義・管理するための設定ファイル。1つのファイルで複数のコンテナを定義可能で、例えばPHPとMySQLを同時に設定でき、ローカル環境、テスト環境で同じ設定ファイルを用いることで、一貫性のある環境を提供できる。プロジェクトディレクトリ内に docker-compose.yml を作成し、以下の内容を記述する。 <pre><code>version: '3.8'


services:
&nbsp; web:
&nbsp; &nbsp; build: .
&nbsp; &nbsp; ports:
&nbsp; &nbsp; &nbsp; - "8080:80"
&nbsp; &nbsp; volumes:
&nbsp; &nbsp; &nbsp; - .:/var/www/html
&nbsp; &nbsp; depends_on:
&nbsp; &nbsp; &nbsp; - db


&nbsp; db:
&nbsp; &nbsp; image: mysql:5.7
&nbsp; &nbsp; environment:
&nbsp; &nbsp; &nbsp; MYSQL_ROOT_PASSWORD: example
&nbsp; &nbsp; &nbsp; MYSQL_DATABASE: mydatabase
&nbsp; &nbsp; &nbsp; MYSQL_USER: user
&nbsp; &nbsp; &nbsp; MYSQL_PASSWORD: password
&nbsp; &nbsp; volumes:
&nbsp; &nbsp; &nbsp; - db_data:/var/lib/mysql


volumes:
&nbsp; db_data:</code></pre>

例えば index.php ファイルを作成し、MySQLデータベースに接続できているかを確認するソースを記述する。 <pre><code>&lt;?php
$servername = "db";
$username = "user";
$password = "password";
$dbname = "mydatabase";


// MySQLデータベースに接続
$conn = new mysqli($servername, $username, $password, $dbname);


// 接続をチェック
if ($conn-&gt;connect_error) {
&nbsp; &nbsp; die("Connection failed: " . $conn-&gt;connect_error);
}
echo "Connected successfully";
?&gt;</code></pre>

PHPファイルの作成

以下のコマンドを実行して、Dockerコンテナをビルドし起動する。 <code>docker-compose up -d</code>

Dockerコンテナのビルドと起動

ブラウザで http://localhost:8080 にアクセスして、PHPとMySQLが正しく連携しているか確認する。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/dc14ce9af8d54347b3a8de2ce3e502eb/image.png" alt="">

ブラウザで確認

DockerによるPHP環境の構築

今回はDockerでPHPの環境の構築を行いました。

まとめ

【Docker】PHP環境の構築

・名前入力必須32文字以内 ・メールアドレス入力必須メールアドレス形式 ・パスワード入力必須4文字以上確認用と一致するか

エラー内容

confirmメソッドにバリデーションを設定 <pre><code>&nbsp; &nbsp; public function confirm(Request $request)
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; $request-&gt;validate([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'name' =&gt; ['required', 'max:32'],
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'email' =&gt;['required', 'email'],
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'password' =&gt;['required', 'min:4', 'confirmed'],
&nbsp; &nbsp; &nbsp; &nbsp; ],
&nbsp; &nbsp; &nbsp; &nbsp; [
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'name.required' =&gt; '名前を入力してください',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'name.max' =&gt; '最大32文字で入力してください',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'email.required' =&gt; 'メールアドレスを入力してください',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'email.email' =&gt; 'メールアドレス形式で入力してください',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'password.required' =&gt; 'パスワードを入力してください',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'password.min' =&gt; '4文字以上で入力してください',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'password.confirmed' =&gt; 'パスワードが一致していません',
&nbsp; &nbsp; &nbsp; &nbsp; ]);


&nbsp; &nbsp; &nbsp; &nbsp; return view('users/confirm', [
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'inputs' =&gt; $request-&gt;all(),
&nbsp; &nbsp; &nbsp; &nbsp; ]);
&nbsp; &nbsp; }</code></pre>

UsersController.phpを編集

コントローラーを編集してバリデーションを作成

FormRequestとはRequestファサードを継承したもので、バリデーションのルールやメッセージをカスタマイズするのに特化している。 ・下記コマンドでファイル作成<code>php artisan make:request UserRequest</code>

・authorizeメソッドtrueを返すことでUserRequestの使用を許可する&nbsp;&nbsp;&nbsp;<pre><code>&nbsp;&nbsp;public function authorize()
&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;return true;
&nbsp;&nbsp;}</code></pre> ・rulesメソッドバリデーションを定義する <pre><code>&nbsp;&nbsp;public function rules(): array
&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;return [
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'name' =&gt; ['required', 'max:32'],
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'email' =&gt;['required', 'email'],
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'password' =&gt;['required', 'min:4', 'confirmed'],
&nbsp;&nbsp;&nbsp;&nbsp;];
&nbsp;&nbsp;}</code></pre> ・messageメソッドバリデーションエラーの場合のメッセージをカスタマイズする&nbsp;&nbsp;<pre><code>public function messages()
&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;return [
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'name.required' =&gt; '名前を入力してください',
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'name.max' =&gt; '最大32文字で入力してください',
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'email.required' =&gt; 'メールアドレスを入力してください',
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'email.email' =&gt; 'メールアドレス形式で入力してください',
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'password.required' =&gt; 'パスワードを入力してください',
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'password.min' =&gt; '4文字以上で入力してください',
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'password.confirmed' =&gt; 'パスワードが一致していません',
&nbsp;&nbsp;&nbsp;&nbsp;];
&nbsp;&nbsp;}</code></pre>

UserRequest.phpを編集

バリデーションを適用する場合UserRequestクラスで受け取るように編集して紐づける <pre><code>&nbsp;&nbsp;public function confirm(UserRequest $request)
&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;return view('users/confirm', [
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'inputs' =&gt; $request-&gt;all(),
&nbsp;&nbsp;&nbsp;&nbsp;]);
&nbsp;&nbsp;}</code></pre>

UsersControllerを編集

フォームリクエストからバリデーションを作成

各フォームの下にエラーメッセージが表示されるように調整。 <pre><code>…
&nbsp;&nbsp;@error('name')
&nbsp;&nbsp;&nbsp;&nbsp;&lt;p style="color:red"&gt;{{ $message }}&lt;/p&gt;
&nbsp;&nbsp;@enderror
…
&nbsp;&nbsp;@error('email')
&nbsp;&nbsp;&nbsp;&nbsp;&lt;p style="color:red"&gt;{{ $message }}&lt;/p&gt;
&nbsp;&nbsp;@enderror
…
&nbsp;&nbsp;@error('password')
&nbsp;&nbsp;&nbsp;&nbsp;&lt;p style="color:red"&gt;{{ $message }}&lt;/p&gt;
&nbsp;&nbsp;@enderror
…</code></pre>

create.blade.phpを編集

テンプレート編集してエラーメッセージを表示

設定どおりのエラーになり、各フォームの下にメッセージが表示されることを確認 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/a9222546e8fe41dcb3e61a411e05610e/image.png" alt=""> <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/a2d02704b67b45c28892f1092f268147/image.png" alt="">

今回は利用者登録フォームにバリデーションを作成し、各フォームの下にメッセージが表示されるように実装を行いました。

【Laravel】2パターンのバリデーションの作成

入力画面 : /users/create確認画面 : /users/confirm完了画面 : /users/finish今回は上記のようにURLを設定しました。 <pre><code>Route::get('/users/create', [UsersController::class, 'create'])-&gt;name('users.create');
Route::post('/users/confirm', [UsersController::class, 'confirm'])-&gt;name('users.confirm');
Route::post('/users/finish', [UsersController::class, 'store'])-&gt;name('users.store');</code></pre>

route設定

下記コマンドでコントローラーを作成する。<code>php artisan make:controller UserController --resource</code>

・createメソッド<pre><code>&nbsp; &nbsp; public function create()
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; return view('users/create');
&nbsp; &nbsp; }</code></pre>

コントローラーを編集

・resources/views/users/create.blade.php 名前、メールアドレス、パスワードの入力フォームを作成しました。遷移先は確認画面にしています。 <pre><code>&lt;h1&gt;利用者登録入力画面&lt;/h1&gt;
&lt;form method="post" action="{{ route('users.confirm') }}"&gt;
&nbsp; &nbsp; @csrf
&nbsp; &nbsp; &lt;label for="name"&gt;名前&lt;/label&gt;
&nbsp; &nbsp; &lt;input type="text" name="name"&gt;
&nbsp; &nbsp; &lt;br&gt;
&nbsp; &nbsp; &lt;label for="email"&gt;メールアドレス&lt;/label&gt;
&nbsp; &nbsp; &lt;input type="text" name="email"&gt;
&nbsp; &nbsp; &lt;br&gt;
&nbsp; &nbsp; &lt;label for="password"&gt;パスワード&lt;/label&gt;
&nbsp; &nbsp; &lt;input type="password" name="password"&gt;
&nbsp; &nbsp; &lt;br&gt;
&nbsp; &nbsp; &lt;button type="submit"&gt;登録確認画面へ&lt;/button&gt;
&lt;/form&gt;</code></pre>

テンプレートを作成

表示画面

登録入力画面を作成

・confirmメソッド<pre><code>&nbsp; &nbsp; public function confirm(Request $request)
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; return view('users/confirm', [
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'inputs' =&gt; $request-&gt;all(),
&nbsp; &nbsp; &nbsp; &nbsp; ]);
&nbsp; &nbsp; }</code></pre>

・resources/views/users/confirm.blade.php確認→完了画面遷移で入力値を送れるようにhiddenでデータを送っています。 <pre><code>&lt;h1&gt;利用者登録確認画面&lt;/h1&gt;
&lt;form method="post" action="{{ route('users.store') }}" &gt;
&nbsp; &nbsp; @csrf
&nbsp; &nbsp; &lt;input type="hidden" name="name" value="{{ $inputs['name'] }}"&gt;
&nbsp; &nbsp; &lt;input type="hidden" name="email" value="{{ $inputs['email'] }}"&gt;
&nbsp; &nbsp; &lt;input type="hidden" name="password" value="{{ $inputs['password'] }}"&gt;
&nbsp; &nbsp; &lt;label for="name"&gt;名前&lt;/label&gt;
&nbsp; &nbsp; {{$inputs['name']}}
&nbsp; &nbsp; &lt;br&gt;
&nbsp; &nbsp; &lt;label for="mail"&gt;メールアドレス&lt;/label&gt;
&nbsp; &nbsp; {{$inputs['email']}}
&nbsp; &nbsp; &lt;br&gt;
&nbsp; &nbsp; &lt;label for="password"&gt;パスワード&lt;/label&gt;
&nbsp; &nbsp; ****
&nbsp; &nbsp; &lt;br&gt;
&nbsp; &nbsp; &lt;button type="button" onclick=history.back()&gt;戻る&lt;/button&gt;
&nbsp; &nbsp; &lt;button type="submit"&gt;登録する&lt;/button&gt;
&lt;/form&gt;</code></pre>

登録確認画面を作成

・storeメソッドパスワードはハッシュ化して保存しています。 <pre><code>&nbsp; &nbsp; public function store(Request $request)
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; $userData = $request-&gt;all();
&nbsp; &nbsp; &nbsp; &nbsp; $userData['password'] = Hash::make($userData['password']);
&nbsp; &nbsp; &nbsp; &nbsp; User::create($userData);
&nbsp; &nbsp; &nbsp; &nbsp; return view('users.finish');
&nbsp; &nbsp; }</code></pre>

・resources/views/users/finish.blade.php <pre><code>&lt;h1&gt;利用者登録完了画面&lt;/h1&gt;
登録が完了しました。
&lt;br&gt;
&lt;button type="button" onclick="location.href='{{ route('users.index') }}' "&gt;一覧画面へ戻る&lt;/button&gt;</code></pre>

登録完了画面を作成

・入力した「利用者２」のユーザーが登録できていることを確認<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/759374fde34e410cb460f91bcc025d32/image.png" alt="">

DBの確認

確認

今回はLaravelでの入力画面→確認画面→完了画面を遷移してデータの登録を行う処理を実装してみました。

【Laravel】入力→確認→完了画面を遷移してのデータ登録の実装

Application Programming Interfaceの略称であり、アプリケーションやソフトウェアをつなぐためのインターフェースです。

APIとは

<code>php artisan route:list</code> <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/b8c8844da0f047de891c036e9d24b8e0/image.png" alt="">

route確認

・indexメソッドを編集<pre><code>&nbsp;&nbsp;public function index()
&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;$blogs = Blog::all();
&nbsp;&nbsp;&nbsp;&nbsp;return response()-&gt;json([
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'status' =&gt; true,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'blogs' =&gt; $blogs
&nbsp;&nbsp;&nbsp;&nbsp;], 200);
&nbsp;&nbsp;}</code></pre> ・postmanから動作確認<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/cecbab14dcef413aaa17c90bb61dac99/image.png" alt="">

一覧表示

・showメソッドを編集<pre><code>&nbsp; &nbsp; public function show(string $id)
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; $blogs = Blog::find($id);
&nbsp; &nbsp; &nbsp; &nbsp; if($blogs){
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'message'=&gt; 'Blog found',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'data' =&gt; $blogs
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ], 200);
&nbsp; &nbsp; &nbsp; &nbsp; } else {
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'message'=&gt; 'Blog not found',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ], 404);
&nbsp; &nbsp; &nbsp; &nbsp; }
&nbsp; &nbsp; }</code></pre> ・postmanから動作確認指定したidが存在する場合<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/7a8e3afb1bbf4b8f9f5114aea445006c/image.png" alt=""> 指定したidが存在しない場合<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/58d46a05c8414712b01a73b040a7abea/image.png" alt="">

特定のidのデータを表示

・updateメソッドを編集<pre><code>&nbsp; &nbsp; public function update(Request $request, string $id)
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; $update = [
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'title' =&gt; $request-&gt;title,
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'content' =&gt; $request-&gt;content
&nbsp; &nbsp; &nbsp; &nbsp; ];
&nbsp; &nbsp; &nbsp; &nbsp; $blog = &nbsp;Blog::where('id', $id)-&gt;update($update);
&nbsp; &nbsp; &nbsp; &nbsp; $blogs = Blog::all();
&nbsp; &nbsp; &nbsp; &nbsp; if ($blog) {
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'message'=&gt; 'Blog update',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'data' =&gt; $blogs
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ], 200);
&nbsp; &nbsp; &nbsp; &nbsp; } else {
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'message' =&gt; 'Blog not found',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ], 404);
&nbsp; &nbsp; &nbsp; &nbsp; }</code></pre> ・postmanから動作確認title : 「タイトル更新」content : 「内容更新」<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/7ea220ad6c3e43b58cb345436af3bb9a/image.png" alt="">

特定のidのデータを更新

・destroyメソッドを編集<pre><code>&nbsp; &nbsp; public function destroy(string $id)
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; $blog = Blog::where('id', $id)-&gt;delete();
&nbsp; &nbsp; &nbsp; &nbsp; if ($blog) {
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'message' =&gt; 'Blog deleted successfully',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ], 200);
&nbsp; &nbsp; &nbsp; &nbsp; } else {
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json([
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 'message' =&gt; 'Blog not found',
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ], 404);
&nbsp; &nbsp; &nbsp; &nbsp; }
&nbsp; &nbsp; }</code></pre> ・postmanで動作確認（id=1を削除）<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/b596921f002b4d0c8edb8b42013a8e6b/image.png" alt=""> ・A5SQLでid=1のデータが削除されていることを確認。<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/7599751fc7a646178c7dbf2f63dec33f/image.png" alt="">

特定のidのデータを削除

コントローラーに処理を追加  (BlogController.php)

今回はLaravelを使用して簡易的なAPIを実装してみました。

【Laravel】簡易API実装②

Application Programming Interface の略称であり、アプリケーションやソフトウェアをつなぐためのインターフェースです。

・マイグレーションファイルを作成<code>php artisan make:model Blog -m</code> ・作成したファイル内でblogsテーブルのカラムを設定今回はタイトル(title)と本文(content)カラムを設定する。<pre><code>&nbsp; &nbsp; public function up(): void
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; Schema::create('blogs', function (Blueprint $table) {
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; $table-&gt;id();
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; $table-&gt;string('title');
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; $table-&gt;string('content');
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; $table-&gt;timestamps();
&nbsp; &nbsp; &nbsp; &nbsp; });
&nbsp; &nbsp; }</code></pre> ・マイグレーション実行<code>php artisan migrate</code>

マイグレーションからモデルを作成

・コントローラーファイルを作成<code>php artisan make:controller BlogController --resource</code> ・storeメソッドを編集<pre><code>&nbsp; &nbsp; /**
&nbsp; &nbsp; &nbsp;* Store a newly created resource in storage.
&nbsp; &nbsp; &nbsp;*/
&nbsp; &nbsp; public function store(Request $request)
&nbsp; &nbsp; {
&nbsp; &nbsp; &nbsp; &nbsp; $blog = Blog::create($request-&gt;all());
&nbsp; &nbsp; &nbsp; &nbsp; return response()-&gt;json(['blog'=&gt; $blog]);
&nbsp; &nbsp; }</code></pre>

■routes\api.php 下記を追記<pre><code>Route::apiResource('blogs', \App\Http\Controllers\Blogontroller::class);</code></pre>

route作成

title : 「タイトル」content : 「内容」 ・上記のデータをpostmanを使用し新規登録<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/ac816c8fa4c841c59269fc489dd4b5d4/image.png" alt=""> ・DBを確認<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/76d61b8bc9654dbda52383a9b8e1e5d6/image.png" alt="">

今回はLaravelを使用して簡易的なAPIを実装してみました。

【Laravel】簡単API実装①

まず、Composerを使用してLaravelプロジェクトを作成しました。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/6fe1cab3575e4b339726d39a3e8ef5b2/image.png" alt="">

Laravelのインストール

Laravelプロジェクトのディレクトリ構成は以下の通りです。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/88ccfd6fb35f43ecb9beefe72288f5f2/image.png" alt="">

プロジェクトのディレクトリ構成

`routes/web.php`ファイルにルートを定義しました。今回はRestfulリソースコントローラーでの手法の指定をしました。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/218571a49ab34d4ab4d105664f3a9bc1/image.png" alt="">

ルーティングの設定

Artisanコマンドを使用してコントローラーを作成しました。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/d7446938a1f14f11b485de2e33e1c129/image.png" alt=""> 作成後はコントローラが存在することを確認する <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/b27ee6140d1e4b2d9a250917840f6af4/image.png" alt="">図中にもコメントアウトしておりますが、DBから情報を取得する必要がありますので、上部にてテーブルの指定をお忘れなく！！

コントローラーの作成

Artisanコマンドにはデフォルトでビューを作成するためのコマンドが備わっていないため今回特別に作成してみました。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/2fd31c2243e545978c06bae688ca7188/image.png" alt="">まずはArtisanコマンドを使用しカスタムビューファイルを作成します。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/824d62dd4b4b45d4bf83579b1b91785c/image.png" alt=""><img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/3e716fd278ae4c5a8d6139c515108d9e/image.png" alt="">カスタムビューファイルにて指定された名前通りにパスをつけて作成するだけでなくファイル内に必要最低限のhtmlコードを作成して出力できるようにしました！

カスタムビューコマンドの作成

Artisanコマンドを使用してビューを作成しました。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/43756cfabefa4f18914c03afa6c28f52/image.png" alt="">

ビューの作成

作成されたビューファイルに対し下記の様に編集しました。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/e1150477c11e434c9babc4b6607eee5b/image.png" alt="">

ビューの編集

Artisanコマンドを使用してルーティング確認しました。下図赤枠の通り、指定されたURLとコントローラ内のindexがリンクしていることが確認できます。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/a317064a4ae845a7ab30638be62d5335/image.png" alt="">

ルーティング確認

下図の通りルーティング確認した通りURLへアクセスすると一覧画面が表示されることが確認できます。 <img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/d3ae1bf46aba4f4e8f143cac53efba0c/image.png" alt="">

ブラウザ表示

以上が、Laravelを使ってルーティングからビューの作成までの基本的な流れです。カスタムビューコマンド作成など少々イレギュラーなこともしましたが、今まで実務で使用してきたCakePHPよりもArtisanコマンドを使用したバッチ処理を使用する機会がとても多く、またシンプルに効率的に作成することが出来るというメリットも理解することが出来ました。

LaravelPHPのルーティングからビューの作成まで

Laravelは、2011年頃開発されたPHPのWebアプリケーションフレームワークです。エレガントでシンプルなコードを書くことができるため、開発者にとって非常に人気があります。また、Laravelは、以下のような特徴を持っています。 ・エレガントなシンタックス:	Laravelは、読みやすく書きやすいコードを提供します。・豊富な機能:	認証、ルーティング、セッション管理、キャッシングなど、多くの機能が標準で提供されています。・強力なツール:	Artisan CLIやEloquent ORMなど、開発を効率化するためのツールが豊富です。・コミュニティとサポート:	活発なコミュニティと豊富なドキュメントがあり、初心者でも学びやすい環境が整っています。

Laravelの概要

Laravelの導入は比較的簡単で、以下の手順で行います。 ・WebサーバーからComposerまでの導入:	まずは、フレームワークを問わずPHPを使用したWebシステム開発環境を構築する上で最低限必要なソフト等を導入する。&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;・新しいLaravelプロジェクトの作成:	次に、新しいプロジェクトを作成します。			<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/3f9e392e5b504f3e9b733069d6857b6d/image.png" alt=""> ・環境設定:	`.env`ファイルを編集して、データベース接続などの環境設定を行います。 ・マイグレーションの実行:	データベースのテーブルを作成するために、マイグレーションを実行します。 		<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/ec43ae53c5c74ebeaab0cfd7f59d822a/image.png" alt=""> ・サーバーの起動:	開発サーバーを起動して、アプリケーションを確認します。			<img src="https://images.microcms-assets.io/assets/b30d7661c2694503832399a83cea2137/4aae6f49a8c14f74a520d05c585f7ba2/image.png" alt="">

Laravelの導入の流れ

LaravelとCakePHPはどちらもPHPのフレームワークですが、それぞれに特徴があります。 ・柔軟性:&nbsp;・Laravel: 高い柔軟性を持ち、開発者が自由にカスタマイズできます。最新の技術やトレンドに対応しやすいです。&nbsp;・CakePHP: 規約に従った開発を推奨しており、一貫性のあるコードを書くことができますが、柔軟性はやや低いです。 ・学習コスト:&nbsp;・Laravel: 豊富なドキュメントとコミュニティサポートがあり、初心者でも学びやすいです。&nbsp;・CakePHP: シンプルな設計で、初心者でも理解しやすいですが、規約に従う必要があります。 ・開発スピード:&nbsp;・Laravel: 多機能で利便性が高く、大規模な開発に向いています。&nbsp;・CakePHP: 規約に従うことで高速な開発が可能ですが、柔軟なカスタマイズには時間がかかることがあります。 ・コミュニティとサポート:&nbsp;・Laravel: 活発なコミュニティと豊富なリソースがあり、サポートが充実しています。&nbsp;・CakePHP: コミュニティは活発ですが、Laravelほどの規模ではありません。

CakePHPとの比較

Laravelは、エレガントなシンタックスと豊富な機能を持つフレームワークで、柔軟性が高く、最新の技術に対応しやすいです。一方、CakePHPは規約に従った開発を推奨し、高速な開発が可能ですが、柔軟性には欠ける部分があります。どちらのフレームワークもそれぞれの強みがあり、プロジェクトの要件に応じて選択することが重要です。

BuildersIO produced by YOKU

#PHP の記事一覧

【Laravel】JWT認証機能の実装

【Docker】Laravel 11 環境の構築

【Docker】PHP環境の構築

【Laravel】2パターンのバリデーションの作成

【Laravel】入力→確認→完了画面を遷移してのデータ登録の実装

【Laravel】簡易API実装②

【Laravel】簡単API実装①

LaravelPHPのルーティングからビューの作成まで

Laravelの概要と導入の流れ、CakePHPとの比較

単体テストのベストプラクティス

OpenAIとDeeplのAPIを使ってChatGPTのCLIツール作ってみた

Auth0環境を構築して自作のAPIと連携してみた