Laravel显示任务清单

通过使用Laravel显示一个在数据库中的任务清单来初步学习Laravel的基本使用，学习过程主要参考了Laravel官方手册以及JefferyWay的视频教程。

数据库设置

注意要配置.env文件以及config/database.php文件。可以通过使用命令php artisan migrate --pretend来预运行命令，如果没有报错，说明数据库配置没有问题。

通过php artisan migrate来建立数据库，可以使用php artisan migrate:rollback来回滚操作，使操作回到前一个版本，再次运行php artisan migrate来建立当前数据库，Laravel中自带了users和password_resets两个migrate模型。

传递参数到视图

在视图文件resource/view/welcome.blade.php中添加一个参数：

<?php echo $name; ?>

为了将$name参数传递给welcome视图文件，在routes.php中有以下方式可以传递参数:

//基本的数组传递方式
Route::get('/', function () {
    return view('welcome',[
    	'name' => 'world'
    ]);
});

//使用with函数传递
Route::get('/', function () {
    return view('welcome')->with('name','world');
});

//使用compact函数将变量转化为数组
Route::get('/', function () {
	$name = 'world';
    return view('welcome', compact('name'));
});

传递一个数组文件到视图后，使用blade模版语句来显示数组数据，顺便说一句，blade语句与Jekyll中的Liquid模版语句非常相似。

//routes.php
Route::get('/', function () {
	$tasks = [
		'Go to the store',
		'Finish my screencast',
		'Clean the house'
	];

    return view('welcome', compact('tasks'));
});

//welcome.blade.php
@foreach ($tasks as $task)
	{{ $task }}
@endforeach

更多传递参数到视图的资料请参考Laravel视图——数据。

查询构建器

首先可以通过artisan命令来建立一个tasks migration模型:

//create选项默认添加id、时间戳等字段到up函数中
php artisan make:migration create_tasks_table --create=tasks

如果执行语句的时候出现错误“include(…):failed to open stream: No such file or directory”。可以输入composer dump-autoload命令解决，这一部分的内容可以参考composer文档——打印自动加载索引dump-autoload。然后设置Tasks的所有字段：

Schema::create('tasks', function (Blueprint $table) {
    $table->increments('id');
    $table->text('body');
    $table->timestamps();
});

在里面添加了text类型的‘body’字段，然后执行php artisan migrate可以将新建的表添加到数据库。如果添加完毕之后发现需要再添加/删除/修改字段，可以在上面的代码中修改字段，然后执行php artisan migrate:refresh，这句命令代表重新执行所有的migrate模型。

接下来添加一些数据到数据库中：

Insert Into tasks Value(null,'Go to the store',now(),now());
Insert Into tasks Value(null,'Finish screencast',now(),now());
Insert Into tasks Value(null,'Clean the house',now(),now());

现在把之前的tasks数组替换成数据库中的文件：

//routes.php
Route::get('/', function () {
	$tasks = DB::table('tasks')->get();

	return view('welcome', compact('tasks'));
});

//welcome.blade.php
@foreach ($tasks as $task)
	{{ $task->body }}
@endforeach

和之前的效果一样，但是数据从数组转换成了数据库数据。还可以通过一些查询构建函数来构建需要的结果，而不需要编写数据库语句：

//逆序返回数据
$tasks = DB::table('tasks')->latest()->get();

上面的代码实现了索引task数据，更多关于查询构造器的资料请参考Laravel数据库——查询构造器。下面通过给路由添加参数来显示指定的数据，首先添加一个路由：

Route::get('/tasks/{task}', function ($id) {
	$task = DB::table('tasks')->find($id);
   	return view('tasks.show', compact('task'));
});

在路由中使用find函数来查找数据，最后将数据传递给相应的视图，这里添加了一个视图，在Laravel中可以使用.来表示路径，上面的视图文件应该添加在resource/view/tasks/show.blade.php中：

<!DOCTYPE html>
<html>
<head>
	<title></title>
</head>
<body>
	{{ $task->body }}
</body>
</html>

现在访问localhost/tasks/1就可以看到第一条数据了，同理，也可以访问其他数据；如果数据不存在的话，Laravel会报错。现在可以把/目录下的视图文件中的$task->body加上a标签使之链接到相应的数据之中：

<!DOCTYPE html>
<html>
<head>
    <title></title>
