资源路由

优质
小牛编辑
134浏览
2023-12-01

资源路由

支持设置RESTFul请求的资源路由,方式如下:

Route::resource('blog','index/blog');

表示注册了一个名称为blog的资源路由到index模块的Blog控制器,系统会自动注册7个路由规则,如下:

标识请求类型生成路由规则对应操作方法(默认)
indexGETblogindex
createGETblog/createcreate
savePOSTblogsave
readGETblog/:idread
editGETblog/:id/editedit
updatePUTblog/:idupdate
deleteDELETEblog/:iddelete

具体指向的控制器由路由地址决定(例如上面的设置,会对应index模块的blog控制器),你只需要为Blog控制器创建以上对应的操作方法就可以支持下面的URL访问:

http://serverName/blog/
http://serverName/blog/128
http://serverName/blog/28/edit

Blog控制器中的对应方法如下:

<?php
namespace app\index\controller;

class Blog
{
    public function index()
    {
    }

    public function read($id)
    {
    }

    public function edit($id)
    {
    }
}

可以通过命令行快速创建一个资源控制器类(参考后面的控制器章节的资源控制器一节)。

可以改变默认的id参数名,例如:

Route::resource('blog', 'index/blog')
    ->vars(['blog' => 'blog_id']);

控制器的方法定义需要调整如下:

<?php
namespace app\index\controller;

class Blog
{
    public function index()
    {
    }

    public function read($blog_id)
    {
    }

    public function edit($blog_id)
    {
    }
}

也可以在定义资源路由的时候限定执行的方法(标识),例如:

// 只允许index read edit update 四个操作
Route::resource('blog', 'index/blog')
    ->only(['index', 'read', 'edit', 'update']);

// 排除index和delete操作
Route::resource('blog', 'index/blog')
    ->except(['index', 'delete']);

资源路由的标识不可更改,但生成的路由规则和对应操作方法可以修改。

如果需要更改某个资源路由标识的对应操作,可以使用下面方法:

Route::rest('create',['GET', '/add','add']);

设置之后,URL访问变为:

http://serverName/blog/create
变成
http://serverName/blog/add

创建blog页面的对应的操作方法也变成了add。

支持批量更改,如下:

Route::rest([
    'save'   => ['POST', '', 'store'],
    'update' => ['PUT', '/:id', 'save'],
    'delete' => ['DELETE', '/:id', 'destory'],
]);

资源嵌套

支持资源路由的嵌套,例如:

Route::resource('blog.comment','index/comment');

就可以访问如下地址:

http://serverName/blog/128/comment/32
http://serverName/blog/128/comment/32/edit

生成的路由规则分别是:

blog/:blog_id/comment/:id
blog/:blog_id/comment/:id/edit

Comment控制器对应的操作方法如下:

<?php

namespace app\index\controller;

class Comment
{
    public function edit($id, $blog_id)
    {
    }
}

edit方法中的参数顺序可以随意,但参数名称必须满足定义要求。

如果需要改变其中的变量名,可以使用:

// 更改嵌套资源路由的blog资源的资源变量名为blogId
Route::resource('blog.comment', 'index/comment')
    ->vars(['blog' => 'blogId']);

Comment控制器对应的操作方法改变为:

<?php
namespace app\index\controller;

class Comment
{
    public function edit($id, $blogId)
    {
    }
}