Laravel Route::controllerのかわり

Question

初心者の質問で申し訳ありません。
Laravelでfuelやzendのようにrestfulにルーティングさせる方法として
web.phpに以下の一文
Route::controller('hoge/', 'App\Controllers\hogeController');

コントローラ側

namespace App\Controllers;
class hogeController extends BaseController
{
    // getでhoge/にアクセスされた場合
    public function getIndex()
    {
        〜
    }

    // getでhoge/harehareにアクセスされた場合
    public function getHarehare()
    {
        〜
    }

    // getでhoge/detailにアクセスされた場合
    public function getDetail()
    {
        〜
    }

    // postでhoge/editにアクセスされた場合
    public function getEdit()
    {
        〜
    }

}

のようなルーティングにしたいのですが、
Route::controller のルーティングはLaravel 5.2 で非推奨、Laravel5.3 で削除されたようです。
fuelやzendのように自由にコントローラーにアクションを追加したいのですが
laravelではどのように同じことが実現できるのでしょうか？

できれば

Route::get('/hoge', 'hogeController @index');
Route::get('/hoge/goodmorning', 'hogeController @harehare');

のようにはしたくないのですが・・・

Comments

[m.ts10806]

ひとまずコードはマークダウンのcode機能を利用してご提示ください（質問は編集できます）

[m.ts10806]

ちなみに現在利用されているLaravelのバージョンは5.xいくつでしょうか？環境情報として追記してください。

[ms5025]

Laravel Framework 5.5.45になります

[m.ts10806]

(２回目ですが)コードはマークダウンのcode機能を利用してご提示ください（質問は編集できます）

[ms5025]

大したソースじゃないんでこのままでもいいかとおもったんですが
編集しました。

[m.ts10806]

それは質問者さんだけの観点です。
読みやすさのためには例え一行でも必要です。

[kazto]

「Route::get('/hoge', 'hogeController@index');」のような記載をしたくない理由は何でしょうか。

[ms5025]

>kaztoさん
hogeController以下のアクションメソッドはコントローラに自由に追加していけば
web.phpに以下アクションをわざわざ記述しなくていいというのが開発上便利だと思ったのですが、
あまり推奨されないやり方だったようですね。
fuelもzendもその辺自由度が高かった為、laravelでも当然同じような記述ができると思っていた次第です。

Answer 1

Route::getで全部書くだけ。

そもそもなんで削除されたかというと
Route::controllerを見ただけではどんなルートが定義されてるか分からない。
コントローラーまで見に行く必要がある。
Route::controllerが便利そうに見えるのは最初に作る時だけで後から見た時に困る。
先人の経験の上で削除したほうがいいと結論出されたものに初心者の感覚でこっちがいいと言っても意味がない。

それとこれだと一つのコントローラーにどんどんメソッドを増やしてファットコントローラーになりやすい。

Laravel的にベストで個人的にも勧めてるのは「リソースコントローラー以外はシングルアクションコントローラーで作る」
https://readouble.com/laravel/5.7/ja/controllers.html#single-action-controllers

Route::namespace('Hoge')->prefix('hoge')->group(function () {
    Route::get('/', 'IndexController')->name('hoge.index');
    Route::get('detail', 'DetailController')->name('hoge.detail');
});

web.phpを見ればルート定義が分かり、各コントローラーも大きくならない。

Comments

[ms5025]

なるほど！そうなんですね。
fuelでもznedでも今までのプロジェクトは
ルートだけ定義して、あとはコントローラにアクションを追記していく方法でした。

確かにRoute::controllerを見ただけではどんなルートが定義されてるか分からないですね。
＞先人の経験の上で削除したほうがいいと結論出されたものに初心者の感覚でこっちがいいと言っても意味がない
こっちがいいと言ってるわけではなくて、laravelでも当然できるものだと思っていて、
どうすればいいのか質問しただけです。

ただ
>一つのコントローラーにどんどんメソッドを増やしてファットコントローラー
個人的にはコントローラーはデスパッチするだけに留めるものだと思っているので
必要なルート以外は増えないイメージでいました。
処理の主要部分はモデルや処理クラスに出されているので、
コントローラーを見ればどういうルートが存在し、どういう流れなのか即座に理解できる程度の
薄いもののイメージがあったため、この一文は私はちょっとよくわかりません。

リンク先も参考にさせていただきます。
質問してよかったです。

[ms5025]

シングルアクションコントローラーで作るということはしたことがなかったのですが
とても参考になりました。
フレームワークはfuelとzendしか知らなくて、今までそういったコントローラーの作りをしてるプロジェクトしかなかったので、とても参考になりました。

けど、ルートごとにコントローラーがバンバン増えていくのは
逆に管理しにくくはないのでしょうか・・。（ファイルむっちゃ増えるみたいな）

Answer 2

あまりいいやり方ではないかもしれませんが、任意パラメータをうまく使えばある程度汎用的にはなるかなと。

ルーティング：

Route::get('/hoge/{action?}', 'HogeController@action');

コントローラー：

class HogeController extends Controller
{
    public function action(String $action_name = "index",Request $request)
    {
        if(method_exists($this,$action_name)){
            $this->$action_name($request);
        }
    }

