2

从零开始学Laravel目录

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


周继平
386 声望50 粉丝

产品&研发