基於PHP的超炫酷HTML5互動式圖表

用PHP實現專業級的基於Web的圖表，而無需深入的HTML5和JavaScript知識。

介紹

最近，我需要從一組PHP資料群組快速建立圖表。要求圖表必須是互動，方便使用的，也可下載的。在評估了一些PHP圖表的解決方案，包括phpChart、pChart和Highcharts之後，我決定採用phpChart作為我的首選工具。

背景

作為一個主要的後端程式員，我既沒有很多時間去慢慢研究使用JavaScript（客戶想要在24小時內就能在網上看到圖表），也不具備先進的前端編碼知識。從根本上說，我希望幾乎沒有任何前端編程經驗的PHP開發人員也能夠快速開發出精美的圖表。

我試過pChart，一個流行的PHP圖表庫。產生的圖表看起來挺不錯，雖然是可下載的，但圖表都是靜態映像。Highcharts似乎是最好的選 擇。圖表看上去令人驚豔，又是動畫的，並且有很多自訂選項，但同時，它也是非常複雜的，而且需要大量的JavaScript知識。 Highcharts既不是專為PHP設計的，用於商務也不是免費的。

phpChart的基本要素

我最喜歡phpChart的地方就是它能讓人從簡單和最少量的代碼入手。

phpChart精簡版可以從這裡下載http://phpchart.org/downloads/。下載檔案並解壓到網站根目錄。

設定conf.php

我們要做的第一件事是設定變數SCRIPTPATH到conf.php檔案的PhpChart類庫。該變數代表了在你的Web伺服器上的phpChart庫的相對或絕對URL。

 

  
define('SCRIPTPATH','/phpChart/'); 
 

建立最簡單的圖表

 

  
包含PHP標頭檔conf.php： 
  
require_once("../conf.php"); 
 

調用建構函式C_PhpChartX，最後調用draw()函數。

 

  
$pc=new C_PhpChartX(array(array(123, 34, 51, 22, 3)), ‘simplest_graph’); 
  
$pc->draw(); 
 

這就是開始你需要的代碼。下面是經過渲染的輸出。

這就是我所謂的最少量的編碼。當你有一個團隊的程式員來工作的時候，艱辛地去學習基礎就沒有意義了。任何程式員儘快想要做的一件事就是從一組新的庫或工具埋頭研究複雜的文檔。

順便說一句，建構函式中的第二個參數的命名對你的圖表而言應該是唯一的。我鍵入的是“simplest_graph”，也可以是任何非空白字元串。它必須是一個唯一的值，這樣你才可以在一個頁面中擁有多個圖表。

添加標題

