Laravelのコントローラの基礎

1 はじめに
2 ルーティング
3 バリデーション
- 3.1 コントローラでバリデーション
- 3.2 フォームリクエストでバリデーション
4 さいごに
5 おすすめ書籍

はじめに

今回の記事では、PHPのフレームワークであるLaravelのルーティングやコントローラに関する基礎知識を紹介します。Laravelの基礎知識に関してはこちらをご覧ください。

ルーティング

Laravelのルートティングは、routesディレクトの web.php と api.php に定義します。

ルーティングの定義方法は3種類あり、1つ目はクラス名とメソッド名を記述する方法です。以下の例では、 /home 宛のリクエストを HomeController の index メソッドで処理します。

Route::get('/home', 'HomeController@index');

1	Route::get('/home', 'HomeController@index');

2つ目はクラス名のみを指定する方法です。メソッド名を省略した場合は __invoke メソッドで処理します。

Route::get('/home', 'HomeController@index');

1	Route::get('/home', 'HomeController@index');

3つ目はクロージャで記述する方法です。

Route::get('/home', function () {
    return 'Hello World';
});

Route::get('/home', function () {

return 'Hello World';

});

使用可能なメソッド

Laravelで使用できるメソッドは下記のとおりです。

Route::get($uri, $callback);
Route::post($uri, $callback);
Route::put($uri, $callback);
Route::patch($uri, $callback);
Route::delete($uri, $callback);
Route::options($uri, $callback);

Route::get($uri, $callback);

Route::post($uri, $callback);

Route::put($uri, $callback);

Route::patch($uri, $callback);

Route::delete($uri, $callback);

Route::options($uri, $callback);

以下のように複数のメソッドに対応したルートを定義することもできます。

Route::match(['get', 'post'], '/home', function () {
    return 'Hello, World'
});

Route::match(['get', 'post'], '/home', function () {

return 'Hello, World'

});

また、Route::any を使うとすべてのメソッドに対応したルートを定義することができます。

Route::any('/home', function () {
    return 'Hello World'
});

Route::any('/home', function () {

return 'Hello World'

});

リダイレクト

他のURIにリダイレクトさせたい場合は Route::redirect を使います。

Route::redirect('/before', '/after', 301);

1	Route::redirect('/before', '/after', 301);

Viewの返却

コントローラ側で処理せずに特定のビューを返却すればよい場合は、 Route::view を使います。第2引数にはビュー名を渡します。ビューへデータを渡したい場合は第3引数に配列の形で渡します。

Route::view('/top', 'top', ['title' => 'Top']);

1	Route::view('/top', 'top', ['title' => 'Top']);

ルートパラメータ

CRUDの画面などのように、ルート中のURIセグメントを取得したい場合は以下のようにします。

Route::get('post/{id}', function ($id) {
    return 'Post ID = '.$id;
});

Route::get('post/{id}', function ($id) {

return 'Post ID = '.$id;

});

パラメータ名の後に ? をつけるとパラメータを省略することができます。この場合は、デフォルト値を設定する必要があります。

Route::get('post/{id?}', function ($id = 1) {
    return 'Post ID = '.$id;
});

Route::get('post/{id?}', function ($id = 1) {

return 'Post ID = '.$id;

});

ミドルウェア

ルートグループ内のすべてのルートにミドルウェアを指定するには Route::middleware メソッドを使用します。このとき、ミドルウェアは定義された順番で実行されます。

Route::middleware(['mid1', 'mid2'])->group(function () {
    Route::get('/home', 'HomeController@index');
    Route::get('/home{id}', 'HomeController@show');
});

Route::middleware(['mid1', 'mid2'])->group(function () {

Route::get('/home', 'HomeController@index');

Route::get('/home{id}', 'HomeController@show');

});

プレフィックス

ルートグループ内のすべてのルートに特定のプレフィックスを指定するには Route::prefix メソッドを使用します。

Route::prefix('admin')->group(function () {
    Route::get('users', 'UsersController@index');
    Route::get('users/{id}', 'UsersController@show');
});

Route::prefix('admin')->group(function () {

Route::get('users', 'UsersController@index');

Route::get('users/{id}', 'UsersController@show');

});

バリデーション

Laravelではコントローラ側でバリデーションを行います。バリデーションの方法は2種類あり、1つ目はコントローラに直接記述する方法で、2つ目はフォームリクエスに記述する方法です。

コントローラでバリデーション

コントローラでバリデーションする場合は以下のようになります。バリデーションに失敗した場合は例外が投げられます。

public function store(Request $request)
{
    $validatedData = $request->validate([
        'name'  => 'required|max:32',
        'email' => 'required|unique|max:255',
    ]);

    // バリデーション通過後の処理
}

public function store(Request $request)

{

$validatedData = $request->validate([

'name' => 'required|max:32',

'email' => 'required|unique|max:255',

]);

// バリデーション通過後の処理

}

バリデーション失敗時に特定の処理をしたい場合は、以下のようにします。

public function store(Request $request)
{
    $validator = Validator::make($request->all(), [
        'name'  => 'required|max:32',
        'email' => 'required|unique|max:255',
    ]);

    if ($validator->fails()) {
        // バリデーション失敗時の処理
    }

    // バリデーション通過後の処理
}

public function store(Request $request)

{

$validator = Validator::make($request->all(), [

'name' => 'required|max:32',

'email' => 'required|unique|max:255',

]);

if ($validator->fails()) {

// バリデーション失敗時の処理

}

// バリデーション通過後の処理

}

フォームリクエストでバリデーション

フォームリクエストは以下のコマンドで作成できます。

$ php artisan make:request UserPost

1	$ php artisan make:request UserPost

フォームリクエストでバリデーションする場合は以下のようになります。

public function rules()
{
    return [
        'name'  => 'required|max:32',
        'email' => 'required|unique|max:255',
    ];
}

public function rules()

{

return [

'name' => 'required|max:32',

'email' => 'required|unique|max:255',

];

}

また、エラーメッセージのカスタマイズは以下のようにします。

public function messages()
{
    return [
        'name.required'  => '名前は必須です',
        'email.required' => 'メールアドレスは必須です',
    ];
}

public function messages()

{

return [

'name.required' => '名前は必須です',

'email.required' => 'メールアドレスは必須です',

];

}

さいごに

Laravelのルート定義とバリデーションの書き方を紹介しました。

日	月	火	水	木	金	土
					1	2
3	4	5	6	7	8	9
10	11	12	13	14	15	16
17	18	19	20	21	22	23
24	25	26	27	28	29	30
31

Laravelのコントローラの基礎

はじめに

ルーティング

使用可能なメソッド

リダイレクト

Viewの返却

ルートパラメータ

ミドルウェア

プレフィックス

バリデーション

コントローラでバリデーション

フォームリクエストでバリデーション

さいごに

おすすめ書籍

フォロー

アプリ情報