萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP JpGraph繪製柱狀圖報表:中文顯示、數據綁定、樣式定制完整教程

JpGraph是PHP經典圖表庫,功能強大但配置繁瑣。本文提供基於JpGraph 3.x的柱狀圖完整實現,重點解決中文亂碼、坐標軸標籤傾斜、數值顯示、邊距調整等實戰問題。

環境準備

  1. 下載JpGraph 3.x解壓至項目目錄(如vendor/jpgraph)。
  2. 確保PHP安裝gd擴展(php -m | grep gd)。
  3. 準備中文字體(如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

現代替代方案

  • Chart.js / ECharts:前端渲染,交互豐富,後端僅輸出JSON。
  • PHPChart / Laravel Chart:封裝Chart.js的PHP包。
  • Image_GraphViz:Graphviz繪圖,適合關係圖。

JpGraph適合純後端生成靜態圖片報表(PDF嵌入、郵件附件、定時任務生成),掌握其配置細節能快速產出專業圖表。

copyright © 萬盛學電腦網 all rights reserved