LumenでrestAPIを実装する際のルーテイングについて

Question

環境

PHP 7.1.9
Lumen 5.5

参考にしたURL

https://lumen.laravel.com/docs/5.4/routing#optional-parameters
上記の「Optional Parameters」の欄を見て以下のルーティングを実装

やりたいこと

PHPフレームワークのLumenを使用してRestAPIを実装したいと考えております。
以下のようなルーティングを実装したいのですが方法がよくわかりません。

group_idに紐づくmember_idを取得するAPI

// routes/web.php
$router->get(‘group/{group_id}/{member_id}’, ‘GroupInfo@reference');

実行URL例：http://127.0.0.1/group/1/2
(上記のURLだとgroup_id=1 AND member_id=2の情報を取得する)

group_idに紐づくmember_idが1：1の場合、上記のURLで問題ないのですが、
「group_idに紐づく特定のmember_idを複数取得したい」という場合にルーティングの実現ができません。
group_idは固定で、member_idを任意の数指定できるようにしたいです。
例えば

$router->get(‘group/{group_id}[/{member_id}[/{member_id_2}[/{member_id_3}・・・]]]’, ‘GroupInfo@reference');

という風に実装すれば特定件数までは取得できるようになります。
URL例：http://127.0.0.1/group/1/2/3/4/5/6
(group_id=1 AND member_id IN(2,3,4,5,6)の情報を取得する)

ただこのルーティング方法はよくないだろうなと思っています。
他に良い実装方法ご存知でしたらお伺いしたいです。

おそれ入りますがよろしくお願いいたします。

Answer 1

基本的にはLulucom様の回答に同意です。
そのうえで具体例を

ルーティング

//EndoPointは複数形が推奨されているのでgroupsとするのが適切かと思います。
$router->get('groups/{group_id}/members', 'GroupInfo@reference');

上記のエンドポイントに対して
group_id＝1の中のmember_id=1,2を取得する問合せは

groups/1/members?id[]=1&id[]=2

となり、reference関数で$requestを引数にとって

//GroupInfoClassへ参照を追加
use Illuminate\Http\Request;

public function reference(Request $request,$group_id)
{
    //おそらくこれで取得できるはず・・・
    $queried_ids=$request->input('id[]');
    
    //その後の処理
}

とすればおそらく$queried_idsの中にパラメーターとして渡されたidの配列が代入されるかと思います。

参考サイト
連想配列や配列をクエリする。

Comments

[momosan]

返信遅れてすみません、、ありがとうございます！
エンドポイントは複数形が望ましいんですね。
知らない視点でアドバイスいただけました。まだ方針迷っていたので参考にさせていただきますmm

Answer 2

あくまで1つの案なのですが

$router->get(‘group/{group_id}/members’, ‘GroupInfo@reference');

のようにして、クエリーパラメータで複数の member_id を渡すのはいかがでしょうか。