Laravel 5:多对多,实现文章和tags

原文来自 https://laravist.com/article/18 javascript

Laravist 是我刚刚上线的Laravel社区,有任何与Laravel相关的问题能够到这里来问我,我会尽力去帮你们解决问题,后期会尝试录制一些视频教程,形式大概是这样的php

https://laravist.com/lesson/1 css

前奏

在开始正文以前,咱们首先来讲说在实际的开发中,常常会接触到几种常见的对应关系模式:html

One-To-One //一对一One-To-Many //一对多Many-To-Many //多对多

不知道你对这些概念是一种什么样的感觉,若是是不太理解的。你能够将这些概念应用到生活中,理解起来就很简单了,就举一个与咱们在网上常常见到的例子:java

User-To-Profile // One-To-OneUser-To-Articles // One-To-ManyArticle-To-Comments // One-To-ManyArticles-To-Tags // Many-To-Many

翻译过来就是:jquery

  1. 一个用户对应一个用户档案laravel

  2. 一个用户能够发表多篇文章git

  3. 一篇文章能够有多个评论github

  4. 而文章和标签确实多对多的关系,一篇文章能够有多个标签;一个标签能够属于多篇文章sql

在这些关系模型中,最难实现的就是Many-To-Many这种多对多的关系,可是咱们这个简单地博客并无用户管理,也就是并无开放让用户注 册,因此咱们在这里仍是要挑战一下难度,实现Articles-To-Tags这种Many-To-Many关系,借助Laravel的强大的 Eloquent,实现这个功能仍是比较顺心的。至于一对一和一对多这两种关系,能够举一反三。

建立tags表

要实现Articles-To-Tags这种Many-To-Many关系,咱们须要 tags 表和 Tag 模型,因此咱们分别来建立之。

php artisan make:migration create_tags_table --create=tags

打开生成的migration文件,为up()方法增长一行代码:

public function up(){  Schema::create('tags', function (Blueprint $table) {    $table->increments('id');    $table->string('name');    $table->timestamps();  });
}

这里咱们增长了 $table->string('name'); 这一行,这个字段表示为 tags table 添加一个 name 字段,表明标签的名字。

接下来,咱们为 tags 表建立一个 Tag 模型:

php artisan make:model Tag

生成了 Tag 模型以后,咱们先不用去管 Tag.php 文件,由于咱们还须要一张关系表 article_tag ,这个表只存 tag_idarticle_id ,因此咱们来建立之:

php artisan make:migration create_article_tag_table --create=article_tag

打开migration文件来为之加上 tag_idarticle_id 这两个字段:

 public function up()  {    Schema::create('article_tag', function (Blueprint $table) {      $table->increments('id');      $table->integer('article_id')->unsigned()->index();      $table->foreign('article_id')->references('id')->on('articles')->onDelete('cascade');      $table->integer('tag_id')->unsigned()->index();      $table->foreign('tag_id')->references('id')->on('tags')->onDelete('cascade');      $table->timestamps();    });  }

这里貌似就添加tag_id和article_id这两个字段,可是用了不少行代码,咱们只要是理解下面这个:

$table->foreign('article_id')->references('id')->on('articles')->onDelete('cascade');

foreign():外键

references():参照字段

on():参照表

onDelete():删除时的执行动做

这里是跟着删除,好比删除了某篇文章,咱们将article_tag中包含article_id同样的记录也删除

最后,执行migration生成 article_tag 表:

php artisan migrate

OK,生成这两个表以后,咱们就能够正式开始咱们的工做了。

声明Eloquent的关系

Articles和Tags是多对多的关系,因此咱们须要在 Article.php 中声明下面的关系:

public function tags()
    {
        return $this->belongsToMany('App\Tag');
    }

在Tag.php,也一样:

 public function articles()
    {
        return $this->belongsToMany('App\Article');
    }

咱们使用 $this->belongsToMany() 来代表Eloquent的关系,这里须要注意的是若是你的外键并非 article_idtag_id ,你须要在第三个参数进行设置,写成相似下面这样:

 public function articles()
    {
        return $this->belongsToMany('App\Article','conversation_id');
    }

OK,这样,咱们的多对多关系就声明完毕了。

使用Select2

在开始以前,咱们使用tinker生成几个tag,过程就不演示了,最后是这样的:

而后,为了更好地用户体验,咱们引入 Select2 ,这个对选择多个选项的时候表现得异常完美。

Select2 用法: https://select2.github.io/examples.html

咱们在app.blade.php引入Select2的css文件和js文件:

<link rel='stylesheet' href="/css/select2.css" type='text/css' media='all'/><script src="/js/jquery-2.1.0.min.js"></script><script src="/js/select2.full.min.js"></script>

在<head></head>标签内,咱们还引入了jquery,由于select2依赖于jquery,因此。注意文件的下载或来源,请自行获取。

