PHP jpgraph 圖表庫安裝指南與常見錯誤解決方案

PHP jpgraph 入門：從安裝到解決時區與檔案缺失錯誤

PHP 內建的 GD 庫雖然功能強大，但直接繪圖代碼繁瑣。jpgraph 作為基於 GD 的封裝庫，提供了豐富的圖表類型與簡潔的 API，是生成統計圖表的利器。本文記錄安裝流程、常見報錯及解決方案，助你快速上手。

環境準備：啟用 GD 庫

PHP 預設未啟用 GD 擴展，需修改 php.ini，取消註釋 extension=php_gd2.dll（Windows）或 extension=gd.so（Linux），並重啟 Web 服務器。

jpgraph 安裝步驟（以 v3.0.7 為例）

1. 前往 官網下載頁 獲取最新版本。
2. 解壓後，在 Examples 目錄下建立 jpgraph 資料夾。
3. 將 src 目錄中除 Examples 外的所有檔案移動至新建的 jpgraph 目錄。
4. 將整個 Examples 目錄複製到 Apache 的網站根目錄（如 htdocs 或 www）。

常見錯誤與修復

1. 時區設定警告導致圖片無法輸出

Warning: strftime(): It is not safe to rely on the system's timezone settings...
JpGraph Error: HTTP headers have already been sent.

原因：PHP 要求明確設定時區，否則 strftime() 會輸出警告，導致 HTTP 標頭提前發送，jpgraph 無法輸出圖片二進位資料。

解決：在腳本最開頭加入：

date_default_timezone_set('Asia/Chongqing'); // 或 Asia/Taipei、Asia/Shanghai 等

或在 php.ini 中設定 date.timezone = Asia/Chongqing。

2. v3.5.0b1 缺少 jpgraph_odo.php 檔案

新版本調整了檔案結構，若直接遷移舊版檔案會缺少依賴。建議：

• 優先使用穩定版（如 v3.0.7 或最新正式版）。
• 若必須用新版，請完整保留 src 目錄結構，並確認 include 路徑正確指向 src。

快速驗證安裝

瀏覽 https://your-domain/Examples/，點擊範例連結若能正常顯示圖表，即安裝成功。