    private function index(Request $request)
    {
        echo "index";
    }
    private function test(Request $request)
    {
        echo "test";
    }
}

ルーティングに1個1個書きたくない・・というのでしたら
configに配列で定義してループでまわすというのもありです。

Comments

[m.ts10806]

ただkawaxさんの内容に大賛成ですね。
ファットコントローラーになってしまうとそれこそ醜いので。

[ms5025]

ファットコントローラーって私の中ではモデルとは別に処理クラスを作らず
コントローラー内に処理をポンポン記述してしまう事なのかと思っていました。
（モデルがテーブルと密接になっているプロジェクトにありがち）
ルートが増える＝ファットというイメージがなかったです。

けどリソースコントローラー以外はシングルアクションコントローラーで作るというのが
トレンドだと知らなかったので、勉強になりました。

[m.ts10806]

ファットについては、kawaxさんの通り。いずれにしても不用意にメソッド作ったり共通化せずにゴリゴリ書いたり、外だしできるのに中に書いたりすることですね。
ルートは必要であればそのぶん書くべきなのは言うまでもありませんし、私の回答のように任意パラメータに頼りすぎてはルートを見ただけではどのようなページや機能があるか把握できなくなります。
ルートは言わば玄関から部屋に続く道のようなものなので。
あとLaravelは疎結合がかなり進んでたはずなのでModelが必須ではありませんし、より自由な記述が可能と言う点では若干学習コストは高いかもしれませんね。
「Web職人のためのフレームワーク」というテーマなので、エンジニアとしての技量や経験、発想がより効率的でフレームワークの機能を活かす形になりそうです。

[ms5025]

私はコントローラー＝デスパッチ　のイメージでいたので
（それこそ玄関から部屋に続く道ということです）
複数アクションがあったとてファットになりえないという認識でした。

laravelのフレームワークを使用して作られたソースをたくさん見たい気持ちです。
ありがとうございます。

[m.ts10806]

私が実務で使ったことがあるのは4系のころだったのでまだ5は勉強中です。
Github探るとあがってるものもあるかもしれませんね。
ブログでLaravel専門に扱っているところを見るのもありです。
ララ帳、ふたりはララベル とか。
更新頻度がわりかし高いのはララジャパン とかですね。

Answer 3

php artisan make:controller HogeController --resourceのコマンドでResource用のコントローラーが作成できます。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HogeController extends Controller
{
    public function index() {}
    public function create() {}
    public function store(Request $request) {}
    public function show($id) {}
    public function edit($id) {}
    public function update(Request $request, $id) {}
    public function destroy($id) {}
}

web.phpにRoute::resource('hoges', 'HogeController');を追加したら、上記のコントローラーのメソッドが下記のテーブルにあるURIにマッピングされます。

HTTP Verb	URI	コントローラーでのメソッド名	ルート名
GET	/hoges	index	hoges.index
GET	/hoges/create	create	hoges.create
POST	/hoges	store	hoges.store
GET	/hoges/{hoge}	show	hoges.show
GET	/hoges/{hoge}/edit	edit	hoges.edit
PUT/PATCH	/hoges/{hoge}	update	hoges.update
DELETE	/hoges/{hoge}	destroy	hoges.destroy

リソースの下に、リソースを作ることも可能です。
web.phpにRoute::resource('hoges.hares', 'HareController');。

すべてのメソッドを使わない場合は、ルートに指定することも可能です。

Route::resource('hoge', 'HogeController', ['only' => ['index', 'show']]); // indexとshowのみ
Route::resource('hoge', 'HogeController', ['except' => ['destroy']]); // destroy以外

このパターンと離れた設定は一つずつ指定した方が良さそうかもしれません。

Comments

[ms5025]

すいません、私がこれを理解できなくて…。この一覧は拝見したのですが
アクションメソッドが最初から決まってしまうということなんでしょうか？
例えば
hoge/harehare
というルートを追加したい場合どのように実際コードに落とし込めばいいのでしょうか？
fuelとzendでは
public function action_harehare()
ないしは
public function harehareAction()

のようにアクションメソッドをコントローラーに追記して対応するviewを用意すれば動きました。
laravelの場合はどのようにすればいいのでしょうか？

[Bremenkanp]

最初から決まってしまいます。リソースコントローラーは必ず7つのアクションがあるので、これ以上に追加したい場合は、その下に新しいリソースを作ることがおすすめです。

`Route::resource('hoges.hares', 'HareController');` < それぞれのHogeにHareのリソースが作られるように。ネストされてること以外、ほぼすべてが上記のテーブルと一緒になります。

デフォルトパターンと違うふうに進むと、ルート一つずつ指定した方が一番わかりやすいかもしれません。

[ms5025]

ありがとうございます。参考になりました。
fuel、zendとどちらも似たようなイメージだったので
laravelも似たような事ができるかとおもっていました。
質問してよかったです。ありがとうございます。

Answer 4

ルーティングの使い方はこちらに書かれていますよ。
https://readouble.com/laravel/5.7/ja/routing.html

Comments

[ms5025]

すいません、見たうえでの質問でした。