引入以后,咱们就能够在文件建立的页面依旧使用咱们的 Form 来生成咱们的选择框了,来到 articles/create.blade.php 文件,在 published_at 下面添加一个输入表单:

<div class="form-group">
        {!! Form::label('tag_list','选择标签') !!}
        {!! Form::select('tag_list[]',$tags,null,['class'=>'form-control js-example-basic-multiple','multiple'=>'multiple']) !!}</div>

这里须要注意的是 tag_list[] ,若是咱们只是使用 tag_list ,就只能选到一个标签,若是咱们须要选择多个,咱们须要已数组的形式来储存咱们的标签,还有一个就是指定一下 'multiple'=>'multiple' ,就是开启支持多选模式。而后 $tags 就是咱们须要从数据库获tags表取到得数据,因此天然而然,咱们到 ArticleController 中的 create() 方法中,稍微修改一下代码:

public function create()
    {
        $tags = Tag::lists('name', 'id');        //为了在界面中显示标签name,id为了在保存文章的时候使用。
        return view('articles.create',compact('tags'));
    }

这里咱们使用lists()方法将Tag中(对于tags数据表)name和id以一个Eluqoent的方式返回,你可使用dd($tags),来看看。恩,这个时候来看看咱们的create页面:

这时候咱们发现,样式并无Select2那么好看,那是由于咱们尚未初始化Select2,因此咱们在create.blade.php写几行简单地js代码:

 <script type="text/javascript">
        $(function() {
            $(".js-example-basic-multiple").select2({
                placeholder: "添加标签"
            });
        });    </script>

@endsection 紧接着的上一行加上上面的代码,这里咱们使用jquery的选择器,而后调用 select2(); 来初始化咱们的选择框,再来看看效果:

很完美,咱们将整个UI完善得还不错,咱们用 dd() ;来看看咱们表单提交过来的是什么,在 ArticleController 中的 store() 方法中添加一行代码:

dd($request->all());

咱们来看看效果:

咱们看到得 tag_list 是一个数组,里面的值并非咱们选择的标签的 name ,而是标签的 id ,这样咱们就可使用laravel提供的 attach() 来添加咱们的标签了,这个 attach() 接受一个id的数组,这里正好!,因此咱们来稍微来修改一下 store() 方法:

 public function store(Requests\StoreArticleRequest $request)  {    $input = $request->all();    $input['intro'] = mb_substr($request->get('content'),0,64);    $article = Article::create($input);    $article->tags()->attach($request->input('tag_list'));    return redirect('/');  }

咱们这里首先将 Article::create($input) 赋予 $article 变量(Eloquent对象),而后使用 $article->tags()->attach() 来添加标签,并将咱们的标签数组传给 attach() 方法,咱们来看看有没有成功:

这里的文章是发表成功了,咱们再来看看咱们的标签是否添加成功,来看看咱们的 article_tag 表:

是添加了三个标签,可是咱们发现这个 created_atupdated_at 貌似有点问题,咱们来修复一下,在 Article.php 中的 tags() 方法中:

public function tags()
    {
        return $this->belongsToMany('App\Tag')->withTimestamps();
    }

咱们在后面直接使用 withTimestamps() 来同步咱们的时间,咱们再来试一试:

再来看看咱们的数据库:

看到最后的两个记录,很完美。

在视图中显示咱们的tags

咱们既然有了标签,咱们为何不来将它展现出来呢?在 articles/index.blade.php 中,咱们来将文件的标签输出一下:

<h2 class="post-title pad">  <a href="/articles/{{ $article->id }}"> {{ $article->title }}</a></h2><ul class="post-meta pad group">  <li><i class="fa fa-clock-o"></i>{{ $article->published_at->diffForHumans() }}</li>  @if($article->tags)    @foreach($article->tags as $tag)      <li><i class="fa fa-tag"></i>{{ $tag->name }}</li>    @endforeach  @endif</ul>

咱们在 <h2> 标签下面增长一个 <ul> 列表,而后是首先将发表日期 published_at 输出了,这里咱们使用了Carbon的 diffForHumans() 方法,这个方法就会产生几分钟以前,几个小时以前的效果,这里也能够体会咱们以前须要将 published_at 这个对象做为Carbon对象来对待了,若是是简单地字符串,是不能调用Carbon的 diffForHumans() 方法的。

接下来,咱们使用 $article->tags 取得文章的标签,这个 tags 就是咱们声明多对多关系的 tags() 方法。咱们来看看效果:

咱们发现 咱们的多少分钟以前 都是英文,那是由于咱们没有设置Carbon,咱们来修复一下,在 app/Providers/AppServiceProvider.php 中的 boot() 方法添加下面这一行:

\Carbon\Carbon::setLocale('zh');

而后刷新,见证一下奇迹吧:

总结

到这里咱们利用laravel提供的 attach() 方法将基本的多对多关系实现了,而且还稍微美化了一下输出,将 published_at 字段完美呈现。

相关文章
相关标签/搜索