LLaravel Bootcamp

Day 2ディレクトリ構造、artisan、マイグレーションの思想

Artisanコマンドとコード生成の意義

Artisanが何をするツールかを理解し、手作業でなくコマンドで生成することの意義(規約の強制)を説明できるようにする。

Artisanは開発を助ける「相棒コマンド」

は、Laravelに付属するコマンドラインツールです。ターミナルで「php artisan ○○」と打つことで、ファイルの雛形生成、DBの更新、キャッシュのクリアなど、開発中の定型作業をコマンド一発で実行できます。手作業で行う代わりに、決まった手順を確実に自動で行ってくれる相棒だと考えてください。

ターミナル
# 使えるコマンドの一覧を見る
php artisan list

# Controllerの雛形を生成
php artisan make:controller PostController

# Modelとマイグレーションをまとめて生成
php artisan make:model Post -m

# マイグレーションを実行してDBに反映
php artisan migrate
make系は生成、migrateは実行。よく使うものから覚えていけばよい。

生成されるコードは規約通りの雛形

「php artisan make:controller PostController」を実行すると、正しいフォルダ(app/Http/Controllers)に、正しい名前空間(namespace)を持つ雛形が自動で作られます。人が手で作ると、置き場所を間違えたり、名前空間の記述をミスしたりしますが、Artisanなら規約通りのものが確実に生成されます。

PHP
<?php
// php artisan make:controller PostController で自動生成される雛形
namespace App\Http\Controllers;

use Illuminate\Http\Request;

class PostController extends Controller
{
    // ここに処理を書き足していく
}
namespaceも継承元も規約通り。開発者は中身を書き足すことに集中できる。

なぜ手作業でなくArtisanで生成するのか

コマンドで生成する本質的な意義は「規約の強制」です。手作業だと、置き場所・命名・名前空間・継承元などを人が毎回正しく書く必要があり、必ずどこかでミスや揺れが生じます。Artisanで生成すれば、これらが常に規約通りになり、コードベース全体の一貫性が保たれます。人為的なミスを構造的に排除できるのが最大の価値です。

悪い例: 手作業でファイルを作る

エディタで空ファイルを作り、namespaceを手打ちする。置き場所や綴りを間違えるとクラスが読み込まれず、原因の分かりにくいエラーになる。

良い例: Artisanで生成する

make:controllerで生成すれば、置き場所も名前空間も継承元も規約通りに揃う。開発者は業務ロジックの実装だけに集中できる。

補足: 自分専用のコマンドも作れる

Artisanは、データの一括処理や定期バッチなど、自分のアプリ専用のコマンドを作ることもできます(make:command)。運用作業をコマンド化しておくと、手順書に頼らず誰でも同じ操作を再現できます。

面接ではこう言う

「Artisanはコード生成やマイグレーション実行を行う付属のCLIツールです。手作業ではなくコマンドで生成する意義は、置き場所や命名などの規約を強制でき、人為的なミスを構造的に防いでコードベースの一貫性を保てる点にあると考えています」と、単なる時短でなく規約遵守の観点で答えると評価されます。

読んでも腑に落ちない所は、AIに噛み砕いてもらいましょう。

理解度チェック

答えられれば、面接で説明できる状態に一歩近づきます。

Q1

「Controllerを手作業で作らず、artisan make:controller で生成すべき」最大の理由はどれか。

Q2

Artisanとは何か、そしてコマンドでコードを生成することの意義を説明してください。

記述式です。まず自分の言葉で答えを考えてから、模範解答を開いて自己採点してください。