引言

在我们连接了数据库，并且使用迁移功能创建了数据库表结构，
使用Seeder为数据库初步填充了一些伪数据。有了这些准备工作，我们可以考虑做一个资源接口功能，
对外提供数据支持了。

代码时间

有没有感觉自己设计的API接口和数据跟别的大厂提供的文档数据结构不太一样，
看上去不是那么专业，或者说不是那么标准？我们和大厂还差几个年级？

laravel提供了简单的标准方式，可以让我们遵循最佳实践写出专业的url。
比如对于资源，使用restful风格声明一下的url路由地址：

第一列是http请求方法，第二列是laravel内声明的路由规则，第三列是对应的控制器方法。上面的资源列表，涵盖了增删改查的所有动作，可以说很全面了。

如何快捷地生成上述控制器方法呢？使用laravel脚手架指令，在命令行运行：

php artisan make:controller EventsController --resource

我们使用 --resource 选项，会在目标控制器内生成上述的所有方法。

生成的文件位于 app/Http/Controllers/EventsController.php 内，初始化的内容如下：

这些方法真的是开箱即用啊。

那么，我们还要手动一条一条地声明上面的那些路由条目吗？那真是噩梦啊。还好，laravel帮我们做好了，只用Route类的 resource 方法注册资源就可以了：

Route::resource('events', 'EventsController');

使用资源路由方法，只用指定路由名称，和对应的控制器方法，就可以不用繁琐地写那些路由，和控制器方法了。

为方便展示，我们把数据渲染到视图文件，首先创建 resources/views/events/index.blade.php 视图文件，使用默认的布局文件，填充以下代码：

@extends('layouts.app')
@section('content')
	<h1>Events</h1>
@endsection

打开 app/Http/Controllers/EventsController 文件并修改 index 方法：

public function index()
{
	return view('events.index');
}

大家看到了，上述方法内是没有数据库数据交互的，我们下面引入模型，并渲染到视图内。在控制器顶部添加如下引用：

use App\Event;

在index方法内填充以下代码：

$events = Event::all();
return view('events.index')->with('events', $events);

有了以上的数据，在视图内简单地遍历输出内容，修改视图文件如下：

<h1>Events</h1>
<ul>
    @forelse ($events as $event)
    	<li>{{ $event->name }}</li>
    @empty
    	<li>No events found!</li>
    @endforelse
</ul>

模板文件内@forelse 方法会判断是否 $events 变量至少有一个元素可供遍历，如果没有就输出 @empty区块的内容。在浏览器内访问路由地址，输出内容大致如下图。因为使用的Faker填充的伪数据，所以看上去是这样的：

如果数据量太大，这一页估计要加载很久，列表很长。所以需要分页了。加入分页功能，使用的SQL语句大概是这样的：

select id, name from events order by id asc limit 10 offset 0;
select id, name from events order by id asc limit 10 offset 10;

控制器内使用分页功能，简单对模型调用paginate方法即可：

$events = Events::paginate(10);

每页设置为10条。我们在视图内，要有一个前一页，后一页，以及页码的导航条，也不用我们手动写了。laravel竟然继承到了paginate方法所返回的 Illuminate\Pagination\LengthAwarePaginator 类内，只用在视图内添加这样一行就够了：

{!! $events->links() !!}

生成的导航条如下：

写在最后

本文介绍了laravel自身继承的资源型url的快捷注册方法和使用方法。通过之前讲过的从路由到控制器，以及视图渲染的方法，引入了分页的概念，以及如何生成人性化的导航条。

Happy coding