例えば投稿機能postコントローラーがあり、特定のuser_idの引数に渡す。
このページにアクセスした時に、
引数としてユーザーID（テーブル上では 'user_id'）があれば、そのユーザーIDのpostだけをAPIとして表示し、
引数がなければ全postをAPIで表示したいときなんかの動き。

route側の設定

api.php

Route::get('postlist/{id?}','PostController@postlist');

こんな感じで引数に「?」を入れると、引数ありでもなしでもいけるよって言うルーティングを許可します。

コントローラー側の設定

idのある場合とない場合の動作もコントローラーに記述が必要です。

PostController.php

public function postlist($id = null)
    {   
        if($id == null){
            //user_idが入ってない場合は全ポストを取得
            $posts = Post::All();
        }else{
            //user_idが入っている場合は全ポストを取得
            $posts = Post::where('user_id', $id)->get();
        }
        return $posts;
    }

ユーザーIDが入っていない場合、user_idにかかわらず、全ユーザーのpostを返してくれる。

ユーザーIDが入っている場合、そのユーザーIDの情報だけをAPIで返してくれる。

こんにちは、くりぱんです。

この記事で実現できること

• 共通関数の作成＆実装
• コントローラーの簡略化
• コントローラーのメンテナンス性向上

説明

今回実装するのは、Hello world!と出力する処理を複数のコントローラーで実装する時に、それぞれのコントローラーで記述するのではなく、共通関数を作成し同じ処理を何回も書かないようにする方法です。

私の場合、チャット機能実装の際に、チャットルームを作成するという処理を複数のコントローラーで記述しなければならなかったので、チャットルーム作成という機能を共通関数化し、それぞれのコントローラーで共通関数を使い回す手法を行いました。

その時の備忘録を今回簡単に残していこうと思います。

開発環境

• OS： MacOS Catalina
• PHP： 7.3.11
• Laravel： 6

実装の流れ

1. Laravelプロジェクト作成
2. composer.jsonへ登録
3. composer dump-autoload実行
4. config/app.phpにエイリアスとして追加
5. 共通関数作成
6. 処理を利用したいコントローラでuseする
7. routeの設定
8. viewの設定

実装

Laravelプロジェクト作成

今回はMAMPのhtdocs内にLaravelのプロジェクトを作成していきます。
ターミナルで以下のコマンドを実行してください。

$ cd /Applications/MAMP/htdocs
$ composer create-project --prefer-dist laravel/laravel commonHelloWorld "6.*"

これでhtdocs配下にcommonHelloWorldというLaravelのプロジェクトが作成されました。
記事の中では、/Applications/MAMP/htdocs/commonHelloworldフォルダのことをプロジェクトフォルダと呼んでいきます。

composer.jsonへ登録

今回はcommonHelloworld/appにCommonフォルダを作成し、そこに共通関数を格納していきます。
そのため、プロジェクトフォルダ配下にcomposer.jsonがあるので以下の通りに編集してください。

composer.json

{
    ー省略ー

    "autoload": {
        "psr-4": {
            "App\\": "app/"
        },
        "classmap": [
            "database/seeds",
            "database/factories", // 最後にコンマを追加
            "app/Common" // ここを追加
        ]
    },

    ー省略ー
}

composer dump-autoload実行

まずは、commonHelloworld/app配下にCommonフォルダを作成してから以下のコマンドを実行してください。

$ composer dump-autoload

下記のような感じになれば成功です。

Package manifest generated successfully.
Generated optimized autoload files containing 4255 classes

もし下記のようなエラーが出た時は、commonHelloWorld/appにCommonフォルダを作成してくださいね！

  [RuntimeException]                                                                              
  Could not scan for classes inside "app/Common" which does not appear to be a file nor a folder

config/app.phpにエイリアスとして追加

commonHelloWorld/config/app.phpのaliasesに共通関数の登録を行っていきます。
今回は、クラス名をsayHelloにするので、下記のように記述してください。
※クラス名は自由です。
※共通関数と同じクラス名にしてください。

app.php

<?php

