路由闭包

绝不 在路由配置文件里书写「闭包路由」或者其它业务逻辑代码,因为一旦使用将无法使用 路由缓存

路由器要保持干净整洁,绝不 放置除路由配置以外的其它程序逻辑。

Restful 路由

必须 优先使用 Restful 路由,配合资源控制器使用,见 文档

file

超出 Restful 路由的,应该 模仿上图的方式来定义路由。

正确使用 resource 方法

一般资源路由定义:

Route::resource('photos', 'PhotoController');

等同于定义以下路由:

Route::get('/photos', 'PhotoController@index')->name('photos.index');
Route::get('/photos/create', 'PhotoController@create')->name('photos.create');
Route::post('/photos', 'PhotoController@store')->name('photos.store');
Route::get('/photos/{photo}', 'PhotoController@show')->name('photos.show');
Route::get('/photos/{photo}/edit', 'PhotoController@edit')->name('photos.edit');
Route::put('/photos/{photo}', 'PhotoController@update')->name('photos.update');
Route::delete('/photos/{photo}', 'PhotoController@destroy')->name('photos.destroy');

使用 resource 方法时,如果仅使用到部分路由,必须 使用 only 列出所有可用路由:

Route::resource('photos', 'PhotoController', ['only' => ['index', 'show']]);

绝不 使用 except,因为 only 相当于白名单,相比于 except 更加直观。路由使用白名单有利于养成「安全习惯」。

单数 or 复数?

资源路由路由 URI 必须 使用复数形式,如:

  • /photos/create
  • /photos/{photo}

错误的例子如:

  • /photo/create
  • /photo/{photo}

路由模型绑定

在允许使用路由 模型绑定 的地方 必须 使用。

模型绑定代码 必须 放置于 app/Providers/RouteServiceProvider.php 文件的 boot 方法中:

    public function boot()
    {
        Route::bind('user_name', function ($value) {
            return User::where('name', $value)->first();
        });

        Route::bind('photo', function ($value) {
            return Photo::find($value);
        });

        parent::boot();
    }

路由参数全局限制

出于安全考虑,应该 使用路由参数全局限制,详见 文档

必须RouteServiceProvider 文件的 boot 方法里定义模式:

/**
 * 定义路由模型绑定,模式过滤器等
 *
 * @param  \Illuminate\Routing\Router  $router
 * @return void
 */
public function boot(Router $router)
{
    $router->pattern('id', '[0-9]+');

    parent::boot($router);
}

模式一旦被定义,便会自动应用到所有使用该参数名称的路由上:

Route::get('users/{id}', 'UserController@show');
Route::get('photos/{id}', 'PhotoController@show');

只有在 id 为数字时,才会路由到控制器方法中,否则 404 错误。

路由命名

除了 resource 资源路由以外,其他所有路由都 必须 使用 name 方法进行命名。

必须 使用「资源前缀」作为命名规范,如下的 users.follow,资源前缀的值是 users.

Route::post('users/{id}/follow', 'UserController@follow')->name('users.follow');

命名路由使用带点的蛇形命名法,正确的例子:

Route::get('users/{user}/show-active', 'UserController@showActive')->name('users.show_active');

错误的写法:

Route::get('users/{user}/show-active', 'UserController@showActive')->name('users.show-active');

获取 URL

获取 URL 必须 遵循以下优先级:

  1. $model->link()
  2. route 方法
  3. url 方法

在 Model 中创建 link() 方法:

public function link($params = [])
{
    $params = array_merge([$this], $params);
    return route('models.show', $params);
}

所有单个模型数据链接使用:

$model->link();

// 或者添加参数
$model->link($params = ['source' => 'list'])

「单个模型 URI」经常会发生变化,这样做将会让程序更加灵活。

除了「单个模型 URI」,其他路由 必须 使用 route 来获取 URL:

$url = route('profile', ['id' => 1]);

当无法使用 route 时,可以 使用 url 方法来获取 URL:

url('profile', [1]);