php不画图，只输出结构正确、格式干净的json供echarts使用；必须设置header('content-type: application/json; charset=utf-8')，确保utf-8无bom、字段名准确（如xaxis而非xaxis）、数值非字符串、无多余输出，否则前端报错或白屏。
PHP 本身不画图，只负责把结构正确、格式干净的 JSON 数据吐给前端 ECharts。只要字段名拼错、多一个空格、漏个 header，前端就会报 TypeError: Cannot read property 'data' of undefined 或直接卡在 Unexpected token —— 这不是 ECharts 的问题，是 PHP 输出没过关。
PHP 接口必须返回纯 JSON，且开头不能有任何干扰字符
常见错误是 PHP 文件开头有 BOM（尤其 Windows 编辑器保存的 UTF-8 with BOM）、echo 前不小心输出了 warning、或调试时留了 var_dump()。这些都会让响应体以 HTML 或文本开头，导致 ECharts 解析失败。
- 务必在
echo json_encode(...)前调用header('Content-Type: application/json; charset=utf-8') - 确保 PHP 文件编码为
UTF-8 without BOM（用 VS Code / Sublime 等编辑器检查并转换） - 上线前用
curl -v http://your-api.php看原始响应：第一行必须是{或[，不能有/code>、<code>Warning:、空白行 - 开发期加一句
if (json_last_error() !== JSON_ERROR_NONE) { die('JSON encode failed'); }快速定位数据问题
ECharts 要的字段结构必须严格匹配，不能靠“差不多”
ECharts 不会自动映射字段，xAxis.data 和 series.data 是两个平行数组，不是数据库查出来的每行记录。直接 mysqli_fetch_all($result, MYSQLI_ASSOC) 得到的是「行式」数据，而图表需要「列式」结构。
- 例如统计每日订单量：SQL 要写成
SELECT DATE_FORMAT(created_at, '%Y-%m-%d') AS date, COALESCE(COUNT(*), 0) AS cnt FROM orders GROUP BY date ORDER BY date - PHP 中需手动拆出两个数组：
$xAxisData = array_column($rows, 'date')，$seriesData = array_column($rows, 'cnt') - 最终组装成标准结构：
['xAxis' => ['data' => $xAxisData], 'series' => [['data' => $seriesData]]] - 字段名大小写敏感：
xaxis或XAxis都不行，必须是xAxis；series.data不能写成series.values
中文、NULL、浮点精度这些细节一错就静默失败
json_encode() 对非 UTF-8 字符串、null 值、资源类型会返回 false，但很多代码没检查返回值，结果接口返回空内容或字符串 "null"，前端拿到后直接崩。
- 数据库字段含中文？用
JSON_UNESCAPED_UNICODE：json_encode($data, JSON_UNESCAPED_UNICODE | JSON_NUMERIC_CHECK) - 数值字段可能为
NULL？SQL 里用COALESCE(sum(amount), 0)，PHP 里用intval()或(float)强转，避免null进入 JSON - 浮点数精度失控？比如
3.141592653589793渲染柱状图时显示异常，可加round($val, 2)控制小数位 - 永远检查
$json = json_encode($data); if ($json === false) { error_log(json_last_error_msg()); die(); }
真正难的不是写几行 json_encode，而是确保从 MySQL 查询那一刻起，每个字段类型、空值处理、时间格式、编码、HTTP 响应头、前端 fetch 的 response.json() 调用时机——全部环环相扣。少一个环节，ECharts 就只会默默白屏或报错，不会告诉你哪错了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
