Laravel8.x无限级分类怎么导出完整分类树-php教程-PHP中文网

Laravel 8.x 导出无限级分类树需先用自关联模型查出全部节点并按 parent_id 和 sort 排序，再通过 PHP 递归构建带层级、路径、缩进的树形数组，最后导出为 Excel（PhpSpreadsheet）、JSON 或 HTML 预览页，并建议添加排序控制、深度限制与 Redis 缓存。

laravel8.x无限级分类怎么导出完整分类树

在 Laravel 8.x 中导出完整无限级分类树（如商品类目、文章栏目等），关键不是“直接导出数据库表”，而是递归构建树形结构 + 格式化为可导出的数据（如 Excel、CSV、JSON）。下面给出清晰、可落地的实现方案。

1. 确保模型支持父子关系（典型 Nested Set 或 Closure Table 或自关联）

无限级分类常见三种实现方式，Laravel 8 推荐使用 自关联 + 递归查询（简单直观，适合中小数据量）或 Closure Table（性能更好）。这里以最常用的「自关联」为例：

数据表需含 id、name、parent_id（可为 null）、sort 等字段
模型中定义关系：
class Category extends Model
{
  public function children()
  {
    return $this->hasMany(Category::class, 'parent_id');
  }

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

2. 构建完整树形数组（带层级标识）

避免 N+1 查询，用一次查出全部节点，再用 PHP 递归组装。推荐使用「扁平转树」方式，高效且可控：

先查出所有分类，按 parent_id 分组：
$all = Category::select('id', 'name', 'parent_id', 'sort')
  ->orderBy('parent_id')->orderBy('sort')
  ->get()
  ->groupBy('parent_id');
编写递归函数生成带层级、路径、深度的树：
function buildTree($groups, $parentId = 0, $level = 0, $path = '') {
  $tree = [];
  if (!$groups->has($parentId)) return $tree;
  foreach ($groups[$parentId] as $item) {
    $currentPath = $path ? "$path-{$item->name}" : $item->name;
    $tree[] = [
      'id' => $item->id,
      'name' => $item->name,
      'parent_id' => $item->parent_id,
      'level' => $level,
      'path' => $currentPath,
      'indent' => str_repeat('│　', $level) . '├─ ',
    ];
    $tree = array_merge($tree, buildTree($groups, $item->id, $level + 1, $currentPath));
  }
  return $tree;
}
$fullTree = buildTree($all);

3. 导出为 Excel（用 PhpSpreadsheet）

安装：composer require phpoffice/phpspreadsheet

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

将 $fullTree 转为二维表格数据（含缩进、层级、完整路径）：
$rows = [];
foreach ($fullTree as $node) {
  $rows[] = [
    $node['id'],
    $node['indent'] . $node['name'], // 可视化缩进名
    $node['level'],
    $node['path'],
    $node['parent_id'] ?: '-',
  ];
}
使用 PhpSpreadsheet 写入并下载：
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->fromArray(array_merge([['ID', '分类名', '层级', '完整路径', '父ID']], $rows), NULL, 'A1');
// 设置列宽
$sheet->getColumnDimension('B')->setWidth(40);
$sheet->getColumnDimension('D')->setWidth(60);
// 下载
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment;filename="category-tree.xlsx"');
$writer = new Xlsx($spreadsheet);
$writer->save('php://output');

4. 补充：导出为 JSON 或带 HTML 的树状预览页

如果用于前端展示或 API，可直接返回格式化 JSON：

添加辅助方法到模型或服务类：
public function toTreeArray($items, $parentId = 0) {
  $branch = [];
  foreach ($items as $item) {
    if ($item->parent_id == $parentId) {
      $children = $this->toTreeArray($items, $item->id);
      $branch[] = array_merge($item->toArray(), ['children' => $children]);
    }
  }
  return $branch;
}
控制器中调用：
$all = Category::all();
return response()->json(['tree' => $this->toTreeArray($all)]);