在Symfony中将多维（嵌套）数组导出为CSV文档

好的，咱们来解决如何把你提供的这种嵌套多维数组导出成CSV的问题。首先得明确：CSV是二维表格格式，所以核心步骤是先把嵌套的多维结构扁平化，把每个层级的子节点转换成独立的表格行，同时保留必要的父级关联信息，之后再用Symfony的响应机制生成可下载的CSV文件。

1. 先写递归函数扁平化嵌套数组 #

针对你给出的数组结构（包含children/_children嵌套、info子数组），我们可以写一个递归函数，把每个节点（包括所有子节点）转换成一行扁平数据，还能按需带上父节点ID来体现层级关系：

/**
 * 递归扁平化嵌套数组
 * @param array $data 当前处理的节点数据
 * @param array $parentData 父节点的关联数据（比如父ID）
 * @return array 扁平化后的一维数组集合
 */
function flattenNestedArray(array $data, array $parentData = []): array
{
    $flattened = [];
    
    // 组装当前节点的行数据
    $currentRow = $parentData;
    // 提取基础字段
    $currentRow['id'] = $data['id'];
    $currentRow['name'] = $data['name'];
    // 提取info子数组的字段，加前缀避免冲突
    foreach ($data['info'] as $key => $value) {
        $currentRow["info_{$key}"] = $value;
    }
    // 可选：添加父节点ID，方便识别层级
    if (!empty($parentData['id'])) {
        $currentRow['parent_id'] = $parentData['id'];
    }
    
    $flattened[] = $currentRow;
    
    // 递归处理子节点（兼容children和_children两种键名）
    $children = $data['children'] ?? $data['_children'] ?? [];
    foreach ($children as $child) {
        $flattened = array_merge($flattened, flattenNestedArray($child, $currentRow));
    }
    
    return $flattened;
}

这个函数会把所有嵌套的子节点都展开成单独一行，比如你的示例数组会被转换成3行数据（主节点+两个子节点），每行都包含自身的id/name/info_*字段，以及父节点ID（如果有的话）。

2. 在Symfony Controller中生成CSV响应 #

接下来有两种常用方式生成CSV下载响应，适合不同场景：

方式一：用原生PHP结合StreamedResponse（适合大数据量） #

StreamedResponse会边生成边输出内容，不会把所有数据加载到内存里，处理大量数据时更高效：

use Symfony\Component\HttpFoundation\StreamedResponse;

public function exportCsvAction()
{
    // 假设你的嵌套数组是从数据库/业务逻辑中获取的
    $nestedArray = [/* 你的多维数组数据 */];
    
    // 先扁平化数组
    $flattenedData = flattenNestedArray($nestedArray);
    
    // 生成流式响应
    $response = new StreamedResponse(function () use ($flattenedData) {
        $handle = fopen('php://output', 'w');
        
        // 写入CSV表头（从扁平化后的第一行提取键名）
        if (!empty($flattenedData)) {
            fputcsv($handle, array_keys($flattenedData[0]));
        }
        
        // 逐行写入数据
        foreach ($flattenedData as $row) {
            fputcsv($handle, $row);
        }
        
        fclose($handle);
    });
    
    // 设置响应头，让浏览器识别为CSV并触发下载
    $response->headers->set('Content-Type', 'text/csv; charset=utf-8');
    $response->headers->set('Content-Disposition', 'attachment; filename="nested_data_export.csv"');
    
    return $response;
}

方式二：用League\Csv组件（功能更强大） #

如果需要更灵活的CSV处理（比如自定义分隔符、编码转换、添加注释等），可以用League\Csv组件：

首先通过Composer安装组件：

composer require league/csv

然后在Controller中使用：

use League\Csv\Writer;
use Symfony\Component\HttpFoundation\Response;

public function exportCsvWithLeagueAction()
{
    $nestedArray = [/* 你的多维数组数据 */];
    $flattenedData = flattenNestedArray($nestedArray);
    
    // 创建CSV写入器
    $csv = Writer::createFromString('');
    $csv->setDelimiter(',');
    $csv->setEnclosure('"');
    $csv->setEscape('\\');
    
    // 写入表头
    if (!empty($flattenedData)) {
        $csv->insertOne(array_keys($flattenedData[0]));
    }
    
    // 批量写入数据
    $csv->insertAll($flattenedData);
    
    // 生成响应
    $response = new Response($csv->toString());
    $response->headers->set('Content-Type', 'text/csv; charset=utf-8');
    $response->headers->set('Content-Disposition', 'attachment; filename="nested_data_export.csv"');
    
    return $response;
}

3. 关键注意事项 #

• 字段冲突处理：我给info里的字段加了info_前缀，避免和其他层级的字段重名，你可以根据需求调整命名规则；
• 空值兼容：如果某些子节点的info字段不全（比如有的子节点没有total），扁平化后会自动留空，CSV中会显示为空单元格；
• 编码问题：务必设置charset=utf-8，避免中文或特殊字符乱码；
• 层级识别：如果需要在CSV中体现父子关系，保留parent_id字段是很实用的方式。

这样处理后，你的嵌套多维数组就能转换成结构清晰、可直接打开的CSV文件啦！

内容的提问来源于stack exchange，提问作者George Meif