Laravel任务层级遍历需求：先展示子任务再处理下一级父任务

需求说明 #

需要按深度优先顺序展示任务：先显示父任务，紧接着展示其所有子任务（含子任务的下级子任务），再处理下一个同级父任务。期望展示效果如下：

tasks 1
Task 1.1
Tasks 1.2
Task 1.2.1
Task 1.3
tasks 2

现有基础条件 #

• 数据库表包含两个核心字段：id（任务唯一ID）、parent_id（父任务ID，顶级任务的parent_id为null或0）
• Laravel任务模型已定义父子关联：

public function parent()
{
    return $this->belongsTo(self::class, 'parent_id');
}

public function children()
{
    return $this->hasMany(self::class, 'parent_id');
}

解决方案 #

方法1：Blade递归模板（视图层处理） #

适合直接在前端页面渲染的场景，利用Blade的模板包含功能实现递归。

步骤1：控制器获取顶级任务

先从数据库取出所有顶级任务（无父任务的任务），并预加载子任务避免N+1查询：

// 假设任务模型名为Task
$topLevelTasks = Task::with('children')->whereNull('parent_id')->get();

return view('tasks.list', compact('topLevelTasks'));

步骤2：创建递归模板片段

在resources/views/tasks/partials/task_item.blade.php中编写递归逻辑：

@foreach($tasks as $task)
    {{-- 渲染当前任务 --}}
    <p>{{ $task->name }}</p>

    {{-- 如果当前任务有子任务，递归渲染 --}}
    @if($task->children->isNotEmpty())
        {{-- 可添加缩进样式区分层级 --}}
        <div style="padding-left: 20px;">
            @include('tasks.partials.task_item', ['tasks' => $task->children])
        </div>
    @endif
@endforeach

步骤3：主视图调用递归模板

在resources/views/tasks/list.blade.php中引入模板：

<div class="task-list">
    @include('tasks.partials.task_item', ['tasks' => $topLevelTasks])
</div>

方法2：后端递归函数（生成文本/结构化输出） #

如果需要在后端生成格式化的文本输出，或者将层级结构处理后再传递给视图，可以用递归函数实现：

// 获取预加载所有层级子任务的顶级任务
$topLevelTasks = Task::with('children.children')->whereNull('parent_id')->get();

// 递归生成任务文本
function generateTaskTree($tasks) {
    $output = '';
    foreach($tasks as $task) {
        $output .= $task->name . "\n";
        // 递归处理子任务
        if($task->children->isNotEmpty()) {
            $output .= generateTaskTree($task->children);
        }
    }
    return $output;
}

// 调用函数得到结果
$taskTreeText = generateTaskTree($topLevelTasks);
// 输出或传递给视图
echo nl2br($taskTreeText);

优化：递归预加载所有层级子任务 #

如果任务层级不确定（可能有多层子任务），可以在模型中定义递归预加载方法，一次性加载所有层级：

// Task模型中添加方法
public static function withRecursiveChildren() {
    return self::with(['children' => function($query) {
        $query->withRecursiveChildren();
    }]);
}

// 使用时
$topLevelTasks = Task::withRecursiveChildren()->whereNull('parent_id')->get();

内容的提问来源于stack exchange，提问作者Jose Lopez