8. 使用Elequent建立表与表之间的关系

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

fillable

嗯，出现了匹配异常错位，这是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关联模型的用法大家应该知道了，但是除了一对多关系，还有一对一，多对多，多态一对多等，要用的时候，可以去查这篇文档

8. 使用Elequent建立表与表之间的关系

周继平

引用和评论

阿里云ECS: Ubuntu20.04安装Laravel运行环境

Laravel 入门：01-开篇

Ubuntu 部署 Laravel 项目

laravel 中实现注解注入

laravel-api-response - 规范化和标准化 Laravel API 响应数据结构

Laravel 入门：02-搭建开发环境 & 创建项目

2025年PHP会更加火爆吗？