Laravel多级评论系统：父子评论管理与展示

1. 数据库结构设计

构建评论和回复系统首先需要一个能够表示父子关系的数据库表。我们通过在评论表中添加一个自引用的外键来实现这一目标。

以下是 article_comments 表的迁移文件定义：

Schema::create('article_comments', function (Blueprint $table) {
   $table->bigIncrements('id');
   $table->unsignedBigInteger('article_id');
   $table->foreign('article_id')
         ->references('id')->on('articles')->onDelete('cascade'); // 关联文章
   $table->string('name');
   $table->string('email');
   $table->text('text');
   $table->string('date'); // 评论日期

   $table->unsignedBigInteger('comment_id')->nullable(); // 自引用外键，用于回复
   $table->foreign('comment_id')
         ->references('id')->on('article_comments')->onDelete('set null'); // 父评论删除时，子评论的 comment_id 设为 null

   $table->timestamps();
});

关键点说明：

• article_id：指向所属文章的外键，当文章被删除时，其所有评论也一并删除 (onDelete('cascade'))。
• comment_id：这是一个 nullable 的 unsignedBigInteger 字段，作为自引用外键。
  • 如果 comment_id 为 null，则表示这是一条顶级评论。
  • 如果 comment_id 包含一个有效的 article_comments 表的 id，则表示这条评论是对该 id 评论的回复。
  • onDelete('set null') 策略确保当父评论被删除时，其子回复不会被一并删除，而是将其 comment_id 设为 null，使其成为新的顶级评论（或根据业务需求处理）。

2. Eloquent 模型关系定义

为了方便地通过 Eloquent 操作评论和回复，我们需要在模型中定义相应的关系。

2.1 ArticleComment 模型

在 ArticleComment.php 模型中，定义一个 answers 关系来获取当前评论的所有直接回复。

// app/Models/ArticleComment.php
hasMany(ArticleComment::class, 'comment_id', 'id');
    }

    /**
     * 获取当前回复所属的父评论。
     */
    public function parentComment()
    {
        return $this->belongsTo(ArticleComment::class, 'comment_id', 'id');
    }

    /**
     * 获取评论所属的文章。
     */
    public function article()
    {
        return $this->belongsTo(Article::class);
    }
}

• answers()：定义了当前评论与它的所有回复之间的“一对多”关系。comment_id 是 ArticleComment 表中指向父评论 ID 的外键。
• parentComment()：定义了回复与它的父评论之间的“多对一”关系，方便从回复追溯到父评论。

2.2 Article 模型

在 Article.php 模型中，定义一个 comments 关系来获取文章的所有评论。

// app/Models/Article.php
hasMany(ArticleComment::class, 'article_id', 'id');
    }
}

3. 高效数据检索

为了避免 N+1 查询问题并高效地获取文章、其顶级评论以及这些评论的回复，我们应该使用 Eloquent 的预加载（Eager Loading）功能。

3.1 获取文章及其所有顶级评论与回复

此方法适用于一次性加载一篇文章的所有评论和它们的直接回复，非常适合在文章详情页展示评论列表。

use App\Models\Article;

$articleId = 1; // 假设文章ID为1

$articleWithCommentsAndReplies = Article::where('id', $articleId)
    ->with(['comments' => function($query) {
        $query->whereNull('comment_id') // 仅获取顶级评论
              ->with('answers');       // 预加载顶级评论的直接回复
    }])
    ->first(); // 使用 first() 获取单个文章模型

// 如果需要获取所有文章及其评论，可以使用 get()
// $articles = Article::with(['comments' => function($q) { ... }])->get();

// 示例输出结构 (toArray() 转换后)
/*
[
  {
    "id": 1,
    "title": "文章标题 1",
    "content": "文章内容...",
    "comments": [
      {
        "id": 1,
        "article_id": 1,
        "name": "用户A",
        "text": "这是一条顶级评论。",
        "comment_id": null, // 顶级评论
        "answers": [ // 顶级评论的回复
          {
            "id": 5,
            "article_id": 1,
            "name": "用户B",
            "text": "回复用户A的评论1。",
            "comment_id": 1
          },
          {
            "id": 6,
            "article_id": 1,
            "name": "用户C",
            "text": "回复用户A的评论2。",
            "comment_id": 1
          }
        ]
      },
      {
        "id": 2,
        "article_id": 1,
        "name": "用户D",
        "text": "这是另一条顶级评论。",
        "comment_id": null,
        "answers": [] // 没有回复
      }
    ]
  }
]
*/

