PHP后端需校验并返回符合ECharts字段要求的标准JSON，如series.data、xAxis.data等；常见错误是字段名拼错或嵌套层级错误导致前端报TypeError或Unexpected token。
PHP 后端怎么安全返回图表数据给 ECharts
PHP 本身不画图，它的角色是把数据准备好、格式校验好、接口响应快。ECharts 是前端 JS 库，只认 JSON 格式的数据，所以 PHP 只需输出标准 JSON，且确保字段名和结构匹配 ECharts 的 series.data、xAxis.data 等要求。
常见错误现象：TypeError: Cannot read property 'data' of undefined，基本都是后端返回的 JSON 字段名拼错，或嵌套层级不对；还有 Unexpected token ，说明 PHP 输出了 HTML、Warning 或 BOM 头，根本不是纯 JSON。
- 用
json_encode($data, JSON_UNESCAPED_UNICODE | JSON_NUMERIC_CHECK)，避免中文乱码和数字被转成字符串 - 务必在
echo前调用header('Content-Type: application/json; charset=utf-8') - 禁止在 JSON 输出前有任何
echo、var_dump、空白字符或 BOM（尤其 UTF-8 with BOM 的 .php 文件） - 上线前用
curl -v http://your-api.php直接看原始响应体，确认开头就是{，没有 HTML 标签或 PHP Warning
从 MySQL 查数据 → 组成 ECharts 要的数组结构
直接 mysqli_fetch_all($result, MYSQLI_ASSOC) 拿到的是「每行一条记录」的数组，但 ECharts 的柱状图/折线图通常需要两个平行数组：xAxis.data（横轴标签，比如日期）、series.data（对应数值）。PHP 得自己拆出来。
使用场景：统计每天订单量、各品类销售额、用户地域分布等聚合类图表。
立即学习“PHP免费学习笔记（深入）”；
- 别用
SELECT * FROM table，明确写字段，避免 NULL 或类型混乱影响json_encode - 日期类字段用
DATE_FORMAT(created_at, '%Y-%m-%d')统一格式，前端才好当xAxis.data - 数值字段用
COALESCE(sum(amount), 0)防止 NULL 进入 JSON 变成null，ECharts 会跳过该点 - 示例结构要长这样：
{"xAxis":{"data":["2024-01-01","2024-01-02"]},"series":[{"data":[120,200]}]}
如何防止 JSON 输出时出错（特别是中文、特殊字符、浮点精度）
PHP 的 json_encode 对非 UTF-8 字符串、资源类型、循环引用会静默失败并返回 false，但很多开发者没检查返回值，结果接口吐出空内容或 NULL 字符串。
性能影响：大数组反复 json_encode 不会卡，但若数据量超 10 万条，建议分页或聚合后再传，ECharts 渲染太多点会卡死浏览器。
- 始终检查
$json = json_encode($data); if ($json === false) { error_log(json_last_error_msg()); die('JSON encode failed'); } - 数据库字段如果是
TEXT或含 HTML，用strip_tags()或htmlspecialchars_decode()清理，避免引号破坏 JSON 结构 - 浮点数如
3.1415926默认保留全部位数，ECharts 不需要那么高精度，可用round($val, 2)控制小数位，减少传输体积 - 不要用
mysql_real_escape_string或addslashes处理要进 JSON 的数据——那是防 SQL 注入的，JSON 编码自有转义逻辑
为什么不能用 PHP 直接生成 PNG/SVG 图片再喂给前端
能做，但没必要，而且容易踩坑。像 imagecreatefrompng + imagettftext 这套流程，维护成本高、字体渲染不一致、响应慢、无法交互（缩放/拖拽/提示框），还占 PHP 进程资源。
兼容性影响：GD 库在某些 Docker 环境或共享主机上默认关闭，extension=gd 没开就会报 Call to undefined function imagecreatefrompng()；而 ECharts 只依赖前端 JS，服务端零依赖。
- 除非你有离线导出 PDF 报表的硬需求，否则别在 PHP 里画图
- 真要服务端截图（比如分享用），用 Puppeteer 或 Playwright 更可靠，PHP 只负责调用命令行
- ECharts 的
chart.getDataURL()可在前端一键导出 PNG，比 PHP 后端生成更轻、更准、更可控
最常被忽略的是：后端返回的 JSON 里混进了 PHP 错误提示（比如 Notice: Undefined index），或者用了 print_r 调试后忘记删，导致 JSON 结构被污染。上线前一定用 curl 看原始响应，而不是只在浏览器里 F12 看 Network —— 浏览器可能已缓存或自动补全了损坏的 JSON。