return [

    ー省略ー
    'aliases' => [

        ー省略ー

        'URL' => Illuminate\Support\Facades\URL::class,
        'Validator' => Illuminate\Support\Facades\Validator::class,
        'View' => Illuminate\Support\Facades\View::class,
        'sayHelloClass' => app\Common\sayHelloClas::class, //ここを追加
    ],

共通関数作成

今回は、単純にHello World!を出力するだけなので、commonHelloWorld/app/Common配下にsayHelloClass.phpを作成し、以下のように記述してください。

sayHelloClass.php

<?php

namespace app\Common;

class sayHelloClass
{
    public static function sayHello()
    {
        echo "Hello World!";
    }
}

処理を利用したいコントローラでuseする

まずは処理を利用したいコントローラーを作ります。
以下のコマンドをプロジェクトフォルダ配下で実行してください。

$ php artisan make:controller topContorller

これで、app/Http/Controllers配下にtopController.phpというコントローラーが作成できました。

では、以下のように編集してください。

topController.php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Common\sayHelloClass;

class topController extends Controller
{

    public function show()
    {
        sayHelloClass::sayHello();

        return view(
            'topShow'
        );
    }
}

これでtopShowというviewファイルにHello World!が出力されるようになります！
なお、topShowはこれから作成します。

routeの設定

次に、routeの設定をしていきます。
commonHelloWorld/routes/web.phpを下記のように編集してください。

web.php

<?php
Route::get('/', 'topController@show')->name('top.show');

これでrouteの設定は終わりました。

viewの設定

続いて、Viewファイルの作成です。
commonHelloWorld/resources/viewsにtopShow.blade.phpを作成し、下記のように編集してください。

topShow.blade.php

<!DOCTYPE html>
<html lang="ja">

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>

<body>
  これはトップだよ！
</body>

</html>

これで、あとは下記のコマンドでサーバーを立ち上げて、画面を確認してみましょう！

$ php artisan serve

画面を表示して、Hello World! これはトップだよ！　と出てくれば成功です！

最後に

こんな簡単にコントローラーから機能を切り分けられるんですね！
さらに、これを使い回せば同じ処理を何回も書かなくていいですし、メンテナンス性も向上するしで、一石二鳥ですね！
他にもファットコントローラーをスリムにするやり方があるので、まとめていきたいな！

何か間違ったことがあったり、質問・意見等あればコメントへお願いいたします！

それでは、当記事を最後まで見ていただき、ありがとうございました！

初めに

最近、React/Redux開発をするようになり、勉強のためにAPIサーバーを立てたいと思い、Laravelでさくっと、簡単なAPIサーバー立てようというのが、本記事の主旨となります。(※Reactから、API叩く際のCORSの設定などは追って、記事として残そうと思います)

対象者

ReactやVueを勉強していて、自分でAPI作成して学習したい方
取り敢えず、LaravelでAPIをさくっと作る流れが知りたい方

Laravel 新規プロジェクトを作成する

まず、新規でLaravelプロジェクトを作成しましょう。

laravelをインストール

composer create-project "laravel/laravel=6.*" laravelapi

ModelとMigrationファイルを作成

ここでは、良くあるArticleモデルのケースで作成していきます。

因みにここでは、Modelsディレクトリを切って作成しています。
同じように進めたい場合は、以下記事を参考にしてみて下さい。
[Laravel 6] Modelsディレクトリを作る

(因みに８系からModelsディレクトリはデフォルトで作成されます。)

titleとdescriptionカラムを追加します。

ArticleModelを作成する

php artisan make:model Models/Article -m

public function up()
{
    Schema::create('articles', function (Blueprint $table) {
        $table->bigIncrements('id');
        $table->string('title');
        $table->text('description');
        $table->timestamps();
    });
}

以下、コマンドでDBに反映しましょう。

php artisan migrate

ArticleControllerを作成する

php artisan make:controller Api/ArticlesController -r

アクションを定義します。

ArticlesController.php

public function index()
{
    $articles = Article::all();
    return $articles;
}

public function store(Request $request)
{
    $article = new Article;
    $article->title = $request->body;
    $article->body = $request->body;
    $article->save();
}

public function show($id)
{
    $article = Article::find($id);
    return $article;
}

public function update(Request $request, $id)
{
    $article = Article::find($id);
    $article->title = $request->title;
    $article->body = $request->description;
    $article->save();
}

public function destroy($id)
{
    $article = Article::find($id);
    $article->delete();
}

ルーティングを設定する

APIのルーティングは、api.phpに記述します。

api.php

Route::group(['middleware' => ['api']], function(){
    Route::resource('articles', 'Api\ArticlesController', ['except' => ['create', 'edit']]);
});

テストデータを作成

最後にテストデータを追加しましょう。

php artisan make:seeder ArticlesTableSeeder

ArticlesTableSeeder.php

public function run()
{
    DB::table('articles') -> insert([
        [
            'title' => 'React',
            'description' => 'hoge...'
        ],
        [
            'title' => 'Redux',
            'description' => 'fuga...'
        ],
    ]);
}

DatabaseSeeder.php

public function run()
{
     $this->call(ArticlesTableSeeder::class);
}

php artisan db:seed

以上でAPI実装の一通りの作業は完了です。

終わりに

簡素なものですが、この流れで、APIを作ることができます。
動作確認はPostmanなどで確認してみましょう。

次はこれを利用して、ReactからこのAPIを叩いてみます。

実務でLaravelを使って日付検索をしたことがあるので、ここで共有+アウトプットをしておく。

リクエストで文字列で渡ってきた日付を操作する必要があったのですが、簡単に調べてみるとdate関数とstrtotime関数を使えば簡単にできそう

date関数とstrtotime関数とは

公式より引用date関数
公式より引用strtotime関数

• date関数・・・ ローカルの日付/時刻を書式化する。 指定された引数 timestamp を、与えられた フォーマット文字列によりフォーマットし、日付文字列を返します。 タイムスタンプが与えられない場合は、現在の時刻が使われます。

date ( string $format [, int $timestamp = time() ] ) : string

つまり第一引数のフォーマットにしたがって、第2引数のtimestampが日付文字列で変換される模様。

• strtotime関数・・・英文形式の日付を Unix タイムスタンプに変換する この関数は英語の書式での日付を含む文字列が指定されることを期待しており、 now で与えられたその形式から Unix タイムスタンプ (1970 年 1 月 1 日 00:00:00 UTC からの経過秒数) への変換を試みます。 now が指定されていない場合は現在日時に変換します。

strtotime ( string $datetime [, int $now = time() ] ) : int

こちらは文字列型の日付をint型の時間で返す模様。

ここの第1引数で様々な操作ができます。
月、週、日付、時間など
ここではある日にちを第一引数としたものを1日追加してみましょう

$day = "2020-11-12";
echo strtotime($d . "+1 day"); //1605225600

という具合です。

なのでstrtotimeで文字列型の日付を一度操作して、date関数の第二引数に当てはめます。

$day = "2020-11-12";
echo date( "Y-m-d", strtotime($d . "+1 day")); //2020-11-13

という感じでリクエストで渡ってきた日付の文字列を操作できました。

使うこともあるかと思うので、是非参考にしてみてください。
ここでは紹介しませんがCarbonライブラリというのもあるみたいなので、そちらも調べてみるといいかもです。

最後まで読んでいただきありがとうございました。

参考文献

strtotime関数
date関数
qiita記事

簡単に自己紹介

・東京で土木の構造設計をやっている30代前半
・働きつつ、これから転職活動するところ
・健康好きで趣味はアンチエイジング

どんなアプリ？ 何ができる？

ひとことで言うと
「パレオダイエッター(という健康法をやってる人)向けのコミュニティ＋計算機能ツール」
です。

基本的なユースケースとしては、
　・「ユーザー登録/ログイン/プロフィール編集」
　・「文字や画像を投稿・編集/いいね/コメントで交流」
　・「筋肉をつける・腹筋を割るための目標カロリー算出→マイページ登録」
という感じになります。

もう少し機能を細分化すると、
　・ユーザー登録・ログイン機能・ゲストログイン機能
　・プロフィール編集機能（自己紹介文とアバター画像）
　・投稿作成機能（モーダル画面,文字数カウント,画像投稿）
　・コメント機能
　・投稿とコメントの編集・削除機能
　・いいね機能（Ajax利用,リレーション数取得）
　・効率よく筋肉をつけるための目標摂取カロリーおよび三大栄養素の計算機能（Ajax）
　・最速で腹筋を割るための目標摂取カロリーおよび三大栄養素の計算機能（Ajax）
　・投稿の検索機能とページネーション
といった具合です。

使用技術と環境は？

・言語：PHP7, JavaScript(jQuery), Bootstrap, HTML, CSS(Sass)
・フレームワーク：Laravel7
・DBMS：MySQL
・インフラ：AWS（EC2,RDS,ELB,S3,Route53,ACM）
・Webサーバー：Amazon Linux OS 2, Apache
・開発環境：ローカル環境(MacOS), VSCode
　（本当はDockerなども導入したかったですが..）

作った背景と目的

ポートフォリオを作った理由は、
　①転職時に必要不可欠と考えるため
　②アプリ開発を経験することで成長したいため
　③必要な機能を実装して価値を提供したいため
の3つです。

①転職時に必要不可欠と考えるため

職務経歴や経験で充分にスキルを示せる場合は別ですが、そうでない場合は何かモノを作っていないとスキルを定量的に示すことができないかなぁと思います。
これは、もし自分が評価する側だったら「勉強してますが何も作ったことはありません！」だと、その人がこれから活躍していく姿をうまくイメージするのは難しいと考えるためです。

②ゼロからアプリ開発を経験することで成長したいため

Progateなどの教材はとても分かりやすいですが、環境構築や設計、エラー解消といった場面に遭遇することはありません。
また書籍や動画の教材もそうですが何か問題に遭遇してもそこに答えのコードがあるので、実際にロジックを考えることはほぼ無いと言えます。(書いてあるコードを再現すれば動く)

やはり実際に「こんなものを作りたい」→「そのために必要なことは？」→「問題が発生」→「試行錯誤」→「解決！」といったプロセスを経験することで得られる学びは計り知れないほど大きいと思います。

③必要な機能を実装して価値を提供したいため

人に貢献することが好きなので、アプリ制作をするなら誰かに価値を提供できるものにしたいと思いました。

しかし実際に人に利用してもらえるサービスを提供するとなるとマーケティングや運用保守の要素がかなりに必要になりますし、初学の段階で「誰かに使ってもらうこと」に期待しすぎても学習の挫折要因になりかねないとも考えます。

そのため「自分でこんなのがあったら良いな」を少しずつ実現することを目的のひとつとしました。
具体的には「仲間と情報交換したいなぁ」「カロリー計算とかエクセルでやるの面倒だな」という課題の解消ですね。

前提条件（学習期間）と開発期間は？

プログラミング学習を開始したのが2020年5月末。
仕事をしつつ6月は主にProgateで勉強し、10種類以上のコースを各1周。
HTML&CSS,Python,Java,PHP,SQL,Git,Sass,Rubyあたり。JavaScripとRailsも途中まで。

7月に小さなプログラミングスクールに入校。(コロナの影響でほぼオンライン)
内容は
・PHP/Laravelの3ヶ月コース。
・テキストベースのカリキュラムでHTML、PHP、Laravelを学びつつ課題をこなしていく形。
・開発環境はAWSのCloud9。
・週に1回オンラインで1時間のメンタリング。
という感じ。

8月上旬にはカリキュラムを終了し、
オリジナルアプリの制作に向けて企画/設計やER図作成を開始。
8月中旬から実際の開発作業に着手。
9月末でスクールは退会。
10月にAWSの学習とデプロイ作業。
という流れです。

開発期間としては、働きながら&勉強しながらとはいえ3ヶ月程度費やしていることになりますね。
時間をすべて記録していたわけではないので何とも言えませんが、
まず可処分時間は平均しておおよそ3時間/日程度を確保。
テレビはコンセントを抜いてゲームやYoutube等は撤廃、食事や大好きな読書も最小限にしました。

ITパスや基本情報技術者、AWSや各種技術書などの勉強も行っていたので、その半分の1.5時間をアプリ開発に充てたと考えると3ヶ月でだいたい150時間は費やしていることになります。
(6月からの学習時間や資格勉強などを全てトータルすると450時間ほどのプレイ時間になりますね..）

そしてやはり感じたのは、調べ物やエラーと戦っている時間がほとんどで、
実際にコードを書いてる時間は少ないということですね。。
よく言われることかもしれませんが。

企画/設計はどんな感じで行った？

・アイディア出し、ペルソナ設定
・リーンキャンバスの作成
・エレベータピッチ、ユーザーストーリーマッピング、MVPの設定
・ワイヤーフレームの作成(手書き)
・ER図の作成(手書き)
という手順で行いました。

収益化が主目的ではないのでリーンキャンバスは埋められる範囲で、という感じですね。(KPIなど省略)
今思うとこのフェーズでもう少しアプリケーションのロジックの部分の設計ができていればなぁとも思いますが、「走りながら考える」というのもまた正解でもあるので、何とも言えないですね。

データベース設計(ER図)はどうなってる？

最初に手書きで簡単に作りつつも、開発しながら随時テーブルは更新/拡張していき、
結局はこのような形になりました。

実装してみるとやはりテーブルの関連付けの部分が難しく、キー制約や正規化などDBの奥の深さや面白さを感じました。
そしてどうしてもやっているうちに開発前の構想とは変わっていくので、Migrationファイルがやや散らかってしまいました。。

インフラ構成はどうなってる？？

すべてAWSで構成。主に使用したのはEC2、RDS、ELB、S3、Route53、ACMです。

本来はWebサーバーやDBサーバーは冗長化させて、S3もCloud Frontで..という想いはあるのですが、あくまで学習用。無料枠の中でということで断念しました。
ELBはロードバランサーというよりAmazon Certificate Managerで無料でhttps化(証明書発行)する目的で使用しています。(EC2インスタンスは1つで、ダミーのAZを設定)

またAWSを利用する上でルートユーザーはMFA(多要素認証)でログイン、IAMユーザーに最小限の権限を持たせて作業、アクセスキーは厳重に管理、といったセキュリティ面は留意しました。(少し痛い目にあったので..)

アプリを制作する上で意識したことは？

ひとりチーム開発

まず、実務を想定した「ひとりチーム開発」を意識しました。
スクール等でチームを組んで共同開発..というのがひとつの理想ではありますが、個人開発なので「どうやったら実務でスムーズにキャッチアップできるか？」ということを考え、
　・Git/GitHubによるソース管理
　・作業ごとにissueを作成し、featureブランチを切って作業
　・こまめにコミットし、プルリクエスト。
といった形で開発を進めました。

開発用にGitHubの新規アカウントを作成し、contributionsはこのようになりました。
いわゆる草というやつですね。これからも更新していきます。

もちろん実務ではDockerでの開発環境、CI/CDパイプライン等いろいろと必要な事項があると思いますが「まずはアプリ自体を完成させなければ..」という想いから、このあたりの技術は転職活動〜入社の期間で少しずつ習得していこうと考えています。

わかりやすいコードにする

「後から見た時に分かりやすいコード」を意識しました。
現職(構造設計）でもドキュメントやメモを残すようにしていて、プログラミングにおいても意識してコメントは書いていたのですが、開発途中で書籍「リーダブルコード(O'RELLY社)」を読んで、リファクタリングを意識的に行うようになりました。
書籍の中では「そもそも最小限のコメントで分かるような変数名やロジックにする」というのが一番感銘を受けたポイントですね。。
変数やファイルの命名センスは大事。ロジックもコメントもセンスが大事。
(美しいコードとは？みたいなテーマで飲みながら語らえるようになりたい)

インフラにAWSを使う

少し話が脱線しましたが..
他には「インフラにAWSを使う」というのも実務を意識した点です。
なぜAWSか？ については、
　・教材でherokuにデプロイは経験していた（あとは読み込み遅いとかドメイン名とか)
　・インフラ設計や構築について実際に手を動かして学びたかったから（分かってくるとインフラは楽しい)
　・業務で最も使われているから（AzureやGCPも気になりますが）
です。

苦労した点は？

これはもう、とにかくたくさんあるのですが、、
・エラーや不具合にハマったとき（ほぼ毎日）
・投稿した画像を自動で加工する機能のあれこれ（InterventionImageを使いましたが色々問題発生）
・Ajaxでの計算機能,いいね機能の実装と理解（ControllerとViewとJSの処理のロジックが難しかった..）
・Gitでコンフリクトが生じた時（コミット打ち消しを行ったことなどに起因..）
・AWSの概念理解とデプロイ作業（https化も意外と大変だった..）
・環境構築の問題いろいろ（Composerメモリ足りない→php.iniとswapで対処等）
などなど、多岐にわたります。

開発期間はほとんど独習だったので、
「調べつつメンター契約して即時解決」というほうが良かったかも、、
ただ、苦労はしたけど"勉強が辛い"という感じはしなかったですね。(たぶん学習レベルだからですが)

全体的な感想

まずWebアプリを作ることは楽しいということ。
もちろん大変なことや覚えなければならないことは山ほどありますが、
　・ロジックを考えてそれが実装できたとき
　・エラーやデプロイの問題が解決できたとき
はガッツポーズしてしまうほどの達成感です。
また日々自分が成長していくことにもやりがいを感じますし、
自分と同じ問題で困っている人に教えてあげることにも喜びを感じました。
実際にサービスを提供して誰かの課題を解決できたら最高かもしれないですね。


それと蛇足ですが..
自分の場合プログラミングスクールは通う必要はなかったかなぁと後から思いました。

もちろん「大金を払っているので後戻りできない」とか「カリキュラムが系統的になっている」とか「質問できる環境」というメリットはありますが、、
今はもっと安くて分かりやすい教材や動画もありますし、だいたい何でも調べられるので「独学で充分できるかも..」と後から感じています。

当時にもう少し情報の収集力があれば良かった..けど後からなら何でも言えますね。
googleで検索してもアフィリエイト記事にしかたどり着けないですし。

今後の課題など

・Docker,CI/CDなど、開発環境,テスト,自動デプロイあたりについて学ぶ
・ユーザー登録時にメール認証させたりセキュリティ面もきちんと考える
・PHPを生の言語としてもっと深く学ぶ
・インフラ、ネットワーク、Linuxの基本をしっかり学ぶ
・UI/UXをもう少し意識する

まぁ実際にサービスを運用するとなるとやるべきことはもっとあると思いますが、少しずつ着実に力をつけていきたいなと考えております。


以上、最後までご覧いただきありがとうございました。
「おつかれ」「もっと頑張れよ」と思った方、LGTM！していただけたら今後の励みになります^^;

この記事ではLaravelのフロントエンドをVue+TypeScriptで実装します。
TypeScriptの整形にはESlintを使用します。

使うもの
- Laravel Laravel_Mix
- TypeScript ESlint
- Vue Vue-Router

使わないもの
- TSlint Pretter

環境

• Laravel v7.5
• Node v13
• Vue v2.6

準備

Laravelのプロジェクトを作成
bash
composer create-project --prefer-dist laravel/laravel app


Vueをインストールする
bash
npm i
npm i -D vue vue-router vue-template-compiler
npm i -D typescript ts-loader
npm i -D eslint eslint-plugin-vue @typescript-eslint/eslint-plugin @typescript-eslint/parser


追加・修正するファイル一覧

├---resources
|   ├---ts(追加)
|   |   ├---App.vue
|   |   ├---app.ts
|   |   ├---pages
|   |   |   └---index.vue
|   |   ├---route.ts
|   |   └---vue-shim.d.ts
|   └---views
|       └---index.blade.php(追加)
├---routes
|   └---web.php(修正)
├---.eslintrc.json(追加)
├---tsconfig.json(追加)
└---webpack.mix.js(修正)

ルートとテンプレートを追加修正

routes/web.php
php
Route::get('/{any?}', function () {
return view('index');
})->where('any', '.+');


resources/views/index.blade.php
```html
<!doctype html>

{{ config('app.name') }}

<!-- Scripts -->

<!-- Fonts -->

<!-- Styles -->

概要

• 構成 　
• Elastic BeanstalkでEC2とRDSを立てる
• ドメインと証明書を取得して設定する
• ロードバランサーとセキュリティグループを設定する
• EB Cliを使用する

Elastic BeanstalkでNuxt.jsをデプロイ

AWSコンソール
- Elastic BeanstalkでNode.jsプラットフォームの環境を作成
- [設定] - [ソフトウェア] - [変更]でノードコマンドにnpm run eb-startを入力
- [設定] - [ソフトウェア] - [変更]で環境変数を設定

ローカル環境
- eb initを実行
- /package.json内のscriptsに"eb-start": "npm run build && npm run start",を追加
- npm installで失敗する場合
- /.npmrcファイルを作成してunsafe-perm=trueと入力
- 下記の内容で/.ebextensions/chown.configを作成

commands:
chown:
command: chown -R nodejs:nodejs /tmp/.config
test: cd /tmp/.config

- /Procfileがある場合は/.ebignoreファイルを作成してProcfileをデプロイしないようにする

eb deployでデプロイ

Elastic BeanstalkでLaravelをデプロイ

AWSコンソール
- Elastic BeanstalkでPHPプラットフォームの環境を作成
- [設定] - [ソフトウェア] - [変更]で環境設定でドキュメントルートに/publicを設定
- [設定] - [ソフトウェア] - [変更]で環境変数を設定
- [設定] - [データベース] - [変更] からRDSインスタンスを作成

ローカル環境
- eb init
- 下記の内容で/.ebextensions/permission.configを作成

files:
"/opt/elasticbeanstalk/hooks/appdeploy/post/99_change_permissions.sh":
mode: "000755"
owner: root
group: root
content: |
#!/usr/bin/env bash
sudo chmod -R 777 /var/app/current/storage


eb deployでデプロイ

Route53でドメインを設定

下のページを参考にドメインと証明書を取得
https://qiita.com/sk565/items/2da1fc0c5fc676f54994
現在は東京リージョンでも証明書の発行ができるようだ
https://aws.amazon.com/jp/about-aws/global-infrastructure/regional-product-services/

セキュリティグループを修正

VPCのメニューからElastic Beanstalkで作成されたセキュリティグループを修正
- Nuxt.jsのセキュリティグループのインバウンドルールにHTTPSを追加
- LaravelのセキュリティグループのインバウンドルールにHTTPSとRDSのドライバを追加

ロードバランサーを作成

EC2のメニューからターゲットグループとロードバランサーを作成
- Nuxt.jsのインスタンスに80番ポートで接続するターゲットグループを作成
- Laravelのインスタンスに80番ポートで接続するターゲットグループを作成
- Nuxt.js用のロードバランサーを作成
- Nuxt.jsのセキュリティグループを紐づける
- リスナーの転送先にNuxt.jsのターゲットグループを設定
- Laravel用のロードバランサーを作成
- Laravelのセキュリティグループを紐づける
- リスナーの転送先にLaravelのターゲットグループを設定

ホストゾーンを作成

Route 53のでホストゾーンを作成
- ホストゾーンを作成
- レコードを作成
- ドメインとロードバランサーを設定

(2020-04-27 Laravel7.0対応)

Eloquentの準備

artisan make:model User
artisan make:model User -m # マイグレーション付き

class Flight extends Model
{
    protected $table = 'my_flights'; // 対応するテーブル
    public $timestamps = false; // データ操作時のタイムスタンプ更新
    protected $dateFormat = 'U'; // タイムスタンプのフォーマット
    const CREATED_AT = 'creation_date'; // 作成日時カラム名
    const UPDATED_AT = 'last_update'; // 更新日時カラム名
    protected $connection = 'connection-name'; // コネクション名
    protected $fillable = ['name']; // 複数代入する属性
    protected $guarded = ['price']; // 複数代入しない属性

    use SoftDeletes; // ソフトデリート

    protected static function boot() // グローバルスコープ
    {
        parent::boot();
        static::addGlobalScope('age', function (Builder $builder) {
            $builder->where('age', '>', 200);
        });
    }

    public function scopePopular($query, $type) // ローカルスコープ
    {
        return $query->where('votes', '>', $type);
    }
}

Flight::all(); // 全件取得
Flight::find(1); // 主キーで指定したモデル取得
Flight::where('active', 1)->first(); // 最初の一件を取得
Flight::findOrFail(1); // 見つからない場合ModelNotFoundExceptionを投げる
Flight::where('active', 1)->count(); // 件数
Flight::where('active', 1)->max('price'); // 最大値

$flight->save(); // モデルの保存
Flight::create(['name' => 'Flight 10']); // 新規
Flight::where('active', 1)->update(['delayed' => 1]); // 更新
Flight::firstOrCreate(
    ['name' => 'Flight 10'], ['delayed' => 1]
);
Flight::updateOrCreate(
    ['departure' => 'Oakland', 'destination' => 'San Diego'],
    ['price' => 99]
);
$flight->delete();
Flight::destroy([1, 2, 3]);
$flight->trashed() // ソフトデリートされている場合true
Flight::withTrashed()
    ->where('account_id', 1)
    ->get(); // ソフトデリートされたデータも検索する
$flight->restore(); // ソフトデリートの解除
$flight->forceDelete(); // 強制削除

イベント

リレーション

class User extends Model
{
    protected $touches = ['post']; // userが更新された場合に関連するpostのtimestampを更新

    public function phone() // 1対1
    {
        return $this->hasOne('App\Phone');
    }

    public function comments() // 1対多
    {
        return $this->hasMany('App\Comment');
    }

    public function house() // 逆
    {
        return $this->belongsTo('App\House')->withDefault();
    }

    public function roles() // 多対多
    {
        return $this->belongsToMany('App\Role');
    }

    public function posts() // 仲介モデルを経由しての多対多
    {
        return $this->hasManyThrough('App\Post', 'App\User');
    }
}

$user->roles->first()->pivot->created_at; // 中間テーブル取得
return $this->belongsToMany('App\Role')->withPivot('column1', 'column2'); // 中間テーブルの値を取得
return $this->belongsToMany('App\Role')->withTimestamps(); // 中間テーブルのタイムスタンプを更新
return $this->belongsToMany('App\Role')->wherePivot('approved', 1); // 中間テーブルでフィルタリング

// 挿入・更新
$comment = new Comment(['message' => 'A new comment.']);
$post = Post::find(1);

$post->comments()->save($comment); // ポストに関連するコメントを挿入

$post = Post::find(1);
$comment = $post->comments()->create([
    'message' => 'A new comment.',
]); // ポストに関連するコメントを挿入

$account = Account::find(10);
$user->account()->associate($account);
$user->save(); // ユーザーにアカウントを所属させる

$user->account()->dissociate();
$user->save(); // ユーザーに所属するアカウントのリレーションを削除

$user = User::find(1);
$user->roles()->attach($roleId); // ユーザーに役割を紐づける
$user->roles()->detach($roleId); // ユーザーの役割のリレーションを削除
$user->roles()->sync([1, 2, 3]); // ユーザーに役割を紐づけてそれ以外のリレーションを削除

ポリモーフィック

Collection

$collection = collect([1, 2, 3]); // コレクション生成

$collection->all() // 中身を配列で返す
$collection->get(key, default) // 指定されたキーのアイテムを返す
$collection->random(number) // コレクションからランダムにアイテムを返す
$collection->put(key, value) // 指定したキーと値をコレクションにセット
$collection->prepend(value, key) // アイテムをコレクションの最初に追加
$collection->push(value) // コレクションの最後にアイテムを追加
$collection->concat(items) // 指定した複数アイテムをコレクションの最後に追加
$collection->union(items) // 指定した複数アイテムをコレクションへ追加
$collection->pull(key, default) // キーのアイテムを取得して削除
$collection->splice(offset, length, replacement) // 指定したインデックス以降のアイテムを削除し、削除したアイテムたちを返す
$collection->shift() // 最初のアイテムを取得して削除
$collection->pop() // 最後のアイテムを取得して削除
$collection->forget(keys) // 指定したキーのアイテムを削除
$collection->dump() // ダンプ
$collection->reverse() // コレクションのアイテムを逆順にする
$collection->search(value, strict) // 指定した値のキーを返す、見つからない場合はfalseを返す
$collection->shuffle(seed) // コレクションをシャッフル
$collection->slice(offset, length) // 指定したインデックスからコレクションを切り分ける
$collection->sort(calback) // ソートする
$collection->sortBy(callback, options, descending) // 指定したキーでコレクションをソート
$collection->sortByDesc(callback, options) // 指定したキーでコレクションを逆順でソート
// 値
$collection->count() // コレクションのアイテム数を返す
$collection->max(callback) // 指定したキーの最大値を返す
$collection->min(callback) // 指定したキーの最小値を返す
$collection->average(callback) // 平均値
$collection->median(key) // 指定したキーの中央値を返す
$collection->mode(key) // 指定したキーの最頻値を返す
$collection->sum(callable) // 全アイテムの合計を返す
// 判定
$collection->contains(key, operator, value) // 指定した条件に合うアイテムを持つ場合true
$collection->every(key, operator, value) // 繰り返し処理を行い全アイテムがtrueならtrueを返す
$collection->has(key) // 指定したキーがコレクションに存在する場合true
$collection->isEmpty() // コレクションが空の場合true
$collection->isNotEmpty() // コレクションが空でない場合true
// 変換
$collection->map(callback) // 繰り返しで処理し、コールバックの処理を行った値をコレクションで返す
$collection->mapInto(class) // コレクションを繰り返し処理し、指定したクラスの新しいインスタンスを生成し、コンストラクタへ値を渡す
$collection->unique(key, strict) // 指定したキーが一意なコレクションを返す
$collection->toArray() // 配列に変換
$collection->toJson() // シリアライズ済みのJSON文字を返す
// その他
$collection->chunk(size) // 指定したサイズの小さなコレクションに分割 ビューで横3件づつ表示する場合に便利
$collection->forPage(pageNo, perPage) // perPageごとのpageNoのコレクションを返す
$collection->groupBy(groupBy, preserveKeys) // 指定したキーによりグループ化
$collection->implode(value, glue) // 指定したキーの値を指定した文字列で結合する
$collection->keyBy(keyBy) // 指定したキーをコレクションのキーにする
$collection->keys() // コレクションの全キーを返す
$collection->make(items) // 新しいコレクションインスタンスの生成
$collection->merge(items) // コレクションをマージ 引数の値が優先
$collection->only(keys) // コレクション中の指定したアイテムのみを返す
$collection->pluck(value, key) // 指定したキーの全コレクションの値を返す
$collection->when(value, callback, default) // valueがtrueの場合にcallbackを実行する
$collection->unless(value, callback, default) // valueがfalseの場合にcallbackを実行する
// 繰り返し
$collection->each(callback) // コレクションのアイテムを繰り返し処理
$collection->eachSpread(callback) // コレクションのアイテムを繰り返し処理
$collection->pipe(callback) // コレクションを指定したコールバックに渡し、結果を返す
$collection->reduce(callback, initital) // 繰り返しの結果を次の繰り返しに渡しながら単一値へ変換
$collection->tap(callback) // コレクションに影響を与えることなくコールバックを実行
$collection->transform(callback) // コールバックから返る値のコレクションを返す
// フィルタリング
$collection->first(callback, default) // 指定されたテストをパスしたコレクションの最初のアイテムを返す
$collection->firstWhere(key, operator, value) // 指定した条件の最初のアイテムを返す
$collection->last(callback, default) // 指定したテストをパスしたコレクションの最後の値を返す
$collection->filter(callback) // コールバックでフィルタリングを行いtrueのアイテムのみコレクションで返す
$collection->reject(callback) // コールバックでフィルタリングを行いfalseのアイテムのみコレクションで返す
$collection->partition(key, operator, value) // コールバックの可否で二つのコレクションに分割して返す
$collection->where(key, operator, value) // キー・値を含むコレクションを返す
$collection->whereIn(key, values, strict) // キー・値を含むコレクションを返す
$collection->whereNotIn(key, values, strict) // キー・値を含まないコレクションを返す
$collection->diff(items) // itemsに存在しないアイテムをコレクションで返す
$collection->diffAssoc(items) // itemsのキーは一致するが値が異なるアイテムをコレクションで返す
$collection->diffKeys(items) // itemsに含まれないキーのアイテムをコレクションで返す
$collection->only(keys) // コレクション中の指定したアイテムのみを返す
$collection->except(keys) // 指定したキー以外のアイテムをコレクションで返す

コレクションの拡張(サービスプロバイダ内でマクロを使用してクラスメソッドを追加することが可能)

ミューテタ

APIリソース

APIリソース JSONレスポンスを返すときにJSONのdata要素を整形するクラス
コレクションリソース JSONレスポンスを返すときにJSON自体を整形するクラス
bash
artisan make:resource UserResource
artisan make:resource Users --collection
artisan make:resource UserCollection


class UserResource extends JsonResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'email' => $this->email,
            'created_at' => $this->created_at,
            'updated_at' => $this->updated_at,
        ];
    }
}

return new UserResource(User::find(1)); // 単体
return UserResource::collection(User::all()); // 複数

シリアライズ

(2020-04-24 Laravel7.0対応)

利用開始

DB::connection('foo') // 接続先を指定して接続
DB::connection()->getPdo(); // PDOを返す

DB::select('select * from users where id = :id', ['id' => 1]); // モデル
DB::insert('insert into users (id, name) values (?, ?)', [1, 'Dayle']); // 
DB::update('update users set votes = 100 where name = ?', ['John']); // レコード数を返す
DB::delete('delete from users'); // レコード数を返す
DB::statement('drop table users');

DB::transaction(function () {
    DB::table('users')->update(['votes' => 1]);

    DB::table('posts')->delete();
}); // トランザクション

DB::transaction(function () {
    DB::table('users')->update(['votes' => 1]);

    DB::table('posts')->delete();
}, 5); // デットロック発生時に5回試す

DB::beginTransaction(); // トランザクション開始
DB::rollBack(); // ロールバック
DB::commit(); // コミット

クエリイベントのリッスン
php
class AppServiceProvider extends ServiceProvider
{
public function boot()
{
DB::listen(function ($query) {
// $query->sql
// $query->bindings
// $query->time
});
}


クエリビルダ

DB::table('users')->get(); // 全件取得 Collection<StdClass>
DB::table('users')->where('name', 'John')->first(); // 1件取得
DB::table('users')->where('name', 'John')->value('email'); // カラム指定
DB::table('users')->select('name', 'email as user_email')->get(); // カラム指定
DB::table('roles')->pluck('title'); // カラムを指定してリストで取得
DB::table('users')->count(); // 件数
DB::table('orders')->max('price');
DB::table('orders')->min('price');
DB::table('orders')->avg('price');
DB::table('orders')->sum('price');
DB::table('users')->distinct()->get(); // 重複行をまとめる
DB::table('users')->whereBetween('votes', [1, 100])->get();
DB::table('users')->whereNotBetween('votes', [1, 100])->get();
DB::table('users')->whereIn('id', [1, 2, 3])->get();
DB::table('users')->whereNotIn('id', [1, 2, 3])
->get();
DB::table('users')->whereDate('created_at', '2016-12-31')->get();
DB::table('users')->whereMonth('created_at', '12')->get();
DB::table('users')->whereDay('created_at', '31')->get();
DB::table('users')->whereYear('created_at', '2016')->get();
DB::table('users')->whereTime('created_at', '=', '11:20')->get();
DB::table('users')->whereColumn('first_name', 'last_name')->get();
DB::table('users')->orderBy('name', 'desc')->get();
DB::table('users')->latest()->first(); // created_atで逆順にソート
DB::table('users')->inRandomOrder()->first(); // ランダム順にする
DB::table('users')->groupBy('account_id')->having('account_id', '>', 100)->get();
DB::table('users')->skip(10)->take(5)->get();
DB::table('users')->offset(10)->limit(5)
->get();

DB::table('users')
    ->where('name', '=', 'John')
    ->orWhere(function ($query) {
        $query->where('votes', '>', 100)
              ->where('title', '<>', 'Admin');
    })->get();

DB::table('users')
    ->whereExists(function ($query) {
        $query->select(DB::raw(1))
            ->from('orders')
            ->whereRaw('orders.user_id = users.id');
    })->get();

DB::table('users')
    ->when($role, function ($query) use ($role) {
        return $query->where('role_id', $role);
    })->get(); // $roleがtrueの場合のみクエリに追加する

DB::table('users')
    ->join('contacts', 'users.id', '=', 'contacts.user_id')
    ->select('users.*', 'contacts.phone', 'orders.price')
    ->get(); // INNER JOIN

DB::table('users')
    ->leftJoin('posts', 'users.id', '=', 'posts.user_id')
    ->get(); // LEFT JOIN

DB::table('sizes')
    ->crossJoin('colours')
    ->get(); // CROSS JOIN

DB::table('users')
    ->join('contacts', function ($join) {
        $join->on('users.id', '=', 'contacts.user_id')
             ->where('contacts.user_id', '>', 5);
    })->get(); // 複雑なJOIN

DB::table('users')
    ->select(DB::raw('count(*) as user_count, status'))
    ->selectRaw('price * ? as price_with_tax', [1.0825])
    ->whereRaw('price > IF(state = "TX", ?, 100)', [200])
    ->havingRaw('SUM(price) > 2500')
    ->orderByRaw('updated_at - created_at DESC')
    ->get(); // SQLを直接使用

DB::table('users')->orderBy('id')->chunk(100, function ($users) {
    foreach ($users as $user) {
        //
    }
}); // 結果の分割

DB::table('users')->insert(
    ['email' => 'john@example.com', 'votes' => 0]
);

DB::table('users')->insertOrIgnore([
    ['id' => 1, 'email' => 'taylor@example.com'],
    ['id' => 2, 'email' => 'dayle@example.com']
]); // 重複レコードエラーを無視

$id = DB::table('users')->insertGetId(
    ['email' => 'john@example.com', 'votes' => 0]
); // IDを返す

DB::table('users')
    ->where('id', 1)
    ->update(['votes' => 1]);

DB::table('users')->increment('votes'); // 1増やす
DB::table('users')->increment('votes', 5); // 5増やす
DB::table('users')->decrement('votes'); // 1減らす
DB::table('users')->decrement('votes', 5); // 5減らす

DB::table('users')->where('votes', '>', 100)->delete();
DB::table('users')->truncate();

DB::table('users')->where('votes', '>', 100)->sharedLock()->get(); // 共有ロック
DB::table('users')->where('votes', '>', 100)->lockForUpdate()->get(); // 占有ロック

ページネーション

DB::table('users')->paginate(15);
DB::table('users')->simplePaginate(15); // 前へ次へのみ
$users->withPath('custom/url'); // URI指定

{{ $users->links() }}
{{ $users->appends(['sort' => 'votes'])->links() }}

{{ $results->count() }} // 現在のページのアイテム数
{{ $results->currentPage() }} // 現在のページ数
{{ $results->firstItem() }} // 現在ページの最初のアイテムが何番目か
{{ $results->getOptions() }} // ページネータオプション取得
{{ $results->getUrlRange($start, $end) }} // 一定範囲のページネーションURLを取得
{{ $results->hasPages() }} // 複数ページに分割できるだけのアイテムがあるか判定
{{ $results->hasMorePages() }} // データストレージにまだアイテムが存在しているか判定
{{ $results->items() }} // 現在ページのアイテムを取得
{{ $results->lastItem() }} // 現在ページの最後のアイテムが何番目か
{{ $results->lastPage() }} // 利用可能な最終ページ数取得
{{ $results->nextPageUrl() }} // 次ページのURL取得
{{ $results->onFirstPage()  }} // ペジネータが最初のページを扱っているか判定
{{ $results->perPage() }} // ページごとに表示するアイテム数
{{ $results->previousPageUrl() }} // 前ページのURL取得
{{ $results->total() }} // 総数
{{ $results->url($page) }} // 指定したページのURL取得
{{ $results->getPageName() }} // ページを保存するために使用するクエリ文字変数を取得
{{ $results->setPageName($name) }} // ページを保存するために使用するクエリ文字変数を指定

マイグレーション

artisan make:migration create_users_table --create=users
artisan make:migration add_votes_to_users_table --table=users

artisan migrate
artisan migrate --force // 実働環境での強制マイグレーション
artisan migrate:rollback
artisan migrate:rollback --step=5
artisan migrate:reset
artisan migrate:refresh
artisan migrate:fresh
artisan migrate:fresh --seed

Schema::create('flights', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
    $table->timestamps();
});

Schema::rename($from, $to); // テーブル名変更
Schema::drop('flights'); // テーブル削除

Schema::table('users', function (Blueprint $table) {
    $table->dropColumn('votes');
});
// カラムタイプ
$table->id(); // Alias of $table->bigIncrements('id').
$table->tinyInteger('votes'); // TINYINTカラム
$table->integer('votes'); // INTEGERカラム
$table->bigInteger('votes'); // BIGINTカラム
$table->increments('id'); // 符号なしINTを使用した自動増分ID（主キー）
$table->float('amount', 8, 2); // 有効（全体桁数）／小数点以下桁数指定のFLOATカラム
$table->double('amount', 8, 2); // 有効（全体桁数）／小数点以下桁数指定のDOUBLEカラム

$table->string('name', 100); // オプションの文字長を指定したVARCHARカラム
$table->text('description'); // TEXTカラム
$table->binary('data'); // BLOBカラム
$table->enum('level', ['easy', 'hard']); // ENUMカラム

$table->timestamp('added_on'); // TIMESTAMPカラム
$table->year('birth_year'); // YEARカラム
$table->date('created_at'); // DATEカラム
$table->time('sunrise'); // TIMEカラム
$table->timestampTz('added_on'); // タイムゾーン付きTIMESTAMPカラム

$table->boolean('confirmed'); // BOOLEANカラム
$table->json('options'); // JSONフィールド
$table->jsonb('options'); // JSONBフィールド
$table->ipAddress('visitor'); // IPアドレスカラム
$table->macAddress('device'); // MACアドレスカラム

$table->rememberToken(); // VARCHAR(100)でNULL値可能なremember_tokenを追加
$table->timestamps(0); // NULL値可能なcreated_atとupdated_atカラム追加
$table->softDeletes('deleted_at', 0); // ソフトデリートのためにNULL値可能なdeleted_at TIMESTAMPカラム追加
$table->timestampsTz(0); // タイムゾーン付きのNULL値可能なcreated_atとupdated_atカラム追加
$table->softDeletesTz('deleted_at', 0); // ソフトデリートのためにNULL値可能なdeleted_atタイムゾーン付きTIMESTAMPカラム追加

$table->dropRememberToken(); // remember_tokenカラムのドロップ
$table->dropSoftDeletes(); // deleted_atカラムのドロップ
$table->dropSoftDeletesTz(); // dropSoftDeletes()メソッドの別名
$table->dropTimestamps(); // created_atとupdated_atカラムのドロップ
$table->dropTimestampsTz(); // dropTimestamps()メソッドの別名
// カラム修飾子
->autoIncrement() // 整数カラムを自動増分ID（主キー）へ設定
->default($value) // カラムのデフォルト(default)値設定
->nullable($value = true) // （デフォルトで）NULL値をカラムに挿入する
->useCurrent() // TIMESTAMPカラムのデフォルト値をCURRENT_TIMESTAMPに指定
// インデックス
$table->primary(['id', 'parent_id']);
$table->unique('email');
$table->index(['account_id', 'created_at']);
$table->dropPrimary('users_id_primary');
$table->dropUnique('users_email_unique');
$table->dropIndex('geo_state_index');
// 外部キー制約
$table->foreign('user_id')->references('id')->on('users')->onDelete('cascade');
$table->dropForeign('posts_user_id_foreign'); // テーブル名_カラム名_foreign
Schema::enableForeignKeyConstraints();
Schema::disableForeignKeyConstraints();

シーディング

artisan make:seeder UserSeeder // 作成後 要composer dump-autoload
artisan db:seed
artisan db:seed --class=UserSeeder

Redis

composer require predis/predis

Redis::get('user:profile:'.$id);
Redis::set('name', 'Taylor');
Redis::lrange('names', 5, 10);

Redis::pipeline(function ($pipe) {
    for ($i = 0; $i < 1000; $i++) {
        $pipe->set("key:$i", $i);
    }
});

(2020-04-27 Laravel7.0対応)

Artisanコンソール

Available commands:
  clear-compiled       Remove the compiled class file
  down                 Put the application into maintenance mode
  env                  Display the current framework environment
  inspire              Display an inspiring quote
  migrate              Run the database migrations
  optimize             Cache the framework bootstrap files
  serve                Serve the application on the PHP development server
  test                 Run the application tests
  tinker               Interact with your application
  ui                   Swap the front-end scaffolding for the application
  up                   Bring the application out of maintenance mode
 auth
  auth:clear-resets    Flush expired password reset tokens
 cache
  cache:clear          Flush the application cache
  cache:forget         Remove an item from the cache
  cache:table          Create a migration for the cache database table
 config
  config:cache         Create a cache file for faster configuration loading
  config:clear         Remove the configuration cache file
 db
  db:seed              Seed the database with records
  db:wipe              Drop all tables, views, and types
 key
  key:generate         Set the application key
 make
  make:channel         Create a new channel class
  make:command         Create a new Artisan command
  make:component       Create a new view component class
  make:controller      Create a new controller class
  make:event           Create a new event class
  make:exception       Create a new custom exception class
  make:factory         Create a new model factory
  make:job             Create a new job class
  make:listener        Create a new event listener class
  make:mail            Create a new email class
  make:middleware      Create a new middleware class
  make:migration       Create a new migration file
  make:model           Create a new Eloquent model class
  make:notification    Create a new notification class
  make:observer        Create a new observer class
  make:policy          Create a new policy class
  make:provider        Create a new service provider class
  make:request         Create a new form request class
  make:resource        Create a new resource
  make:rule            Create a new validation rule
  make:seeder          Create a new seeder class
  make:test            Create a new test class
 migrate
  migrate:fresh        Drop all tables and re-run all migrations
  migrate:install      Create the migration repository
  migrate:refresh      Reset and re-run all migrations
  migrate:reset        Rollback all database migrations
  migrate:rollback     Rollback the last database migration
  migrate:status       Show the status of each migration
 notifications
  notifications:table  Create a migration for the notifications table
 optimize
  optimize:clear       Remove the cached bootstrap files
 package
  package:discover     Rebuild the cached package manifest
 route
  route:cache          Create a route cache file for faster route registration
  route:clear          Remove the route cache file
  route:list           List all registered routes
 session
  session:table        Create a migration for the session database table
 storage
  storage:link         Create the symbolic links configured for the application
 view
  view:cache           Compile all of the application's Blade templates
  view:clear           Clear all compiled view files

ブロードキャスト

キャッシュ

cache('key', 'default') // キャッシュ取得 デフォルト値
cache(['key' => 'value'], 5) // 5分間有効なキャッシュを追加
cache(['key' => 'value'], now()->addSeconds(10)) // 10秒後まで有効なキャッシュを追加

Cache::get('key', 'default') // キャッシュ取得 デフォルト値
Cache::get('key', function () {
    return DB::table(...)->get();
})
Cache::pull('key') // キャッシュを取得後削除
Cache::store('file')->get('foo') // 保存先を指定してキャッシュ取得
Cache::has('key') // キャッシュがある場合true
Cache::increment('key'); // キャッシュの整数アイテムの値を1増やす
Cache::increment('key', $amount); // キャッシュの整数アイテムの値を$amountだけ増やす
Cache::decrement('key');
$value = Cache::remember('users', $minutes, function () {
    return DB::table('users')->get();
}); // キャッシュに存在しない場合クロージャが実行され、結果がキャッシュに保存される。
$value = Cache::remember('users', $minutes, function () {
    return DB::table('users')->get();
}); // クロージャの結果が永久に保存される。
Cache::put('key', 'value', $minutes); // キャッシュへアイテム保存
Cache::add('key', 'value', $minutes); // キャッシュに保存されていない場合のみ保存。追加された場合true
Cache::forever('key', 'value'); // アイテムを永遠に保存
Cache::forget('key'); // キャッシュからのアイテム削除
Cache::flush(); // キャッシュ全体を削除

Collection

イベント

ファイルストレージ

• local 非公開 storage/app配下へ保存
• public 一般公開 storage/app/public配下へ保存 bash artisan storage:link # public/storageからstorage/app/publicへシンボリックリンクを張る
• ftp
• sftp
• s3 要league/flysystem-aws-s3-v3パッケージ
• rackspace 要league/flysystem-rackspaceパッケージ

Rackspaceドライバ設定

'rackspace' => [
    'driver'    => 'rackspace',
    'username'  => 'your-username',
    'key'       => 'your-key',
    'container' => 'your-container',
    'endpoint'  => 'https://identity.api.rackspacecloud.com/v2.0/',
    'region'    => 'IAD',
    'url_type'  => 'publicURL',
],

echo asset('storage/file.txt'); <!-- storage/app/public/file.txt -->

Storage::disk('public')->put('file.txt', 'Contents'); // storage/app/public/file.txtへファイルを保存
Storage::disk('local')->put('file.txt', 'Contents'); // storage/app/file.txtへファイルを保存

Storage::get('file.jpg'); // ファイルを取得
Storage::exists('file.jpg'); // ファイルが存在すればtrue
Storage::url('file1.jpg'); // URL
Storage::temporaryUrl('file1.jpg', now()->addMinutes(5)
); // 一時的なURL
Storage::size('file1.jpg'); // ファイルサイズ
Storage::lastModified('file1.jpg'); // 更新日時

Storage::put('file.jpg', $contents); // ファイルを保存
Storage::putFile('photos', new File('/path/to/photo')); // 一意のIDでファイルを保存
Storage::putFileAs('photos', new File('/path/to/photo'), 'photo.jpg'); // ファイル名を指定して保存
Storage::putFile('photos', new File('/path/to/photo'), 'public'); // アクセス権限を指定
Storage::prepend('file.log', 'Prepended Text'); // ファイルの先頭にテキストを保存
Storage::append('file.log', 'Appended Text'); // ファイルの末尾にテキストを保存
Storage::copy('old/file1.jpg', 'new/file1.jpg'); // コピー
Storage::move('old/file1.jpg', 'new/file1.jpg'); // 移動

$request->file('avatar')->store('avatars'); // アップロードファイルをavatarフォルダに一意のファイル名で保存
Storage::putFile('avatars', $request->file('avatar'));
$request->file('avatar')->storeAs('avatars', $request->user()->id
); // ファイル名を指定
Storage::putFileAs('avatars', $request->file('avatar'), $request->user()->id
);
$request->file('avatar')->store('avatars/'.$request->user()->id, 's3'
); // ストレージを指定
Storage::disk('s3')->putFileAs('avatars', $request->file('avatar'), $request->user()->id);
Storage::delete('file.jpg'); // 削除

Storage::put('file.jpg', $contents, 'public'); // public属性で保存
Storage::getVisibility('file.jpg'); // 視認性の取得
Storage::setVisibility('file.jpg', 'public') // 視認性の設定

Storage::files($directory); // ディレクトリの全ファイルを取得
Storage::allFiles($directory); // サブディレクトリのファイルも取得

Storage::directories($directory); // 全ディレクトリを取得
Storage::allDirectories($directory); // サブディレクトリのディレクトリも取得

Storage::makeDirectory($directory); // ディレクトリの作成
Storage::deleteDirectory($directory); // ディレクトリの削除

ヘルパ
php
// 配列とオブジェクト
Arr::add(array, key, value) // 指定されたキーが存在しない場合、配列に追加
Arr::divide(array) // キーの配列と値の配列を返す
Arr::dot(array, prepend) // 多次元配列をドット記法に変換
Arr::get(array, key, default) // ドット記法で指定された値を取得
Arr::pull(array, key, default) // 指定された要素を取得して削除
Arr::set(array, key, value) // 値をセット
Arr::forget(array, keys) // ドット記法で指定されたキーを配列から取り除きます
Arr::has(array, keys) // ドット記法で指定されたアイテムが配列に存在する場合true
Arr::first(array, callback, default) // テストにパスした最初の要素を返す
Arr::last(array, callback, default) // テストをパスした最後の配列要素を返す
Arr::only(array, keys) // 指定されたキーのアイテムを返す
Arr::except(array, keys) // 指定されたキーを配列から削除
Arr::pluck(array, value, key) // 指定キーに対する値を全て取得
Arr::prepend(array, value, key) // 先頭に要素を追加
Arr::random(array, number) // ランダムに取得
Arr::sort(array, callback) // ソート
Arr::sortRecursive(array) // 再帰的にソート
Arr::where(array, callback) // フィルタリング
head(array) // 配列の最初の要素を返す
last(array) // 配列の最後の要素を返す
// パス
app_path(path) // appディレクトリへの完全パスを取得
base_path(path) // プロジェクトルートの完全パスを取得
config_path(path) //configディレクトリの完全パスを取得
database_path(path) // databaseディレクトリの完全パスを取得
mix(path) // バージョンつけしたMixファイルのパスを取得
public_path(path) // publicディレクトリの完全パスを取得
resource_path(path) // resourcesディレクトリの完全パスを取得
storage_path(path) // storageディレクトリの完全パスを取得
// 文字列
__(key, replace, locale) // ローカリゼーションファイルを使用し、翻訳
class_basename(class) // 名前空間を除いたクラス名だけを取得
// URL
asset(path, secure) // 現在のリクエストスキーマを使い、アセットへのURLを生成
secure_asset(path) // HTTPSを使い、アセットへのURLを生成
route(name, parameters, absolute) // 名前付きルートへのURLを生成
secure_url(path, parameters) // 指定したパスへの完全なHTTPSURLを生成
url(path, parameters, secure) // 指定したパスへの完全なURLを生成
// レスポンス
response(content, status, headers) // responseインスタンスを返す
view(view, data, mergeData) // Viewインスタンスを返す
abort(code, message, headers) // HTTP例外を投げる
redirect(to, status, headers, secure) // リダイレクトインスタンスを返す
back(status, headers, fallback) // 直前のローケーションへのリダイレクトレスポンスを生成
abort_if(boolean, code, message, headers) // 指定された論理値がtrueならHTTP例外を投げる
abort_unless(boolean, code, message, headers) // 指定された論理値がfalseならHTTP例外を投げる
// インスタンス
app(abstract, parameters) // サービスコンテナのインスタンスを返す
resolve(name) // サービスコンテナを使い、インスタンス自身を依存解決する
auth(guard) // 認証インスタンスを返す
collect(value) // コレクションインスタンスを生成
cookie(name, value, minutes, path, domain, secure, httpOnly, raw, sameSite) // クッキーインスタンスを生成
factory(class, name, amount) // 指定したクラスのモデルビルダを生成する
policy(class) // ポリシーインスタンスを取得
validator(data, rules, messages, customAttributes) // バリデータインスタンスを生成
// フォーム
csrf_field() // CSRFトークン値を持つHTML入力フィールドを生成
csrf_token() // CSRFトークン値を取得
method_field(method) // patchやdeleteの入力フィールドを生成
old(key, default) // セッションにフラッシュデータとして保存されている直前の入力値を取得
// イベント・キュー
broadcast(event) // 指定したイベントをリスナへブロードキャストする
dispatch(job) // 指定したジョブをLaravelのジョブキューへ投下する
dispatch_now(job, handler) // 指定したジョブを即時実行し、handleメソッドからの値を返す
event(event, payload, halt) // イベントをリスナに発行
// ログ
info(message, context) // ログ出力
logger(message, context) // ログ出力
// 例外
throw_if(condition, exception, paramaters) // 論理式がtrueの場合例外を投げる
throw_unless(condition, exception, paramaters) // 論理式がfalseの場合例外を投げる
rescue(callback, rescure) // 指定されたクロージャを実行し、例外をキャッチする。キャッチはレポートさ
// クロージャ
transform(value, callback, default) // 指定値がblankでない場合にクロージャを実行し結果を返す
retry(times, callback, sleep) // 指定回数コールバックを実行する
tap(value, callback) // valueに対してcallbackを実行してvalueを返す
value(value) // 値を返す
with(value, callback) // クロージャの結果を返す
// 暗号化
bcrypt(value, options) // 値をハッシュ化
encrypt(value, serialize) // 値を暗号化する
decrypt(value, unserialize) // 値を復号する
// 日時
now(tz) // 日時のCarbonインスタンスを返す
today(tz) // 日付のCarbonインスタンスを返す
// その他
cache(key, default) // キャッシュから値を取得
session(key, default) // セッションへ値を設定、取得
env(key, default) // 環境変数を取得、config:cacheを実行後はnullを返すので注意
config(key, default) // 設定変数の値を取得
dd() // 指定された変数の内容を表示し、スクリプトの実行を停止
dump(var) // 指定した変数をダンプ
report(exception) // 例外をレポートする
optional(value) // オブジェクトのプロパティやメソッドを呼び出す。オブジェクトがnullの場合はエラーではなくnullを返す
request(key, default) // リクエストインスタンスを返すか、入力アイテムを取得


メール

• SMTP
• Mailgun
• Postmark
• Amazon SES
• sendmail

composer require guzzlehttp/guzzle # APIドライバの利用に必要

artisan make:mail OrderShipped // Mailableクラス作成
artisan make:mail OrderShipped --markdown=emails.orders.shipped // Markdownテンプレート指定

return $this->from('example@example.com')
    ->view('emails.orders.shipped')
    ->text('emails.orders.shipped_plai')
    ->attach('/path/to/file', [
        'as' => 'name.pdf',
        'mime' => 'application/pdf',
    ])
    ->with([
        'orderName' => $this->order->name,
        'orderPrice' => $this->order->price,
    ]); 

{{ $orderPrice }} <!-- 変数の値を出力 -->
{{ $message->embed($pathToFile) }} <!-- ファイル埋め込み -->
{{ $message->embed($data, $name) }} <!-- ファイル埋め込み -->

bladeコンポーネント
```php
@component('mail::button', ['url' => $url, 'color' => 'green'])
注文の確認
@endcomponent

@component('mail::panel')
ここはパネルの内容です。
@endcomponent

@component('mail::table')
| Laravel | テーブル | 例 |
| ------------- |:-------------:| --------:|
| Col 2 is | 中央寄せ | $10 |
| Col 3 is | 右寄せ | $20 |
@endcomponent

メール送信
php
Mail::to($request->user())
->cc($moreUsers)
->bcc($evenMoreUsers)
->send(new OrderShipped($order));

Mail::to($request->user())
->cc($moreUsers)
->bcc($evenMoreUsers)
->queue(new OrderShipped($order));
```

通知

artisan make:notification InvoicePaid # 通知作成

$user->notify(new InvoicePaid($invoice));
Notification::send($users, new InvoicePaid($invoice));

メール通知
Markdownメール通知
データベース通知
ブロードキャスト通知
SMS通知
Slack通知

パッケージ開発

キュー

タスクスケジュール

(2020-04-24 Laravel7.0対応)

認証

認証後のリダイレクト先や処理をカスタマイズできる。
```php
$user = Auth::user(); // 現在認証されているユーザーの取得
$id = Auth::id(); // 現在認証されているユーザーのID取得
$request->user() // 認証済みユーザーのインスタンスを返す
Auth::check() // 現在のユーザーが認証されている場合true
Auth::attempt(['email' => $email, 'password' => $password]) // 認証を行い、成功した場合true

Route::get(...)->middleware('auth') // ルート定義で使用
$this->middleware('auth') // コントローラのコンストラクタで使用
middleware('auth:api') // ガードを指定

return redirect()->intended('dashboard'); // 認証フィルターにかかる前にアクセスしようとしていたURLへリダイレクトさせる。リダイレクトが不可能な場合は指定されたURIへ

Auth::logout(); // ログアウト

Auth::attempt(['email' => $email, 'password' => $password], $remember) // 継続ログイン

Auth::viaRemember() // remembermeクッキーを使用して認証されている場合true

Auth::login($user) // Userインスタンスによる認証 要Authenticatable契約
Auth::login($user, true) // Userインスタンスによる認証 remembber

Auth::loginUsingId(1)
Auth::loginUsingId(1, true)

Auth::once($credentials)
```

API認証

インストール
bash
composer require laravel/airlock
artisan vendor:publish --provider="Laravel\Airlock\AirlockServiceProvider"
artisan migrate


トークンの発行
```php
class User extends Authenticatable
{
use HasApiTokens;
...

$token = $user->createToken('token-name'); // トークンを発行
return $token->plainTextToken; // 平文を返す

$user->tokens()->delete(); // 全トークンの破棄
$user->tokens()->where('id', $id)->delete(); // 特定トークンの破棄
...
}
```

ルート保護
php
Route::middleware('auth:airlock')->get('/user', function (Request $request) {
return $request->user();
});

php
$response = $client->request('GET', '/api/user', [
'headers' => [
'Accept' => 'application/json',
'Authorization' => 'Bearer '.$accessToken,
],
]);


SPA認証

認可

ゲート
```php
// App\Providers\AuthServiceProvider boot関数内
Gate::define('update-post', function ($user, $post) {
return $user->id == $post->user_id;
});

// コントローラ内でのアクションの認可
Gate::allows('update-post', $post) // 現在のユーザーはこのポストを更新できる場合true
Gate::denies('update-post', $post) // 現在のユーザーはこのポストを更新できない場合true
Gate::forUser($user)->allows('update-post', $post) // 渡されたユーザーはこのポストを更新できる場合true
Gate::forUser($user)->denies('update-post', $post) // 渡されたユーザーはこのポストを更新できない場合true
```

ポリシー作成
bash
artisan make:policy PostPolicy
artisan make:policy PostPolicy --model=Post

ポリシー記述
```php
class PostPolicy
{
public function create(User $user)
{
return $user->role === 'admin';
}

public function update(User $user, Post $post)
{
    return $user->id === $post->user_id;
}

}
```
AuthServiceProvider内でモデルにポリシーを登録

ポリシーフィルター(特定ユーザーには全アクションを許可する)
ポリシー
php
public function before($user, $ability)
{
if ($user->isSuperAdmin()) {
return true;
}
}


アクションの認可
```php
$user->can('update', $post) // 現在のユーザーがポストを更新できる場合true
$user->can('create', Post::class) // モデルを必要としない場合

Route::put('/post/{post}', ...)->middleware('can:update,post'); // ミドルウェアによる認可
Route::put(...)->middleware('can:update,App\Post'); // モデルを必要としないアクション

$this->authorize('update', $post); // コントローラヘルパでの認可
$this->authorize('create', Post::class); // モデルを必要としない場合

Bladeテンプレートでの認可
html
@can('update', $post)
<!-- 現在のユーザーはポストを更新できる -->
@elsecan('create', App\Post::class)
<!-- 現在のユーザーはポストを作成できる -->
@endcan

@cannot('update', $post)
<!-- 現在のユーザーはポストを更新できない -->
@elsecannot('create', App\Post::class)
<!-- 現在のユーザーはポストを作成できない -->
@endcannot

@can('create', App\Post::class)
<!-- 現在のユーザーはポストを更新できる -->
@endcan

@cannot('create', App\Post::class)
<!-- 現在のユーザーはポストを更新できない -->
@endcannot
```

暗号化

artisan key:generate // キー生成

encrypt('secret') // OpenSSLとAES-2560CBCで暗号化
decrypt($encryptedValue) // 復号化
Crypt::encryptString('Hello world.') // シリアライズしないで暗号化
Crypt::decryptString($encrypted) // シリアライズしないで復号化

ハッシュ

Hash::make('password') // ハッシュ化した値を返す
Hash:check('password', $hashedPassword) // 一致したらtrue

(2020-04-24 Laravel7.0対応)

Bladeテンプレート

<html>
    <head>
        <title>アプリ名 - @yield('title')</title>
    </head>
    <body>
        @section('sidebar')
            ここがメインのサイドバー
        @show

        <div class="container">
            @yield('content')
        </div>
    </body>
</html>

@extends('layouts.app')

@section('title', 'Page Title')

@section('sidebar')
    @parent

    <p>ここはメインのサイドバーに追加される</p>
@endsection

@section('content')
    <p>ここが本文のコンテンツ</p>
@endsection

コンポーネントとスロット
bash
artisan make:component Alert

```php
class Alert extends Component
{
public $type;
public $message;

public function __construct($type, $message)
{
    $this->type = $type;
    $this->message = $message;
}

public function render()
{
    return view('components.alert');
}

}

html

{{ $message }}
{{ $slot }}


html



Woops!Something went wrong.


データ表示
html
Hello, {{ $name }}.
Hello, {!! $name !!}. <!-- エスケープしない -->
The current UNIX timestamp is {{ time() }}. <!-- PHP関数 -->
var app = @json($array); <!-- JSONを表示 -->
Hello, @{{ name }}. <!-- JSフレームワークで処理する -->
@verbatim <!-- 囲まれた範囲の波括弧をJSフレームワークで処理する -->

Hello, {{ name }}.

@endverbatim

制御構文
php
@if (count($records) === 1)
@elseif (count($records) > 1)
@else
@endif

@unless (Auth::check())
@endunless

@isset($records)
@endisset

@empty($records)

@endempty

@auth
@endauth

@guest

@endguest

@auth('admin')
@endauth

@guest('admin')
@endguest

@switch($i)
@case(1)
@break
@case(2)
@break
@default
@endswitch

@for ($i = 0; $i < 10; $i++)
現在の値は： {{ $i }}
@endfor

@foreach ($users as $user)

これは {{ $user->id }} ユーザーです。

@endforeach

@while (true)

無限ループ中

@endwhile

@foreach ($users as $user)
@if ($loop->first)
// これは最初の繰り返し
@endif

@if ($loop->last)
    // これは最後の繰り返し
@endif
<p>これは {{ $user->id }} ユーザーです。</p>

@endforeach

@foreach ($users as $user)
@foreach ($user->posts as $post)
@if ($loop->parent->first)
// これは親のループの最初の繰り返しだ
@endif
@endforeach
@endforeach

セクションディレクティブ
php
@hasSection('navigation')

@yield('navigation')

<div class="clearfix"></div>

@endif
```

プロパティ	説明
$loop->index	現在のループのインデックス（初期値0）
$loop->iteration	現在の繰り返し数（初期値1）
$loop->remaining	繰り返しの残り数
$loop->count	繰り返し中の配列の総アイテム数
$loop->first	ループの最初の繰り返しか
$loop->last	ループの最後の繰り返しか
$loop->even	偶数回目の繰り返しか
$loop->odd	奇数回目の繰り返しか
$loop->depth	現在のループのネストレベル
$loop->parent	ループがネストしている場合、親のループ変数

コメント
php
{{-- このコメントはレンダー後のHTMLには現れない --}}

PHP
php
@php
//
@endphp

サブビュー
php
@include('shared.errors', ['some' => 'data'])
@includeIf('view.name', ['some' => 'data'])
@includeWhen($boolean, 'view.name', ['some' => 'data'])
@includeUnless($boolean, 'view.name', ['some' => 'data'])
@includeFirst(['custom.admin', 'admin'], ['some' => 'data'])

コレクションのレンダービュー
php
@each('view.name', $jobs, 'job', 'view.empty')

スタック
php
@push('scripts')
<script src="/example.js"></script>
@endpush


サービス注入
```php
@inject('metrics', 'App\Services\MetricsService')

Monthly Revenue: {{ $metrics->monthlyRevenue() }}.

# スカフォールド
```bash
composer require laravel/ui
artisan ui bootstrap
artisan ui vue
artisan ui react

artisan ui bootstrap --auth
artisan ui vue --auth
artisan ui react -- auth

アセットのコンパイル（Laravel Mix）

npm install
npm run dev
npm run production
npm run watch
npm run watch-poll

mix.js('resources/js/app.js', 'public/js')
    .sass('resources/sass/app.scss', 'public/css')
    .sourceMaps()
    .version()

mix.copy('node_modules/foo/bar.css', 'public/css/bar.css');
mix.copyDirectory('resources/img', 'public/img');

<script src="{{ mix('/js/app.js') }}"></script>
<link rel="stylesheet" href="{{ mix('/css/app.css') }}">

(2020-04-24 Laravel7.0対応)

ルーティング

Route::get('user/{user}', 'UserController@index')->name('user'); // メソッド パラメータ コントローラー 名前
Route::get('user/{user?}', 'UserController@index')->name('user');  // 任意パラメータ
Route::redirect('here', 'there', 301); // リダイレクト ステータスコード指定
Route::view('welcome', 'welcome', ['name' => 'Taylor']); // ビュー 名前

Route::resource('photos', 'PhotoController')->only('index'); // リソースルート
Route::resource('photos', 'PhotoController')->except('index'); // リソースルート
Route::apiResource('photo', 'PhotoController'); // APIリソースルート index store show update destroy

// ルートグループ
Route::namespace('Admin')->group(function () {
    // "App\Http\Controllers\Admin"名前空間下のコントローラ
});
Route::domain('{account}.myapp.com')->group(function () {
    Route::get('user/{id}', function ($account, $id) {
        // URL {account}.myapp.com/user/{id}
    });
});
Route::prefix('admin')->group(function () {
    // URL /admin/*
});

Route::current(); // ルートクラス
Route::currentRouteName(); // ルート名 未定義ならnull
Route::currentRouteAction(); // アクション名 未定義ならnull

ミドルウェア

artisan make:middleware CheckAge

Route::get('/', 'StaticController@index')->middleware('first', 'second');
Route::middleware(['first', 'second'])->group(function () {
    // firstとsecondミドルウェアを使用
}); 

CSRF保護

<form method="POST" action="/profile">
  @csrf <!--<input type="hidden" name="_token" value="7753xoabfc5SK4hv1mJo3NGwC47DLZ2ZbmGoJihX">-->
</form>

<meta name="csrf-token" content="{{ csrf_token() }}">

$.ajaxSetup({
    headers: {
        'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
    }
});

コントローラ

artisan make:controller PhotoController --resource // リソースコントローラ
artisan make:controller PhotoController --resource --model=Photo // モデル指定

return view('user.profile', ['user' => User::findOrFail($id)]);

public function __construct()
{
    $this->middleware('log')->only('index');
    $this->middleware('subscribed')->except('store');

    $this->middleware(function ($request, $next) {
        return $next($request);
    });
}

@method('PUT') <!-- <input type="hidden" name="_method" value="PUT"> -->

HTTPリクエスト

$request->path() // パス ドメイン以降
$request->is('admin/*') // パスと一致するかどうかを返す
$request->url() // クエリ文字列なし
$request->fullUrl() // クエリ文字列付き
$request->method() // メソッド
$request->isMethod('post') // メソッドと一致するかどうか

$request->all() // 全入力を配列として受け取る
$request->input() // queryとformの全入力の配列
$request->input('user.name', 'default') // queryとformから デフォルト値
$request->query() // queryの全入力の配列
$request->query('name', 'Helen') // queryから デフォルト値
$request->name // 動的プロバティ
$request->only(['username', 'password']) // queryとformから 一部取得
$request->except(['credit_card']) // queryとformから 一部取得
$request->has(['name', 'email']) // 指定値がすべて存在する場合 true
$request->filled('name') // 指定値が存在し、かつ空ではない場合 true

$request->flash() // 現在の入力を一時的にセッションに保存
$request->flashOnly(['username', 'email']) // 一部入力をフラッシュデータとしてセッションに保存
$request->flashExcept('password') // 一部入力をフラッシュデータとしてセッションに保存
$request->old('username') // フラッシュデータを取得
old('username') // フラッシュデータを取得

$request->cookie('name') // クッキーを取得

$request->file('photo') // ファイルの取得
$request->hasFile('photo') // ファイルが存在する場合にtrue
$request->file('photo')->isValid() // アップロードに成功している場合にtrue
$request->photo->path() // ファイルパス
$request->photo->extension() // 拡張子
$request->photo->store('images', 's3') // ファイルをストレージに保存
$request->photo->storeAs('images', 'filename.jpg', 's3') // ファイル名を指定してストレージに保存

HTTPレスポンス

return 'Hello World'; // 文字列をHTTPレスポンスに変換
return [1,2,3]; // 配列をJSONレスポンスに変換
return response('Hello World', 200)->header('Content-Type', 'text/plain'); // ヘッダーを付与

return response('Hello World', 200)->cookie($name, $value, $minutes, $path, $domain, $source, $httpOnly); // クッキーを付与
Cookie::queue('name', 'value', $minutes); // クッキーを付与

return redirect('home/dashboard'); // URLへのリダイレクト
return back()->withInput(); // 直前のページへのリダイレクト
return redirect()->route('profile', ['id' => 1]); // 名前付きルートへのリダイレクト パラメータ指定
return redirect()->route('profile', [$user]); // 名前付きルートへのリダイレクト パラメータ指定
return redirect()->action('HomeController@index'); // コントローラアクションへのリダイレクト
return redirect()->away('https://www.google.com'); // 外部サイトへのリダイレクト
return redirect('dashboard')->with('status', 'Profile updated!'); // フラッシュデータを保存してリダイレクト
return redirect()->intended('dashboard'); // 認証フィルターにかかる前にアクセスしようとしていたURLへリダイレクトする。
　　　　　　　　　　　　　　　　　　　　　　　// リダイレクトが不可能な場合は指定されたURLへ

return response()->view('hello', $data, 200); // ビューレスポンス

return response()->json([
    'name' => 'Abigail',
    'state' => 'CA'
]); // JSONレスポンス

ビュー

View::exists('emails.customer') // ビューが存在する場合true
return view()->first(['custom.admin', 'admin'], $data); // 利用可能な最初のViewを返す

全ビュー間のデータ共有
ビューコンポーザ

URL生成

url("/posts/{$post->id}") // http://example.com/posts/1
url()->current(); // クエリ文字列を含んだ現在のURL
url()->full(); // クエリ文字列を含んだ現在のURL
url()->previous(); // 直前のリクエストの完全なURL

route('post.show', ['post' => 1]) // 名前付きルートのURL
route('post.show', ['post' => $post]) // 名前付きルートのURL

action('UserController@profile', ['id' => 1]) // コントローラアクションのURL

URL::defaults(['locale' => $request->user()->locale]); // routeのデフォルト値をミドルウェアで設定

HTTPセッション

config/session.phpでセッションの保存場所を設定可能
- file storage/framewrk/sessionsに保存
- cookie
- database
bash
artisan session:table
artisan migrate

- memcached/redis
要predis/predisパッケージ
- array
リクエスト間で継続しない
通常テストに使用

session('key', 'default') // セッションから値を取得
session(['key' => ''value]) // セッションに値を保存

$request->session()->get('key', 'default') // セッションから値を取得
$request->session()->all() // セッション内の全データを取得
$request->session()->exists('users') // セッション内の指定値があればtrue
$request->session()->has('users') // セッション内の指定値がnullでなければtrue
$request->session()->put('key', 'value') // セッションに値を保存
$request->session()->push('user.teams', 'developers') // セッション内の配列に値を追加
$request->session()->pull('key', 'default') // セッションの値を取得後削除
$request->session()->flash('status', 'Task was successful!') // フラッシュデータを保存
$request->session()->reflash() // フラッシュデータを次のリクエストまで持続させる
$request->session()->keep(['username', 'email']) // 特定のフラッシュデータだけ次のリクエストまで持続させる
$request->session()->forget('key') // セッションからデータを削除
$request->session()->flush() //セッションから全データを削除

$request->session()->regenerate() // セッションIDの再発行

カスタムセッションドライバの追加

バリデーション

コントローラ内でのバリデーション
php
$validatedData = $request->validate([
'title' => 'required|unique:posts',
'body' => 'required',
]);

viewでのエラー取得
※$errors変数はShareErrorsFromSessionミドルウェアによりビューに結合される
html
$errors->any() // エラーがある場合true
$errors->all() // エラーを取得

フォームリクエストバリデーションクラス作成
bash
artisan make:request StoreBlogPost

php
function rules(){...} // バリデーションルールの定義
function withValidator(){...} // フォールリクエスト実行後の処理を追加
function authorize(){...} // フォームリクエストの認可
function messages(){...} // エラーメッセージの定義

名前付きエラー
php
redirect('register')->withErrors($validator, 'login');

html
{{ $errors->login->first('email') }}

バリデーションインスタンス
```php
$validator = Validator::make($request->all(), [
'title' => 'required|unique:posts',
'body' => 'required',
]);

$validator->after(function ($validator) {
if ($this->somethingElseIsInvalid()) {
$validator->errors()->add('field', 'Something is wrong!');
}
});

if ($validator->fails()) {
//
}

$validator->errors()->first('email') // 最初のエラーメッセージ取得
$validator->errors()->get('email') // 指定したフィールドの全エラーメッセージを取得
$validator->errors()->all() // 全フィールドの全エラーメッセージを取得
```
バリデーションルール

ルール	説明
accepted	yes,on,1,true
active_url	dns_get_record()により、有効なURLである
after:日付	指定された日付より後日付の代わりに他のフィールドを指定することも可能
alpha	全部アルファベット文字
alphas_dash	全部アルファベット文字と数字、ダッシュ(-)、下線(_)
alpha_num	全部アルファベット文字と数字
array	配列であること
before:日付	指定された日付より前日付の代わりに他のフィールドを指定することも可能
between:最大値,最小値	最小値から最大値の間文字数、数値、配列サイズ、ファイルサイズが評価される
boolean	true,false,1,0,"1","0"
confirmed	フィールド名+_confirmationのフィールドと同じ
date	日付
date_equals:日付	指定した日付を同じ
date_format:フォーマット	フォーマット定義と一致
different:フィールド	指定されたフィールドと異なる
digits:値	数値で値の桁数
digits_between:最小値,最大値	整数で、桁数が最小値から最大値の間
distinct	配列の場合、フィールドに重複した値がない
email	メールアドレス
exists:DB名.テーブル,カラム	指定されたデータベーステーブルに存在
file	アップロードに成功したファイル
filled	存在する場合に空ではないこと
image	画像(jpg,png,bmp,gif,svg)
in:foo,bar	指定したリストの中の値に含まれている
in_array:フィールド	指定したフィールドの値のどれかであること
integer	整数値であること
json	JSON
max:値	指定された値以下文字数、数値、配列サイズ、ファイルサイズを評価
min:値	指定した値以上文字数、数値、配列サイズ、ファイルサイズを評価
not_in:foo,bar,...	指定された値のリストに含まれない
nullable	nullを許容
numeric	数値
password	認証中のユーザーのパスワードと一致
regex:正規表現	正規表現にマッチ
required	フィールドが存在し、空でないこと
same:フィールド	指定されたフィールドを同じ値であること
size:値	指定された値と同じサイズであること文字数、数値、配列サイズ、ファイルサイズ
string	文字列
unique:テーブル,カラム,除外ID,IDカラム	指定されたデータベーステーブルで一意であること

Rule::exists('staff')->where(function ($query) {
    $query->where('account_id', 1);
}),

カスタムバリデーションルール

(2020/04/24 Laravel 7.0に対応)

ライフサイクル

public/index.php
bootstrap/app.php // インスタンスを取得
app/Http/Kernel.php // bootstrappersの配列を定義
　　　　　　　　　　　// HTTPミドルウェアのリスト定義
　　　　　　　　　　　// サービスプロバイダ(コンポーネントを提供)の読み込み
ルーター
( app/HTTP/Middleware/*.php )
routes/*.php
app/Http/Controllers/*.php
( app/HTTP/Middleware/*.php )

サービスコンテナ

結合
依存関係
コンテナイベント

サービスプロバイダ

ファサード

ファサード	クラス	サービスコンテナ結合
App	Illuminate\Foundation\Application	app
Artisan	Illuminate\Contracts\Console\Kernel	artisan
Auth	Illuminate\Auth\AuthManager	auth
Auth (Instance)	Illuminate\Contracts\Auth\Guard	auth.driver
Blade	Illuminate\View\Compilers\BladeCompiler	blade.compiler
Broadcast	Illuminate\Contracts\Broadcasting\Factory
Broadcast (Instance)	Illuminate\Contracts\Broadcasting\Broadcaster
Bus	Illuminate\Contracts\Bus\Dispatcher
Cache	Illuminate\Cache\CacheManager	cache
Cache (Instance)	Illuminate\Cache\Repository	cache.store
Config	Illuminate\Config\Repository	config
Cookie	Illuminate\Cookie\CookieJar	cookie
Crypt	Illuminate\Encryption\Encrypter	encrypter
DB	Illuminate\Database\DatabaseManager	db
DB (Instance)	Illuminate\Database\Connection	db.connection
Event	Illuminate\Events\Dispatcher	events
File	Illuminate\Filesystem\Filesystem	files
Gate	Illuminate\Contracts\Auth\Access\Gate
Hash	Illuminate\Contracts\Hashing\Hasher	hash
Lang	Illuminate\Translation\Translator	translator
Log	Illuminate\Log\Writer	log
Mail	Illuminate\Mail\Mailer	mailer
Notification	Illuminate\Notifications\ChannelManager
Password	Illuminate\Auth\Passwords\PasswordBrokerManager	auth.password
Password (Instance)	Illuminate\Auth\Passwords\PasswordBroker	auth.password.broker
Queue	Illuminate\Queue\QueueManager	queue
Queue (Instance)	Illuminate\Contracts\Queue\Queue	queue.connection
Queue (Base Class)	Illuminate\Queue\Queue
Redirect	Illuminate\Routing\Redirector	redirect
Redis	Illuminate\Redis\RedisManager	redis
Redis (Instance)	Illuminate\Redis\Connections\Connection	redis.connection
Request	Illuminate\Http\Request	request
Response	Illuminate\Contracts\Routing\ResponseFactory
Response (Instance)	Illuminate\Http\Response
Route	Illuminate\Routing\Router	router
Schema	Illuminate\Database\Schema\Builder
Session	Illuminate\Session\SessionManager	session
Session (Instance)	Illuminate\Session\Store	session.store
Storage	Illuminate\Filesystem\FilesystemManager	filesystem
Storage (Instance)	Illuminate\Contracts\Filesystem\Filesystem	filesystem.disk
URL	Illuminate\Routing\UrlGenerator	url
Validator	Illuminate\Validation\Factory	validator
Validator (Instance)	Illuminate\Validation\Validator
View	Illuminate\View\Factory	view
View (Instance)	Illuminate\View\View

(2020-04-24 Laravel7.0に対応)

設定

artisan config:cache // 設定をキャッシュ env関数が使えなくなる
artisan down --message="Upgrading Database" --retry=60 // メンテナンスモード
artisan up // メンテナンスモード解除

App::environment() // 現在の環境を返す
App::environment('local') // 現在の環境がlocalならtrueを返す
App::environment(['local', 'staging']) // 現在の環境がlocalかstagingならtrueを返す

config('app.timezone', 'default value') // 設定の取得 デフォルト値を設定可能

デプロイ

composer install --optimize-autoloader --no-dev // オートローダー最適化
artisan config:cache // 設定をキャッシュ(env関数が使えなくなる)
artisan route:cache // ルートロードの最適化
artisan view:cache // ビューロードの最適化
artisan route:clear
artisan migrate // DB

Laravel Forge

LaravelでCodeceptionを使用した時の記録

Codeceptionの準備

下のコマンドでインストール

composer require codeception/codeception --dev

下のコマンドでテストに必要なファイルを作成

composer exec codecept bootstrap


seleniumサーバー用意

Acceptionテストに使用するseleniumサーバーを用意する
docker-compose.ymlに下の４行を追加する
yml
selenium:
...
depends_on:
- nginx
links:
- nginx:localhost

サーバー起動

docker-compose up -d selenium


その他の準備

envファイルのコピー

cp .env .env.testing

/tests/functional.suite.yml
yml
actor: FunctionalTester
modules:
enabled:
- Laravel5:
environment_file: .env.testing
- \Helper\Functional

/tests/unit.suite.yml
yml
actor: UnitTester
modules:
enabled:
- Asserts
- Laravel5:
environment_file: .env.testing
- \Helper\Unit

/tests/acceptance.suite.yml
yml
actor: AcceptanceTester
modules:
enabled:
- WebDriver:
url: http://localhost/
browser: chrome
host: selenium
- \Helper\Acceptance


参考

https://codeception.com/for/laravel

VSCodeでLaravelのコードを書く際に便利な拡張機能をメモ
2020-06-22 内容を一部修正

Laravel

Laravel Extension Pack 下の９つの拡張機能をインストールする
　　　　　　　　　　　 インストールしたくない拡張機能がある場合は個別にインストール
- Laravel Blade Snippets Bladeのコードスニペット
- Laravel Snippets Laravelのコードスニペット
- Laravel Artisan コマンドパレットでArtisanコマンドを実行
- Laravel goto view プログラムからテンプレートにジャンプ
- DotENV .envファイルのシンタックスハイライト

• PHP Debug XDebugでのデバッグをサポート

• PHP Intelephense PHPコードの補完　参照の検索　定義への移動

• EditorConfig for VS Code .editorconfigでエディターの設定を共有

• VS Live Share 画面やコードを共有する

PHP

php cs fixer PHPコードの整形
PHP DocBlocker Docブロックの入力をサポート

Git

GitLens git操作

その他

Japanese Language Pack VSCodeの日本語化
VSNotes メモ機能　MarkDown対応