PHPerのための「Laravel 入門を語り合う」PHP TechCafe
=================================================

# Laravel クイックスタート

## Laravel導入手段

参考：[PHPerのための「Laravel/PHP8/Dockerで開発環境作りを語り合う」TechCafe](https://hackmd.io/@hrxVDayfRGeTR-1JBV3QLA/H1NeB2asD)

- Docker系
- [Laravel Sail](https://readouble.com/laravel/8.x/ja/installation.html#your-first-laravel-project)（Laravel公式Docekr環境）
- LaravelのDocker開発環境を操作するための軽量コマンドラインインタフェイス
- 以下のサービスを合わせて利用できる
- MySQL
- PostgreSQL
- MariaDB
- Redis
- Memcached
- MeiliSearch
- MinIO
- Selenium
- MailHog
- [laradock](https://laradock.io/)
- いわゆる全部入りのLaravel Docker環境
- 設定ファイルを修正して独自の環境が作成可能
- 例えば、PHP7 + PostgreSQL + Nginx みたいな自分好みの環境が作れる
- プロジェクトのディレクトリ配置されている箇所に新しくLaradocを配置するだけでよいのでプロジェクトをDockerコンテナ上にマウントさせるだけなら比較的すぐに始められる

- [vessel](https://vessel.shippingdocker.com/)
- こちらも同じくLaravel Docker環境
- PHP8.0に対応していない
- PHP 7.4, MySQL 5.7, Redis（最新）, NodeJS（最新）、NPM、Yarn、Gulp

- [docker-laravel](https://github.com/ucan-lab/docker-laravel)
- ucanさんのOSS
- 日本語で解説があるので入りやすい
- https://qiita.com/ucan-lab/items/5fc1281cd8076c8ac9f4
- ローカルマシン系
- [Composerで自分でいれる](https://readouble.com/laravel/8.x/ja/installation.html#installation-via-composer)
- 導入後 `php artisan serve` で立ち上がる
- 直接プロジェクトを作る or　インストーラを導入してからプリジェクトを作る
- DBは sqlite でOK
- [Laravel Jetstream](https://jetstream.laravel.com/1.x/introduction.html) も利用可能
- [Valet](https://readouble.com/laravel/8.x/ja/valet.html)
- 軽量であることが売りのmacOS向けLaravel開発環境
- 極端なマシンスペックでの開発や、速度重視の場合に利用
- Laravel以外のFWでも利用可（Cake PHPや、Symfony、Lumenなど）
- DBマネージャのDBnginを使うことで PostgreSQL、MySQL、Redis などが利用可能
- Homebrew 必須

- 仮想環境系
- [Homestead](https://readouble.com/laravel/8.x/ja/homestead.html)
- Vagrant　を使ったLaravel開発環境
- Vagrant が仮想化ソフト(VirtualBoxなど)の管理と事前設定をすべてやってくれる
- 実態としては仮想環境上の Ubuntu 上で Laravel の実行環境ができあがる
- Vagrant と 仮想化ソフト（VirtualBox or Parallels）が必須

--------------------------

## 大まかな流れ

* Laravel Sail でサービス起動
* 処理の流れ紹介
* ルーティング
* Controller
* Blade
* Controller 作成
* Blade 作成
* Controller から Blade にパラメータを返す
* ToDoアプリを作成する
* Migrationを作成する
* Seederを作成する
* Modelを作成する
* Controller側に処理を追加する
* Modelを利用してDBアクセスする

## WSL2 の環境に Laravel Sail の環境を作成する手順

公式リファレンス
https://laravel.com/docs/8.x/installation#getting-started-on-linux

※Laravel Sail を導入する環境に docker と docker-compose がインストールされていること

# laravel-todo-app というプロジェクトの環境作成
curl -s https://laravel.build/laravel-todo-app | bash

# Laravel Sail による開発環境起動
cd laravel-todo-app
./vendor/bin/sail up
# 初回起動はDockerコンテナ作成にかなり時間がかかる

# http://localhost/ にアクセス
# Laravel の初期画面が表示される

### Docker のセキュリティ機能によりプロジェクト作成に失敗する場合は以下を確認
https://qiita.com/nasuB7373/items/92166d7958044ab8d450

## 処理の流れ

### ルーティング

* [Routing](https://laravel.com/docs/8.x/routing#the-default-route-files)
* `routes/web.php ` にリクエストURLと対応する処理を記述する
* web.php からViewを返すこともできる
* コントローラに処理を回すこともできる
* 基本的はコントローラに処理を回すことが圧倒的に多いと思われる
* Laravel で新規プロジェクトを作成した際は以下が初期設定されている

Route::get('/', function () {
    return view('welcome');
});

* 上記は`http://localhost` にアクセスすると `welcome.blade.php` を返すという処理になっている
* view() メソッドは `resources/view` 配下の引数指定されたファイルをViewとして表示する処理

#### ルーティング基礎

* `web.php` に以下を追加

Route::get('/hello', function () {
    return view('hello');
});

* `resources/views` 配下に `hello.blade.php` というファイルを新規作成
* 以下のHTMLを記述

<h1>PHPerのための「Laravel 入門を語り合う」PHP TechCafe</h1>

<div>
    <p>Hello World!</p>
</div>

* `http://localhost/hello` にアクセス
* 上記のHTMLが表示される

### Viewにパラメータを追加

* `web.php` に追加した処理を以下の通り修正

Route::get('/hello/{name}', function ($name) {
    return view('hello',['name' => $name]);
});

* `resources/views/hello.blade.php` を以下の通り修正

<h1>PHPerのための「Laravel 入門を語り合う」PHP TechCafe</h1>

<div>
    <p>Hello World!</p>
    @isset($name)
    <p>Hello {{$name}}!</p>
    @endisset
</div>

* `http://localhost/hello/Rakus` にアクセス
* Hello Rakus! と画面に表示される

[view](https://laravel.com/docs/8.x/views#introduction)　の参考ページ

### Controller 作成

* Laravel の artisan のコマンドで Controller を作成
* [Laravel Sail](https://laravel.com/docs/8.x/sail#executing-artisan-commands) で [artisan](https://laravel.com/docs/8.x/artisan#introduction) コマンドを実行する際は以下を実行

cd laravel-todo-app
./vendor/bin/sail artisan make:controller HelloController

* `Http/controllers` 配下に `HelloController` が追加される

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HelloController extends Controller
{
    //
}

* HelloController に以下のような index メソッドを追加する

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HelloController extends Controller
{
    public function index()
    {
        return view('hello');
    }
}

* `web.php` に Controller のルーティングを記載

// 追加した Controller を use に追加
use App\Http\Controllers\HelloController;

// 省略

// Controller のルーティングを追加
Route::get('/hello', [HelloController::class, 'index']);

* `http://localhost/hell` にアクセス
* Controller の index メソッドが呼び出され View を表示できる

### Controller から View にパラメータを渡す

* HelloController の index メソッドを以下の通り修正

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HelloController extends Controller
{
    public function index()
    {
        return view('hello', ['name' => 'Rakus']);
    }
}

* `http://localhost/hell` にアクセス
* Controller から渡された値を View にセットできる

* [Controller](https://laravel.com/docs/8.x/controllers#basic-controllers) の参考ページ

### ToDo アプリを作成する

* タスクを追加・編集・削除が可能なToDoアプリを作成する

* まずは以下のような構成のテーブルを作成する
* id
* integer
* task
* text
* timestamp
* timestamp

### Migration について

* テーブル定義の作成
* Migration ファイルを作成しておけばテーブル定義を簡単に共有できる
* アプリケーションの構築も `artisan` コマンドを１回実行するだけでOK

* 以下のコマンドを実行する

cd laravel-todo-app
./vendor/bin/sail artisan make:migration create_todo_table

* `database/migrations` 配下に `YYYY_MM_DD_XXXXXXX_create_todos_table.php` というファイルが作成される
* 中身は以下の通り

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateTodoTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('todo', function (Blueprint $table) {
            $table->id();
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('todo');
    }
}

* up メソッドの中を修正してテーブル定義を作成する
* なお、設定可能な列の一覧は以下
* [Available Column Types](https://laravel.com/docs/8.x/migrations#available-column-types)

public function up()
{
    Schema::create('todo', function (Blueprint $table) {
        $table->id();
        $table->text('task');
        $table->timestamps();
    });
}

以下コマンドを実行してテーブルを作成

cd laravel-todo-app
./vendor/bin/sail artisan migrate

* なお、テーブル定義を新しく作り直す場合は列だけを追加する Migration を作成しなくても、既存の Migration を修正し以下コマンドでテーブルを再作成できる

cd laravel-todo-app
./vendor/bin/sail artisan migrate:fresh

[Migration](https://laravel.com/docs/8.x/migrations#introduction) の参考ページ

### Seeder を登録する

* Seeder を利用することでアプリケーションの初期データを登録できる

* 以下コマンドを実行する

cd laravel-todo-app
./vendor/bin/sail artisan make:seeder TodosSeeder

* `database/seeders` 配下に `TodoSeeder` というファイルが作成される
* 中身は以下の通り

<?php

namespace Database\Seeders;

use Illuminate\Database\Seeder;

class TodosSeeder extends Seeder
{
    /**
     * Run the database seeds.
     *
     * @return void
     */
    public function run()
    {
        //
    }
}

* runメソッドの中身を以下の通り修正

public function run()
{
    DB::table('todos')->insert([
        'task' => 'PHPの勉強'
    ]);
    DB::table('todos')->insert([
        'task' => 'Laravelの勉強'
    ]);
    DB::table('todos')->insert([
        'task' => 'PHPTechCafeへの参加'
    ]);
}

* 以下コマンドを実行してSeederを登録

cd laravel-todo-app
./vendor/bin/sail artisan db:seed --class=TodosSeeder

[Seeder](https://laravel.com/docs/8.x/seeding#introduction) の詳細ページ

### Model について

* Laravel で利用可能な ORM として Eloquent を利用するとDBアクセスの処理が容易に書ける

* 以下コマンドで `todo` テーブルにアクセスするための Model を作成する

cd laravel-todo-app
./vendor/bin/sail artisan make:model Todo

[Model](https://laravel.com/docs/8.x/eloquent#generating-model-classes) の詳細ページ

### Model を利用する

* Model を利用して `登録`, `編集`, `削除` を実行する

* 登録
* [Inserts](https://laravel.com/docs/8.x/eloquent#inserts)
* 編集
* [Updates](https://laravel.com/docs/8.x/eloquent#updates)
* 削除
* [Delete](https://laravel.com/docs/8.x/eloquent#deleting-models)

### Todoアプリ用の各種データを登録する

* 新規作成
* TodoController
* Todoアプリ用のController
* todo.blade.php
* TodoアプリのView
* 各種ファイルの中身は GitHub のソース参照
* [web.php](https://github.com/MasaKuuuu/laravel-todo-app/blob/main/routes/web.php)
* [TodoController](https://github.com/MasaKuuuu/laravel-todo-app/blob/main/app/Http/Controllers/TodoController.php)
* [Request](https://laravel.com/docs/8.x/requests#introduction) の処理を追加していることに注意
* 一覧表示は各種メソッド内で index() メソッドの戻り値を取得するようにしている
* [todo.blade.php](https://github.com/MasaKuuuu/laravel-todo-app/blob/main/resources/views/todo.blade.php)
* POSTなどのリクエスト時は `@csrf` を form に含めていないとリクエスト処理時にエラーになるため注意
* [詳細](https://laravel.com/docs/8.x/csrf#csrf-introduction)
* web.php のルーティング変更
* `/todo/index`
* Todoリストを取得
* `/todo/create`
* タスクを追加
* `/todo/edit`
* タスクを編集
* `/todo/delete`
* タスクを削除

* `http://localhost/todo` にアクセス
* 各主動作の確認

## おまけ：Resource Controllers
https://laravel.com/docs/8.x/controllers#resource-controllers

手軽にREST APIを作成するためのテクニック