</head>
<body>
	
    @foreach ($tasks as $task)
        <li>
            <a href="/tasks/{{ $task->id }}">
            {{ $task->body }}
            </a>
        </li>
    @endforeach
    
</body>
</html>

Eloquent ORM

Eloquent是一个对象映射模型，它能够将数据库中的数据映射成对象(在MVC模式中，把这种对象叫做Model)，并且可以将数据表之间的关系一同映射到对象之中，参考文档：Laravel——Eloquent入门。

首先使用artisan命令来创建一个Model，php artisan make:model Task，然后可以在app/目录下找到Task.php文件。这意味着已经将数据映射到了对象之中，现在修改routes.php关于从数据库中直接读取数据的代码，尝试从Model中读取对象：

Route::get('/', function () {
    // $tasks = DB::table('tasks')->latest()->get();
    $tasks = App\Task::all();

    return view('welcome', compact('tasks'));
});

Route::get('/tasks/{task}', function ($id) {
    // $task = DB::table('task')->find($id);
    $task = App\Task::find($id);

    return view('tasks.show', compact('task'));
});

与之前的运行结果完全相同。

前面通过先建立数据库，再建立Model来把数据映射到对象之中，也可以同时建立。首先通过reset命令除掉所有的migrate：php artisan migrate:reset，然后从文件中删除app/Task.php以及database/migrations/xxx-create_tasks_table.php文件，这样就删除了关于Task的所有数据及对象。现在重新生成Migrate和Model，使用命令php artisan make:model Task -m，这样就同时创建了model与migrate。记得在migrate中添加body字段，再次执行php artisan migrate，更新数据库。

不过之前被添加的数据也被删除了，使用Tinker工具来重建数据。Tinker是一个PHP REPL，是PHP版本的一个交互式命令行界面，很多其它语言都有。在Tinker中，可以直接输入一些PHP表达式，然后Enter之后，它会直接输出结果；使用命令php artisan tinker来打开它，Laravel中自带了Tinker工具。

>>> $task = new App\Task;
=> App\Task {#646}
>>> $task->body = 'Go to the market';
=> "Go to the market"
>>> $task->save();
=> true

上面的>>>行是我的输入，=>行是系统输出；通过上面的命令创建了第一条数据，然后将之前的数据重新创建；我们还可以使用Tinker来执行许多命令，如查找id大于2的Task对象：

>>> App\Task::where('id','>',2)->get();
=> Illuminate\Database\Eloquent\Collection {#661
     all: [
       App\Task {#662
         id: 3,
         body: "Clean the house",
         isComplete: 0,
         created_at: "2017-12-06 01:51:38",
         updated_at: "2017-12-06 01:51:38",
       },
     ],
   }

一切想尝试的东西都可以在Tinker中执行，Tinker在Laravel中的Github项目。

控制器

前面的代码中，都是在路由中直接添加了funcion闭包来完成一些功能，实际上这些function都可以通过控制器来实现：

Route::get('/', 'TasksController@index');
Route::get('/tasks/{task}', 'TasksController@show');

现在路由将会把目录/中的get请求传递给TasksController控制器中的index方法。使用命令php artisan make:controller TasksController来创建TasksController，在目录app\Http\Controller\中可以找到相应的TasksController.php文件；然后添加index方法：

use App\Task;
public function index()
{
    $tasks = Task::all();
    return view('welcome', compact('tasks'));
}

public function show($id){
    $tasks = Task::find($id);
    return view('tasks.show', compact('tasks'));
}

路由模型绑定

注意到上面将路由'tasks/{task}的参数传递到show函数中，在浏览器输入地址localhost/tasks/1的时候，将id传递给了task变量，所以可以在函数中获得id参数，然后通过id查找到相应的Task Model。路由模型绑定能够直接将id参数绑定为Task Model，这样就无需通过id来查找得到Task Model了。在app\Provider\RouteServiceProvider.php的boot方法中添加绑定：

public function boot(Router $router)
{
    parent::boot($router);
    $router->model('task','App\Task');
}

然后更改show函数，直接传入一个Task类型的参数：

public function show(Task $task){
    return $task;
}

可以看到浏览器将Task Model输出为Json数组，已经成功的完成路由模型绑定，可以参考Laravel路由——路由模型绑定。

参考目录

本文仅仅实现了Task的显示功能，在Laravel的官方网站中，有两套教程分别指导如何构建一个完整的任务清单，可以实现删除、添加、索引等功能，具体可参考