如何使用 PhpSpreadsheet 动态替换模板中图表的数据源-php教程-PHP中文网

如何使用 PhpSpreadsheet 动态替换模板中图表的数据源

phpspreadsheet 不支持直接修改已存在图表的数据源范围；需通过删除原图表所在工作表、重建工作表并重新创建图表来实现数据范围更新。本文提供完整替代方案，含工作表管理、多系列图表构建及关键注意事项。

phpspreadsheet 不支持直接修改已存在图表的数据源范围；需通过删除原图表所在工作表、重建工作表并重新创建图表来实现数据范围更新。本文提供完整替代方案，含工作表管理、多系列图表构建及关键注意事项。

在实际业务场景中（如报表自动化），我们常需基于 Excel 模板生成动态图表——例如将原始数据列从 A:H 扩展为 A:M，并让图表自动适配新范围。遗憾的是，PhpSpreadsheet 当前版本（v2.2+）并未开放对已有图表 dataSource 的写入接口：getDataSource() 仅存在于 DataSeriesValues 类中，用于读取图表内部数据序列的配置，而非修改图表整体引用区域；且 Chart 对象本身不提供 setDataSource() 或类似方法。调用 $chart->getDataSource() 报错（“undefined method”）正是因为该方法不属于 Chart 类，而是属于其嵌套的 DataSeriesValues 实例。

因此，推荐采用「重建式更新」策略：

定位并移除旧图表页（如 "Charts" 工作表）；
创建新工作表（可同名以保持结构一致性）；
基于更新后的数据范围（如 RawData!$A$1:$M$1 和 RawData!$A$2:$M$2）重新构建图表。

以下是完整可执行示例：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php require 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Worksheet\Worksheet;
use PhpOffice\PhpSpreadsheet\Chart\Chart;
use PhpOffice\PhpSpreadsheet\Chart\DataSeries;
use PhpOffice\PhpSpreadsheet\Chart\DataSeriesValues;
use PhpOffice\PhpSpreadsheet\Chart\Legend;
use PhpOffice\PhpSpreadsheet\Chart\PlotArea;
use PhpOffice\PhpSpreadsheet\Chart\Title;

// 加载模板文件
$spreadsheet = \PhpOffice\PhpSpreadsheet\IOFactory::load('template.xlsx');

// ✅ 步骤1：删除原图表页（避免残留）
$chartSheetName = 'Charts';
if ($spreadsheet->sheetExists($chartSheetName)) {
    $spreadsheet->removeSheetByIndex($spreadsheet->getIndex($spreadsheet->getSheetByName($chartSheetName)));
}

// ✅ 步骤2：创建新图表页
$chartSheet = new Worksheet($spreadsheet, $chartSheetName);
$spreadsheet->addSheet($chartSheet, -1); // 添加至末尾

// ✅ 步骤3：定义更新后的数据范围（列扩展至 M）
$dataRangeHeadings = 'RawData!$A$1:$M$1'; // 标题行
$dataRangeValues   = 'RawData!$A$2:$M$2'; // 数据行

// 构建数据序列：X轴（类别） + Y轴（数值）
$xAxis = new DataSeriesValues(
    DataSeriesValues::DATASERIES_TYPE_CATEGORY,
    $dataRangeHeadings,
    null,
    1 // 1个标题单元格
);

$yAxis = new DataSeriesValues(
    DataSeriesValues::DATASERIES_TYPE_VALUE,
    $dataRangeValues,
    null,
    1 // 1行数据
);

$series = new DataSeries(
    DataSeries::TYPE_LINECHART, // 图表类型
    DataSeries::GROUPING_STANDARD,
    range(0, 11), // 假设12列数据 → 生成12个数据点（索引0~11）
    [new Title('Sales')],
    [$xAxis],
    [$yAxis],
    null,
    null,
    null,
    true // smooth line
);

// 创建图表对象
$plotArea = new PlotArea(null, [$series]);
$legend = new Legend(Legend::POSITION_RIGHT, null, false);
$title = new Title('Chart_12');

$chart = new Chart(
    'chart_12', // chart id
    $title,
    $legend,
    $plotArea,
    true, // plotVisibleOnly
    0,    // displayBlanksAs: 0 = gap
    null, // xAxisLabel
    null  // yAxisLabel
);

// 将图表插入新工作表（位置：B2 单元格）
$chartSheet->addChart($chart);
$chart->setTopLeftPosition('B2');
$chart->setBottomRightPosition('P20');

// ✅ 保存结果
$writer = \PhpOffice\PhpSpreadsheet\IOFactory::createWriter($spreadsheet, 'Xlsx');
$writer->save('updated_report.xlsx');

echo "✅ 图表已基于新数据范围（A1:M2）成功重建。\n";

⚠️ 关键注意事项：

不可原地编辑图表：PhpSpreadsheet 的图表模型是“只读解析 + 全量重建”，任何对 .xlsx 中 <chart></chart> XML 结构的底层修改均不受官方支持，且极易破坏文件兼容性；
数据范围必须显式指定：DataSeriesValues 构造时传入的 $formula 字符串（如 'RawData!$A$1:$M$1'）需严格符合 Excel 引用语法，列字母大小写敏感，且不能省略 $ 绝对符号（否则可能导致跨工作表引用失败）；
图表类型与数据匹配：若原始模板为组合图（如柱状图+折线图），需按 DataSeries 数组传入多个 DataSeriesValues 并正确设置 plotOrder；
性能提示：频繁重建图表时，建议复用 Worksheet 实例并批量添加，避免重复 addSheet() 调用。