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）重新构建图表。
以下是完整可执行示例：
<?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";⚠️ 关键注意事项：
立即学习“PHP免费学习笔记（深入）”；
-
不可原地编辑图表：PhpSpreadsheet 的图表模型是“只读解析 + 全量重建”，任何对
.xlsx中<chart></chart>XML 结构的底层修改均不受官方支持，且极易破坏文件兼容性； -
数据范围必须显式指定：
DataSeriesValues构造时传入的$formula字符串（如'RawData!$A$1:$M$1'）需严格符合 Excel 引用语法，列字母大小写敏感，且不能省略$绝对符号（否则可能导致跨工作表引用失败）； -
图表类型与数据匹配：若原始模板为组合图（如柱状图+折线图），需按
DataSeries数组传入多个DataSeriesValues并正确设置plotOrder； -
性能提示：频繁重建图表时，建议复用
Worksheet实例并批量添加，避免重复addSheet()调用。
综上，虽无法“热更新”图表数据源，但通过「删旧建新」模式，你完全可控地实现数据范围伸缩、图表类型切换及多图布局，这正是 PhpSpreadsheet 在复杂报表场景下的稳健实践路径。
