JpGraph是PHP經典圖表庫,功能強大但配置繁瑣。本文提供基於JpGraph 3.x的柱狀圖完整實現,重點解決中文亂碼、坐標軸標籤傾斜、數值顯示、邊距調整等實戰問題。
vendor/jpgraph)。gd擴展(php -m | grep gd)。SimSun.ttc、Microsoft YaHei.ttf),放入jpgraph/fonts/並配置MBTTF_DIR。<?php
require_once 'vendor/jpgraph/src/jpgraph.php';
require_once 'vendor/jpgraph/src/jpgraph_bar.php';
// 模擬數據
$userIds = ['U001', 'U002', 'U003', 'U004', 'U005'];
$userNames = ['張三', '李四', '王五', '趙六', '錢七'];
$orderCounts = [120, 85, 210, 60, 95];
// 1. 創建圖表畫布
$graph = new Graph(900, 600, 'auto');
$graph->SetScale('textlin'); // X軸文本,Y軸線性
$graph->SetMargin(60, 40, 50, 80); // 左、右、上、下邊距(留空間給標籤)
$graph->SetShadow(); // 陰影效果
// 2. X軸設置
$graph->xaxis->SetTickLabels($userNames);
$graph->xaxis->SetFont(FF_CHINESE, FS_NORMAL, 11); // 中文字體
$graph->xaxis->SetLabelAngle(45); // 標籤傾斜45度防重疊
$graph->xaxis->SetTitleMargin(20);
$graph->xaxis->title->Set('用戶姓名');
$graph->xaxis->title->SetFont(FF_CHINESE, FS_BOLD, 12);
// 3. Y軸設置
$graph->yaxis->scale->SetGrace(20); // 頂部留白20%
$graph->yaxis->SetTitleMargin(40);
$graph->yaxis->title->Set('訂單數量');
$graph->yaxis->title->SetFont(FF_CHINESE, FS_BOLD, 12);
// 4. 柱狀圖數據
$barPlot = new BarPlot($orderCounts);
$barPlot->SetFillColor('#FF8C00'); // 橙色填充
$barPlot->SetWidth(0.6); // 柱寬比例
$barPlot->value->Show(true); // 顯示數值
$barPlot->value->SetFont(FF_CHINESE, FS_BOLD, 10);
$barPlot->value->SetFormat('%d'); // 整數格式
$barPlot->value->SetAngle(90); // 數值垂直顯示
$barPlot->SetLegend('訂單量'); // 圖例
$graph->Add($barPlot);
// 5. 標題
$graph->title->Set('用戶訂單統計報表');
$graph->title->SetFont(FF_CHINESE, FS_BOLD, 16);
$graph->title->SetMargin(10);
// 6. 輸出
$graph->Stroke();
// jpgraph/src/jpg-config.inc.php 或運行前設置
define('MBTTF_DIR', realpath(__DIR__ . '/vendor/jpgraph/fonts/') . '/');
// 字體文件命名需符合規範:simkai.ttf → FF_KAI, msyh.ttf → FF_CHINESE
// 或手動註冊
$graph->xaxis->SetFont(FF_CHINESE, FS_NORMAL, 11);
| 現象 | 原因 | 解決 |
|---|---|---|
| 中文顯示方框/亂碼 | 字體路徑錯誤、字體文件缺失、未定義FF_CHINESE | 檢查MBTTF_DIR、複製.ttf/.ttc到fonts目錄、註冊字體 |
| X軸標籤重疊 | 標籤過長/過多 | SetLabelAngle(45/90)、縮小字體、增加SetMargin底部邊距 |
| Y軸數值截斷 | 最大值頂部無留白 | scale->SetGrace(15-25) |
| 圖片空白/報錯 | GD未安裝、內存不足、輸出前有輸出 | 安裝gd、增加memory_limit、確保Stroke()前無echo |
JpGraph適合純後端生成靜態圖片報表(PDF嵌入、郵件附件、定時任務生成),掌握其配置細節能快速產出專業圖表。