Eloquent提供了一个易于阅读且很形象化的表和表之间的关系对应和调用,比如说,一条评论是属于一个帖子的,一个帖子拥有很多的评论,一篇帖子和一个视频页同时拥有很多标签,下面我们来看看如何创建这些关系。
我们就以一篇帖子有很多的评论来举列,帖子和评论是一对多的关系,我们上一节已经建立了帖子的表posts
, 下面我们来建立评论表comments
和评论的ModelComment
, 在上一节我们是通过下面两条命令来建立migration文件和Model的
// 建立帖子的migration文件
php artisan make:migration create_posts_table --create=posts
// 建立帖子Model
php artisan make:model Post
我们在建立评论表和模型的时候,用另一种方法,我们在建立Model的时候,只要加上-m
参数,就能在建立Model的时候,同时生成migration文件了。(执行php artisan命令都是需要进入到项目的根目录下执行的,以后我就不说这点了)
➜ php artisan make:model Comment -m
Model created successfully.
Created Migration: 2016_11_14_125930_create_comments_table
从上面我们可以看出,我们创建模型的时候,laravel也帮我们生成了表名为模型名复数的migration文件,我们打开这个migration文件,并更改up()函数如下:
public function up()
{
Schema::create('comments', function (Blueprint $table) {
$table->increments('id');
$table->integer('post_id')->unsigned()->index();
$table->text('content');
$table->timestamps();
});
}
上面的post_id
是posts表的外键,在正式开发的时候,我们需要做到外键约束,同时做到删除的及联操作,这里我们先不添加了。我们将这个表执行到数据库中
➜ php artisan migrate
Migrated: 2016_11_14_125930_create_comments_table
现在在我们的app
目录下,我们已经有了Post.php和Comment.php两个模型,下面我们打开tinker
➜ php artisan tinker
Psy Shell v0.7.2 (PHP 7.0.12 — cli) by Justin Hileman
>>>
以下的代码都在tinker
中执行生成,我们先来获取第一条帖子数据:
>>> $post = App\Post::first();
=> App\Post {#636
id: "1",
title: "My New Post Title",
content: "new post content",
created_at: "2016-11-14 07:22:32",
updated_at: "2016-11-14 07:22:32",
}
我们再来创建属于帖子1的一条评论,我们这次创建先手动的来维护外键(post_id):
>>> $comment = new App\Comment;
=> App\Comment {#625}
>>> $comment->content = 'Some comment for the post';
=> "Some comment for the post"
>>> $comment->post_id = 1;
=> 1
>>> $comment->save();
=> true
>>> App\Comment::all();
=> Illuminate\Database\Eloquent\Collection {#640
all: [
App\Comment {#641
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
},
],
}
>>>
下面我们来通过Eloquent在各模型间建立表与表之间的对应关系,首先我们先理一下,一个帖子会有很多评论,A post has many comments
, 一个评论属于一个帖子:a comment that belongs to a post
,我们打开Post.php,编写一个comments()
函数,意思是一个帖子有很多评论,所以注意这个comments()
一定要写成复数形式,写代码单词的单复数对于易读性来说非常的重要。
<?php
namespace App;
use Illuminate\Database\Eloquent\Model;
class Post extends Model
{
public function comments()
{
return $this->hasMany('App\Comment');
}
}
好的,我们再进入到tinker
中来测试下:
我们先拿到第一个帖子:
>>> $post = App\Post::first();
=> App\Post {#636
id: "1",
title: "My New Post Title",
content: "new post content",
created_at: "2016-11-14 07:22:32",
updated_at: "2016-11-14 07:22:32",
}
我们拿取这个帖子的所有评论,我们可以这么写$post->comments()->get()
,也可以这么写$post->comments;
, 后面这种写法,laravel文档叫它动态属性。
>>> $post->comments;
=> Illuminate\Database\Eloquent\Collection {#633
all: [
App\Comment {#637
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
},
],
}
用上面的方法拿出的数据其实是Comment对象的一个集合(Collection),我们可以像操作数组一样的操作这个集合,如:
>>> $post->comments[0];
=> App\Comment {#637
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
}
当然,开发的时候很少像上面这么做,因为Laravel给我们提供了很多关于操作这个集合的方法,比如说,取集合中的第一个对象:
>>> $post->comments->first();
=> App\Comment {#637
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
}
这里有一个非常重要的地方,我们来尝试下面这条语句:
>>> $post->comments()->first();
=> App\Comment {#651
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
}
我们看到$post->comments->first();
和$post->comments()->first();
这两条语句输出的结果是一样的,但是具体的操作却不同,我们假设帖子1有500条评论,那么$post->comments->first();
会先通过$post->comments
从数据库拿到这500条评论的数据放进集合,然后再从集合中获取第一条数据。而$post->comments()->first();
呢,当执行到$post->comments()
时,它并没有拿出这500条数据,这里还处于一个查询的阶段,等到执行first()
时,从数据库只拿出一条数据,我们应该使用哪种写法,大家应该就很明白了。曾有人说不要用ORM,太慢,但是很多慢的原因不在于ORM, 而是不了解它,没用好而已。
我们再看看这两条语句执行的原生SQL语句,我们在tinker
中让每次执行语句的时候都打印出原生的SQL,可以这么做:
➜ php artisan tinker
Psy Shell v0.7.2 (PHP 7.0.12 — cli) by Justin Hileman
>>> DB::listen(function ($query) { var_dump($query->sql); });
=> null
我们再来拿第一个帖子:
>>> $post = App\Post::first();
string(29) "select * from "posts" limit 1"
=> App\Post {#637
id: "1",
title: "My New Post Title",
content: "new post content",
created_at: "2016-11-14 07:22:32",
updated_at: "2016-11-14 07:22:32",
}
>>>
拿帖子的所有评论,自己看下sql语句:
>>> $post->comments;
string(92) "select * from "comments" where "comments"."post_id" = ? and "comments"."post_id" is not null"
=> Illuminate\Database\Eloquent\Collection {#623
all: [
App\Comment {#638
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
},
我们再来执行一次$post->comments;
>>> $post->comments;
=> Illuminate\Database\Eloquent\Collection {#623
all: [
App\Comment {#638
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
},
],
}
我们发现这次没有出现SQL语句,那是因为laravel已经缓存了这次查询的结果,我们再来看下$post
的结果,它也被缓存了,并且我们查询的$post->comments
的内容也被插入到这个对象中。
>>> $post
=> App\Post {#637
id: "1",
title: "My New Post Title",
content: "new post content",
created_at: "2016-11-14 07:22:32",
updated_at: "2016-11-14 07:22:32",
comments: Illuminate\Database\Eloquent\Collection {#623
all: [
App\Comment {#638
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
},
],
},
}
如果我们刷新获取下$post
,在打印$post
, 大家在看下结果:
>>> $post = $post->fresh();
string(44) "select * from "posts" where "id" = ? limit 1"
=> App\Post {#643
id: "1",
title: "My New Post Title",
content: "new post content",
created_at: "2016-11-14 07:22:32",
updated_at: "2016-11-14 07:22:32",
}
>>> $post
=> App\Post {#643
id: "1",
title: "My New Post Title",
content: "new post content",
created_at: "2016-11-14 07:22:32",
updated_at: "2016-11-14 07:22:32",
}
因为laravel会缓存查询,所以大家在测试的时候一定要加上fresh()
才能准确,我们来看$post->comments->first()
,执行的时候要加上fresh()
,这非常的重要,千万不要做了错误的测试误导了你。
>>> $post->fresh()->comments->first();
string(44) "select * from "posts" where "id" = ? limit 1"
string(92) "select * from "comments" where "comments"."post_id" = ? and "comments"."post_id" is not null"
=> App\Comment {#630
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
}
看上面的第二条SQL语句,它是查询出数据库的所有的评论。
我们在来看$post->comments()->first()
这条语句:
>>> $post->fresh()->comments()->first();
string(44) "select * from "posts" where "id" = ? limit 1"
string(100) "select * from "comments" where "comments"."post_id" = ? and "comments"."post_id" is not null limit 1"
=> App\Comment {#644
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
}
我们看第2条SQL语句,用这种写法,只会从数据库拿出1条记录,这里我说这么多,是因为我看见很多人在滥用动态属性,所以我们一定要注意这点。
好了,我们现在看看在Comment模型中如何写对应的关系呢?拿出之前我们写的英文句子:a comment that belongs to a post
, 我们打开Comment.php,
<?php
namespace App;
use Illuminate\Database\Eloquent\Model;
class Comment extends Model
{
// 注意这里post应该是单数形式
public function post()
{
return $this->belongsTo('App\Post');
// 如果你使用的是PhpStrom编辑器,你也可以按下面这么写,这样点击可以跳转到对应的类文件中
// return $this->belongsTo(Post::class);
}
}
我们重新打开tinker
, 当你修改了代码后,要重新打开tinker
再测试,否则tinker
执行的还是修改前的代码:
>>> $comment = App\Comment::first();
=> App\Comment {#636
id: "1",
post_id: "1",
content: "Some comment for the post",
created_at: "2016-11-15 01:07:53",
updated_at: "2016-11-15 01:07:53",
}
>>> $comment->post;
=> App\Post {#637
id: "1",
title: "My New Post Title",
content: "new post content",
created_at: "2016-11-14 07:22:32",
updated_at: "2016-11-14 07:22:32",
}
>>>
下面我们来看下,我们创建一条评论的时候,如何让Eloquent的关联关系给我们自动维护外键:
我们先创建一个$comment对象,设置它的内容:
>>> $comment = new App\Comment;
=> App\Comment {#622}
>>> $comment->content = 'Here is another comment.';
=> "Here is another comment."
>>>
现在我们不用手动去设置post_id
,我们直接找到评论需要属于的post,比如,还是打算让这条评论属于第一个帖子:
>>> $post = App\Post::first();
=> App\Post {#639
id: "1",
title: "My New Post Title",
content: "new post content",
created_at: "2016-11-14 07:22:32",
updated_at: "2016-11-14 07:22:32",
}
下面我们只需要通过Post的Comments()关联去存储属于它的评论即可,会自动设置$post对象的ID到对应的评论的post_id
>>> $post->comments()->save($comment);
=> App\Comment {#622
content: "Here is another comment.",
post_id: 1,
updated_at: "2016-11-15 02:38:01",
created_at: "2016-11-15 02:38:01",
id: 2,
}
现在通过$post->comments;
查看下,发现已经存在两条评论了。
好了,上面的代码都是在tinker
中测试的,我们现在进入了PostsController中,修改下show()
函数:
public function show(Post $post)
{
return view('posts.show', compact('post'));
}
然后建立show.blade.php视图层,输入以下代码:
@extends('layout')
@section('content')
<h1>{{ $post->title }}</h1>
<ul>
@foreach ($post->comments as $comment)
<li>{{ $comment->content }}</li>
@endforeach
</ul>
@stop
好,我们访问下: http://localhost:8000/posts/1
我们刚才是用save()
方法来存储一条评论,现在我们来试试使用create()
方法来创建呢! 还是打开tinker
嗯, 出现了匹配异常错位,这是Laravel对使用create()
和update()
这两个函数做的保护机制,我们知道create()
和update()
可以批量的设置表字段,如果不做一些保护错位的话,可能会被人通过设置某些字段的值来串改你的数据,所以在Laravel中,你允许批量创建和修改的字段,你都要自己在模型中明确指定,我们打开Comment.php
, 为Comment模型添加$fillbale属性:
<?php
namespace App;
use Illuminate\Database\Eloquent\Model;
class Comment extends Model
{
// 允许使用create()和update()批量创建和更新的字段
protected $fillable = ['content'];
public function post()
{
return $this->belongsTo(Post::class);
}
}
下面重新启动tinker
,在执行一次,就能成功创建了
Psy Shell v0.7.2 (PHP 7.0.12 — cli) by Justin Hileman
>>> $post = App\Post::first();
=> App\Post {#636
id: "1",
title: "My New Post Title",
content: "new post content",
created_at: "2016-11-14 07:22:32",
updated_at: "2016-11-14 07:22:32",
}
>>> $post->comments()->create(['content' => 'Yet another comment about this post']);
=> App\Comment {#640
content: "Yet another comment about this post",
post_id: 1,
updated_at: "2016-11-15 03:08:25",
created_at: "2016-11-15 03:08:25",
id: 3,
}
>>>
我们在进入到posts/index.balde.php
中,我们给帖子都加上链接:
@extends('layout')
@section('content')
<h1>所有的帖子</h1>
@foreach ($posts as $post)
<h2><a href="posts/{{ $post->id }}">{{ $post->title }}</a></h2>
<p>{{ $post->content }}</p>
@endforeach
@stop
加链接有很多方法,也有人会写成一个函数,如<a href="{{ $post->path() }}">
, 然后在Post模型层写一个path()函数
public function path()
{
return '/posts/' . $this->id;
}
不过把这个写成函数我认为也没多大必要。好了,本节到这里结束。
Eloquent关联模型的用法大家应该知道了,但是除了一对多关系,还有一对一,多对多,多态一对多等,要用的时候,可以去查这篇文档
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。