说明：

• with(['comments' => function($query) { ... }])：预加载文章的评论。
• $query->whereNull('comment_id')：在加载评论时，我们只选择 comment_id 为 null 的评论，即顶级评论。
• ->with('answers')：在顶级评论的基础上，进一步预加载它们的 answers 关系，即直接回复。
• 这种方法通过一次或少数几次数据库查询就获取了所有必要的数据，极大提高了效率。

3.2 单独获取评论的回复

如果你只需要获取某个特定评论的所有回复（例如，在评论详情页），可以使用以下查询：

use App\Models\ArticleComment;

$parentCommentId = 1; // 假设父评论ID为1

$repliesToComment = ArticleComment::where('comment_id', $parentCommentId)
    ->get();

// 示例输出：所有 comment_id 为 1 的评论

3.3 获取单个评论及其所有回复

如果你需要获取一个特定的顶级评论及其所有直接回复：

use App\Models\ArticleComment;

$commentId = 1; // 假设顶级评论ID为1

$commentWithItsReplies = ArticleComment::where('id', $commentId)
    ->with('answers')
    ->first();

// 示例输出：ID为1的评论及其answers

4. 前端视图展示

在 Blade 模板中，我们可以遍历获取到的数据结构，并根据 answers 关系来区分顶级评论和回复。

    @if($articleWithCommentsAndReplies && $articleWithCommentsAndReplies->comments->isNotEmpty())
        @foreach($articleWithCommentsAndReplies->comments as $comment)
            {{-- 顶级评论 --}}
            

                

                    

                        

                            

                                {!! $comment->name !!}
                            
                            

                                {!! date('d F Y', strtotime($comment->date)) !!}
                            
                        
                    
                    

                        {!! $comment->text !!}
                    
                

                {{-- 如果存在回复，则显示回复列表 --}}
                @if($comment->answers->isNotEmpty())
                    

                        @foreach($comment->answers as $reply)
                            

                                

                                    

                                        

                                            

                                                {!! $reply->name !!}
                                            
                                            

                                                {!! date('d F Y', strtotime($reply->date)) !!}
                                            
                                        
                                    
                                    

                                        {!! $reply->text !!}
                                    
                                
                            
                        @endforeach
                    
                @endif
            
        @endforeach
    @else
        
暂无评论。
    @endif

说明：

1. 外层循环遍历 $articleWithCommentsAndReplies->comments，这只会包含顶级评论（因为我们在查询时使用了 whereNull('comment_id')）。
2. 在每个顶级评论内部，通过 if($comment->answers->isNotEmpty()) 判断是否存在回复。
3. 如果存在回复，则使用内层循环遍历 $comment->answers 来显示所有直接回复。
4. 通过不同的 CSS 类（comment-list__item 和 comment-sub-list__item）来区分顶级评论和回复，通常回复会进行视觉上的缩进处理。

5. 注意事项与优化

• 多级回复深度： 当前方案支持一级回复（即顶级评论下的直接回复）。如果需要支持无限级或更深层次的回复（例如，回复的回复），需要调整 answers 关系为递归关系，或者考虑使用专门的树形结构包（如 baum/baum 或 kalnoy/nestedset），但会增加复杂性。对于大多数博客或文章评论系统，一级回复已足够。
• 性能考量： 始终使用 with() 进行预加载，避免在循环中执行数据库查询（N+1 问题）。本教程中的查询方法已经很好地解决了这一点。
• 用户界面/用户体验 (UI/UX)： 在前端展示时，回复通常会相对于父评论进行视觉上的缩进，以清晰地表示层级关系。同时，考虑添加“回复”按钮，方便用户提交回复。
• 数据验证： 在处理评论提交时，务必对用户输入进行严格的验证，防止 XSS 攻击或其他恶意输入。
• 分页： 如果评论数量非常大，应考虑对顶级评论进行分页，以提高页面加载速度。预加载的回复会跟随其父评论一起分页。
• 安全性： 在显示用户输入的内容时，使用 {{ $comment->text }} 而不是 !! $comment->text !!，除非你明确知道内容是安全的 HTML 且需要解析，否则可能引入 XSS 漏洞。在示例中，我们假设内容已在存储前进行了净化或由管理员审核。

通过以上步骤，您可以在 Laravel 应用程序中构建一个功能完善且性能优化的文章评论与回复系统。