困ったときと、次に読むページ

アプリを作っていると、エラーは必ず出ます。エラーは「どこがおかしいか」を教えてくれる手がかりです。こわがらずに読めば、たいてい直せます。このページでは、エラーの読み方と調べ方、そしてメモ帳アプリの次に何を学ぶとよいかをまとめます。

エラーの画面の読み方#

.env の APP_DEBUG が true のあいだは、エラーが起きると、くわしい原因の画面が出ます。

• いちばん上の大きな文字：エラーの種類（InvalidArgumentException など）
• その下の文：何がおかしいかの説明（ここをいちばんよく読む）
• その下のコード：エラーが起きた場所。問題の行が色付きで目立つようになっている

まず説明の文を読み、次に色の付いた行の、自分で書いたファイル（routes/web.php や app/Http/Controllers/…）を見ます。vendor/ の中のファイルは Laravel 本体なので、ふつうは自分のファイルのほうに原因があります。

よく出るエラーと直し方#

ログを見る#

エラーは、画面だけでなくログ（記録のファイル）にも書かれます。場所は storage/logs/laravel.log です。composer run dev を動かしているターミナルにも、logs の行としてログが流れます。

自分でログに書くこともできます。たとえばコントローラーの中で、次のように書きます。

use Illuminate\Support\Facades\Log;

Log::info('メモを保存します', ['title' => $request->input('title')]);

くわしくはログにまとめています。

中身をのぞく（dump と dd）#

「この変数に、いま何が入っているのか」を知りたいときは、dump() か dd() を使います。

public function index()
{
    $memos = Memo::latest()->get();

    dump($memos->count()); // 画面に中身を出して、そのまま続ける
    dd($memos);            // 画面に中身を出して、そこで止める

    return view('memos.index', ['memos' => $memos]);
}

• dump() は、中身を画面に出して、そのまま処理を続けます
• dd() は、中身を画面に出して、そこで処理を止めます

調べ終わったら、消すのを忘れないようにしましょう。

次に読むページ#

メモ帳アプリで使ったことは、どれも入口の部分だけです。次は、作ったものに近いところから広げていくのがおすすめです。

言葉の意味が分からなくなったら用語集を、書き方をさっと思い出したいときはチートシートを開いてください。