PHPlot 繪圖庫入門：從資料陣列到專業統計圖表

簡介

PHPlot 是純 PHP 實現的繪圖庫，基於 GD 擴展，支援長條圖、折線圖、圓餅圖、面積圖、散點圖等。無需外部程式，部署簡單，適合動態生成報表圖片。

安裝

1. 下載：https://sourceforge.net/projects/phplot/ 或本站鏡像。
2. 解壓，將 phplot.php 放入專案目錄。
3. 確認 PHP 啟用 GD（phpinfo() 檢查）。

核心配置流程

<?php
require_once 'phplot.php';

// 1. 建立畫布 (寬, 高)
$plot = new PHPlot(600, 400);

// 2. 設定字型（支援 TTF 中文）
$plot->SetDefaultTTFont(__DIR__ . '/fonts/msjh.ttc'); // 微軟正黑體

// 3. 設定標題
$plot->SetTitle('客戶滿意度趨勢');

// 4. 選擇資料類型
// 'text-data'：X 軸為標籤，每筆資料 [label, y1, y2, ...]
// 'data-data'：X 軸為數值，每筆 [label, x, y1, y2, ...]
$plot->SetDataType('text-data');

// 5. 喂入資料
$data = [
    ['2018', 65, 30, 40],
    ['2019', 70, 25, 50],
    ['2020', 75, 20, 65],
    ['2021', 78, 15, 80],
    ['2022', 80, 10, 90],
];
$plot->SetDataValues($data);

// 6. 選擇圖表類型
$plot->SetPlotType('bars'); // 'lines', 'linepoints', 'pie', 'points', 'area'

// 7. 微調外觀（選用）
$plot->SetBackgroundColor('#ffffcc');
$plot->SetPlotBgColor('#ffffff');
$plot->SetDrawPlotAreaBackground(true);
$plot->SetPlotBorderType('full');
$plot->SetLegend(['功能數', 'Bug數', '滿意用戶']);
$plot->SetLegendWorld(0.5, 95); // 圖例位置（世界座標）
$plot->SetXDataLabelPos('plotdown'); // X 標籤位置
$plot->SetXTickPos('none');          // 隱藏 X 刻度線
$plot->SetYTickLabelPos('both');     // Y 軸兩側顯示標籤

// 8. 輸出圖片
$plot->DrawGraph();

常用設定方法分類速查

輸出格式與直接輸出瀏覽器

// 預設 PNG，可改 JPEG/GIF
$plot->SetFileFormat('png'); // 需 GD 支援

// 直接輸出（已在 DrawGraph 內處理 header）
// 若需存檔：
$plot->SetPrintImage(false); // 關閉直接輸出
$plot->DrawGraph();
$img = $plot->GetImage(); // 取得 GD 資源
imagepng($img, 'chart.png');
imagedestroy($img);

中文顯示關鍵

1. 確保 SetDefaultTTFont() 指向完整路徑的 .ttf/.ttc 字型檔。
2. PHP 腳本檔案儲存為 UTF-8 無 BOM。
3. 資料陣列中的中文標籤直接寫入即可。

效能與限制

• 純 PHP 繪圖，資料點超過 500 會明顯變慢；大數據集建議改用 pChart、Chart.js（前端渲染）或 Image_Graph（PEAR）。
• 不支援 3D 效果、動畫、互動。
• 記憶體用量與畫布大小成正比（600×400 約 1MB）。

總結

PHPlot 以零依賴、純 PHP、API 直覺著稱，適合中小型專案快速生成靜態統計圖。掌握 SetDataType、SetPlotType、SetDataValues 三大核心，配合 TTF 字型即可產出專業中文圖表。