你應該為你的圖表添加標題，以便使用者知道他們在看什麼。

 

  
$pc->set_title(array('text'=>’My Simplest Graph')); 
 

添加動畫

pChart做不到的其中一件事就是動畫。在phpChart中，動畫支援通過簡單地調用set_animate和傳遞true值即可使用。

 

  
$pc->set_animate(true); 
 

就是這樣。此時你的圖表應該已經具備了標題和動畫。完整的代碼如下：

 

  
$pc = new C_PhpChartX(array(array(123, 34, 51, 22, 3)),'simplest_graph'); 
  
$pc->set_animate(true); 
  
$pc->set_title(array('text'=>'My Simplest Graph')); 
  
$pc->draw(); 
 

代碼實質

如果你在瀏覽器中查看來源，你會發現，phpChart自動包含了許多的JavaScript以及CSS檔案，包括jquery.js、 jquery-ui，和jqplot.js、jquery-ui.css等。雖然圖表在瀏覽器中通過用戶端的JavaScript渲染，但在前端的代碼完 全是PHP。

之所以受人歡迎是因為這樣一來對於我——一個PHP開發人員而言就不再也需要擔心JavaScript了，因為phpChart會為我自動處理。下面是在查看原始碼時產生的全部JavaScript代碼——是我前面四行PHP代碼的結果。

 

  
<script language="JavaScript" type="text/javascript"> 
  
     var _simplest_graph_plot_properties; 
  
    $(document).ready(function(){ 
  
    setTimeout( function() { 
  
    _simplest_graph_plot_properties = { 
  
    "title":{ 
  
    "text":"My Simplest Graph","show":1 
  
    },"animate":true,"animateReplot":true 
  
    } 
  
 
  
    $.jqplot.config.enablePlugins = true; 
  
    $.jqplot.config.defaultHeight = 300; 
  
    $.jqplot.config.defaultWidth = 400; 
  
    _simplest_graph= $.jqplot("simplest_graph", 
  
           [[123, 34, 51, 22, 3]], _simplest_graph_plot_properties); 
  
 
  
    }, 200 ); 
  
    }); 
  
</script> 
 

正如你可能也會注意到的，“simplest_graph”被用作JavaScript變數的一部分，如 _simplest_graph_plot_properties表示jqplot對象。這就是前面我所說的命名必須唯一的原因。

此外，該PHP資料群組被自動轉換為JavaScript數組，所以以下PHP數組：

 

  
array(array(123, 34, 51, 22, 3)) 
 

成為JavaScript數組：

 

  
[[123,34,51,22,3]] 
 

改變渲染器類型

PhpChart支援實現直條圖、折線圖和堆棧圖；帶狀線圖；塊圖；泡泡圖；蠟燭圖；gecko圖；meter圖；以及其他幾種類型的圖表。渲染器支援：

• BarRenderer

• BezierCurveRenderer

• BlockRenderer

• BubbleRenderer

• CanvasAxisLabelRenderer

• CanvasAxisTickRenderer

• CategoryAxisRenderer

• DateAxisRenderer

• DonutRenderer

• EnhancedLegendRenderer

• FunnelRenderer

• LogAxisRenderer

• MekkoAxisRenderer

• MekkoRenderer

• MeterGaugeRenderer

• OHLCRenderer

• PyramidAxisRenderer

• PieRenderer

如果你不指定類型的話，預設圖表類型是折線圖。要更改圖表類型，需要調用set_series_default函數。例如，將上面的例子更改為餅圖

 

  
$pc->set_series_default(array('renderer'=>'plugin::PieRenderer')); 
 

請注意，我用的是phpChart企業版。 phpChart精簡版只支援折線圖。

數組和命名規範

這裡還有一些值得注意的地方。首先，phpChart函數中使用的幾乎所有參數是一個數組，不是全部，但幾乎所有的都是。只需記住這一點，就能避免 調試時的大量頭痛問題（後面我將簡要地覆蓋調試功能）。其次，渲染器在phpChart中被稱為“外掛程式”，故而你必須像這樣傳遞 “plugin::PieRenderer”，中間雙冒號。對於自訂JavaScript中，用 “js::yourJavascriptFunctioName”。

進階phpChart：自訂JavaScript

到目前為止，所有我展示的都是PHP。在大多數情況下，對於簡單的PHP函數調用，phpChart完全能做得很好。為了充分利用 phpChart，你或許會想要使用自訂JavaScript。例如，你可以用phpChart從JavaScript函數和外部源載入資料。

下面的sineRenderer是一個自訂JavaScript函數，用於定義從一組隨機數顯示正弦值。然後傳遞給set_data_renderer函數。

PHP：

 

  
$data1 = array(); 
  
$pc = new C_PhpChartX(array($data1),'basic_chart_4'); 
  
$pc->set_title(array('text'=>'Basic Chart with Custom JS')); 
  
$pc->set_data_renderer("js::sineRenderer"); 
  
$pc->add_plugins(array('pointLabels')); 
  
$pc->set_animate(true); 
  
$pc->draw(); 
  
 
  
JavaScript： 
  
 
  
sineRenderer = function() { 
  
    var data = [[]]; 
  
    for (var i=0; i<13; i+=0.5) { 
  
      data[0].push([i, Math.sin(i)]); 
  
    } 
  
    return data; 
  
  }; 
 

想要知道set_data_renderer函數的更多內容可點擊這裡：http://phpchart.org/phpChart/docs/output/C_PhpChartX_set_data_renderer@.html

匯出圖表到圖片

剛開始的時候，對此我很困擾，因為我不知道如何匯出圖表。事實證明，phpChart圖表可以匯出為可下載的圖片，但這個過程並沒有很好的記錄下來。我發現添加以下代碼到所有頁面的底部，就可以扭轉乾坤：

 

  
<script type="text/javascript" 
  
  src="http://www.codeproject.com/phpChart/js/showjs.js"></script> 
 

下載showjs.js：http://phpchart.org/phpChart/js/showjs.js

調試phpChart

最後，在結束之前，我要提一提phpChart的一個非常寶貴的特點。那就是它的內建調試功能。在其網站上，所有的線上例子（http://phpchart.org/examples/）都有調試可以啟用生動的示範和兩個清晰的可方便移植下面代碼的選項卡——分別是JavaScript和PHP。

要啟用調試，只需添加以下程式碼到conf.php檔案：

 

  
define('DEBUG', true); 
 

最後的思考

PhpChart的一個主要好處是，通過使用這個工具，PHP程式員可以實現專業級的基於Web的圖表——而無需深入瞭解HTML5和JavaScript知識。

如果你像我一樣，也是前端編程的門外漢，但同樣需要產生互動Web圖表，那麼你或許會喜歡phpChart。關於phpChart的HTML5圖表例子已經完整地羅列到以下這個頁面中。運氣好的話，你也許並不需要文檔——就可以直接理解代碼。