jpgraph 默认不支持直接导出 PNG/JPEG，需调用 Stroke() 方法写入文件或输出流；中文显示需正确配置 TrueType 字体路径与编码，导出下载须设置响应头并清空缓冲区。
jpgraph 默认不支持直接导出 PNG/JPEG，但能生成图像文件
jpgraph 本身是绘图库，不是导出工具；它通过 Stroke() 方法把图表输出到浏览器或文件流。所谓“导出图片”，本质是把图表写入本地文件（如 chart.png），再由前端提供下载链接或后端直接返回二进制响应。
- 调用
$graph->Stroke('/path/to/chart.png')可直接保存为 PNG 文件（路径需有写权限） - 若传入 null 或不传参数，
Stroke()默认输出到 stdout（即浏览器），此时需配合 header 设置 Content-Type - 注意：保存路径必须是绝对路径，相对路径容易因 CLI/web 运行目录不同而失败
- 常见错误：
Warning: Cannot modify header information—— 是因为已输出内容（如空格、echo、BOM）导致 header 失败
导出时中文乱码？核心是字体路径和编码没对上
jpgraph 对中文支持弱，不配置字体必乱码。关键不是“用了中文字体”，而是字体文件真实存在、路径可读、且编码与数据一致。
- 用
$graph->SetShadow(TRUE)前先确认是否启用 GD 支持（phpinfo()查 gd.jpeg/gd.png 是否 enabled） - 中文字体必须是 TrueType（.ttf），推荐使用
simhei.ttf或msyh.ttc，不能用 .fon/.otf - 设置方式：
$graph->title->SetFont(FF_SIMSUN, FS_BOLD);，同时确保FF_SIMSUN已用DefineFont()注册过路径 - 注册示例：
DefineFont('simhei', '/var/www/fonts/simhei.ttf');—— 路径错一个字符就回退成方块 - 数据库/CSV 数据如果是 UTF-8，但图表标题用 GBK 字体，也会乱码；统一用 UTF-8 + 支持 Unicode 的字体更稳妥
想让导出按钮触发下载？别只靠 jpgraph，要配好 HTTP 响应头
单纯生成文件不等于用户能下载；需要 PHP 输出文件内容，并设置正确 header，否则浏览器可能直接渲染图片或报错。
- 生成临时文件后，用
readfile('/tmp/chart_123.png')输出二进制内容 - 必须前置设置：
header('Content-Type: image/png');和header('Content-Disposition: attachment; filename="chart.png"'); - 务必在
readfile()前调用ob_end_clean()，清除缓冲区，否则图片开头混入 HTML 就打不开 - 避免使用
exit或die后续逻辑——如果后面还有日志记录或清理，得改用fastcgi_finish_request()（PHP-FPM 环境） - 小技巧：导出前加个随机参数（如
?t=1712345678）可绕过 CDN 缓存图片
替代方案：jpgraph 维护停滞，导出需求复杂时建议换现代方案
jpgraph 最后稳定版是 4.x（2018 年），不支持 PHP 8.2+ 的部分严格类型检查，也无 SVG 导出、交互式缩放等能力。如果项目允许升级，值得考虑更轻量可控的替代路径。
立即学习“PHP免费学习笔记（深入）”；
- 纯服务端：用
canvas模拟（如node-canvas+ PHP exec）太重；更现实的是改用 Chart.js 配合html2canvas+canvas2image前端导出（适合简单图表） - 服务端生成：Laravel 用户可用
consoletvs/charts（底层用 Chart.js 渲染）+ PhantomJS 截图，但部署麻烦 - 最稳过渡方案：保留 jpgraph 生成 PNG，但用
imagick扩展做二次处理（如加水印、转 WebP、压缩体积） - 真正卡点常不在绘图，而在字体加载失败静默、GD 内存溢出（大数据量图表）、或临时文件权限被 SELinux 拦截——这些比换库更值得优先排查
