PHP 統計圖表庫 JPGraph 入門：安裝、配置與繪圖範例

JPGraph：PHP 伺服端圖表生成的經典選擇

JPGraph 是一套純 PHP 實現的物件導向圖表庫，支援長條圖、圓餅圖、折線圖、甘特圖、雷達圖等十多種圖表類型，輸出格式包含 PNG、JPEG、GIF。無需外部執行檔，僅需 GD 擴展即可運作，適合動態報表、儀表板、統計分析系統。

安裝與配置重點

1. 下載：官網 jpgraph.net/download/，依 PHP 版本選擇對應套件（v4.x 需 PHP 7.1+）。
2. 解壓：將 src/ 目錄下的 jpgraph/ 資料夾放入專案可存取路徑（如 /vendor/jpgraph/）。
3. 權限：確保 cache/ 目錄可寫入（用於快取圖片提升效能）。
4. 字體：jpg-config.inc.php 中設定 TTF_DIR 指向系統字體目錄（如 /usr/share/fonts/），以支援中文顯示。
5. 編碼：專案檔案必須為 UTF-8，避免中文亂碼。

最簡折線圖範例

<?php
require_once 'vendor/jpgraph/jpgraph.php';
require_once 'vendor/jpgraph/jpgraph_line.php';

$data = [12, 19, 3, 5, 2, 3, 7, 8, 9, 10]; // Y 軸資料

$graph = new Graph(400, 300);
$graph->SetScale('textlin');           // X 軸文字、Y 軸線性
$graph->SetMargin(40, 40, 30, 40);     // 左、右、上、下邊距
$graph->title->Set('月度銷售趨勢');
$graph->title->SetFont(FF_FONT1, FS_BOLD, 14);
$graph->xaxis->SetFont(FF_FONT1, FS_NORMAL, 10);
$graph->yaxis->SetFont(FF_FONT1, FS_NORMAL, 10);

$line = new LinePlot($data);
$line->SetColor('blue');
$line->SetWeight(2);
$line->SetLegend('2024 年');
$graph->Add($line);

$graph->Stroke(); // 輸出圖片至瀏覽器
?>

常見圖表類型對應類別

效能與快取建議

• 啟用 $graph->SetCacheDir('/tmp/jpgraph_cache/') 並設定 $graph->SetCacheTime(3600)，避免重複運算。
• 大量資料點（>1000）建議改用 jpgraph_scatter.php 散佈圖或前端 Chart.js/Highcharts 分擔渲染。
• 中文標題、軸標籤務必使用 TTF 字體（SetFont(FF_SIMSUN, ...)），並確認字體檔存在。