Piwik網站統計平臺

Piwik網站統計平臺是一套基于PHP5+MySQL技術構建的開源網站訪問統計系統，前身是phpMyVisites。Piwik可以給你詳細的統計信息，比如網頁瀏覽人數，訪問最多的頁面，搜索引擎關鍵詞等等流量分析功能。此外，它還采用了插件擴展及開放API架構，可以讓用戶根據 自已的實際需求創建更多的功能。

軟件說明

最近為了給自己的web系統添加一個運營數據分析和展示的功能，本打算自己純手工打造，但是發現成本太高，時間和精力方面不允許。在網上查閱了一些資料，發現目前有許多開源的web數據分析系統，所以拿來主意，決定找一個合適的開源web分析工具。最終選擇了piwik，理由如下：

Piwik采用LAMP開發，我的系統也是，所以可以復用運營環境。

Piwik的架構設計比較通用，可以開發插件進行擴展。

Piwik的數據顯示比較強大，至少看上去如此。例如有曲線圖，直方圖，餅圖，標簽云等等。插件可以通過拖拽的方式任意布置。

開源，免費，并且有相對完整的文檔。

經過了一段時間的摸索，我終于將開發插件的流程梳理清楚了，記錄于此，作為備忘。目前使用的Piwik是當前最新版本，這點很重要。Piwik的部分接口不向前兼容，以至于很多基于早期版本開發的插件在當前版本無法使用。本文的主要內容如下：

Piwik工作原理

安裝部署Piwik

安裝Piwik插件

Piwik插件結構

Hello World，你懂的！

Piwik模版

Piwik圖形視圖

待了解的地方 ……

工作原理

Piwik是一個web系統，主要用于web運營分析。它會部署在你自己的apache和mysql中，這樣運營數據都在你自己的服務器里！安裝好Piwik后，它會提供一段js代碼，你只需要將這些代碼嵌入到你web中的每個網頁中（如果你的系統是用模版開發的，具有相同的footer模版，那么這里最適合放入這段代碼），那么每當這些網頁被訪問時，這些數據就會傳回給Piwik服務器。這里會有個問題，由于數據收集代碼放在html中，那么異步請求無法被統計到，因為這些請求不會返回完整的頁面，而是部分頁面或數據。不要緊，piwik提供web日志分析的功能（具體配置見這里），這樣就可以統計出所有的訪問數據。

使用說明

安裝部署Piwik

安裝Piwik的確很簡單：下載開發包，解壓到apahce服務器web根目錄，配置piwik。Piwik在第一次訪問時，提供了一個非常簡介的安裝向導，指導你一步一步的配置好piwik，具體步驟見這里。

安裝Piwik插件

插件的安裝也很簡單，只需要將插件拷貝到piwik_src/plugins目錄下面，然后去piwik配置頁面啟用插件。具體步驟，參見這里。

Piwik插件結構

Piwik源代碼目錄下的plugins目錄中是Piwik官方插件，其實官方插件是最好的學習參考。要創建你自己的第一個插件，首先需要給插件取一個響亮的名稱，這里就姑且稱之為“BourneliPlugin”吧！然后創建目錄piwik_src/plugins/BourneliPlugin。接下來，需要在此目錄下，創建兩個比較重要的文件：

BourneliPlugin.php：定義插件的基本信息、插件的位置

Controller.php：插件的CGI方法，可以理解為Web MVC模式中的Controller，Piwik框架會將插件相關的Url映射到Controller.php中的方法。

Hello World，你懂的！

按照上面的目錄結構，你的第一個插件的基本骨架就搭建成功了，現在我們來寫點什么，實現我們的第一個“Hello World”吧。先看看BourneliPlugin.php代碼，如下：

上面的代碼主要定義的插件的基本信息和插件掛接的位置，需要注意一下幾點：

類的名稱必須是Piwik_BourneliPlugin并且繼承類Piwik_Plugin。聰明的你可能已經發現類名的規律：Piwik_<YourPluginName>（大小寫不敏感）。確實，<YourPluginName>代表插件目錄和插件文件的名稱。如果不按照這個約定，piwik是無法找到插件。

需要實現getInformation函數，此函數返回插件描述信息，方便在Piwik的插件管理器中找到我們的插件。

實現postLoad方法，在此方法中掛接插件。此方法有四個參數，分別是，widgetCategory，widgetName，ControllerName和ControllerAction，前面兩個主要是顯示作用，用于在主界面的widget管理器中找到你的插件。第三個方法是控制器方法，對應Controller.php中的類，第四個參數是第三個參數對應類中的具體方法，用于響應用戶的請求。

接下來看看Controller.php中的代碼：

對，你沒有看錯，Controller.php中的代碼就是這么簡單！需要注意一下幾點

類的名稱遵循這個規律：Piwik_<YourPluginName>_Controller，否則Piwik_AddWidget的第三個參數無法找到對應類。

類繼承Piwik_Controller類

helloWorld方法對應Piwik_AddWidget函數的第四個參數，輸出將直接顯示在widget的面板中。

OK，寫完了代碼，現在可以將BourneliPlugin整個目錄拷貝到piwik_src/plugins目錄下，看看效果了。

首先，進入插件管理頁面，如下圖：

對應導航：setting à Plugings à BourneliPlugin?？梢钥吹絛escription這一欄中顯示的文本就是在getInformation函數中對應的字段輸出的信息。點擊最右邊的“Active”，啟用插件（否則不會出現在widget面板中）。

接下來，去widget面板中打開我們的“hello world”插件。如下圖：

可以看到Piwik_AddWidget函數中的第一個和第二個參數出現在哪里？最后點擊“hello world”,可以到我們的插件出現在Dashboard中，如下圖：

Piwik模版

使用PHP開發web，一般都會使用模版機制，這樣可以將view和model分開。Piwik也提供模版功能，Piwik沒有自己造車，而是直接使用了smarty模版庫，所以使用過smarty的同學一定不會陌生。即時沒有使用過，smarty的官方文檔比較完備，可以網上搜索查閱。接下來演示一個例子，看看如何在插件中使用模版。首先，在BournliPlugin目錄下添加一個templates目錄，并且在templates目錄中添加文件myTpl.tpl，內容如下：

（寫這篇文章的時候天氣真的很糟?。?/p>

然后在Controller.php中添加下面的代碼（前面例子中出現的代碼備省略了）：

添加的函數是一個新的插件函數，用于模版調用，可以看到第一行使用Piwik的視圖工廠，加載一個視圖對象，并將此對象與模版綁定。然后直接將字符串“okkkkkkkkkkkkkk”賦值給模版中的變量myString，最后渲染并輸出。

還沒完，雖然寫了這個函數，但是沒有將其掛接到Piwik的widget面板中（即時不掛接面板，也可以訪問，有興趣的讀者可以通過抓包看看如何訪問），在BourneliPlugin.php中添加下面的代碼：

為了突出重點，前面相同的代碼已經省略。我們來看看效果，如下：

Piwik圖形視圖

Piwik內置了一些圖形視圖，比如趨勢圖，直方圖，餅圖，云圖等。并且提供了十分簡單的API供我們調用，我們所做的只是提供數據。先來看看幾種圖形：

感覺是不是很拉風！使用上面的功能很簡單，可以通過Piwik_src/plugins/ExampleUI這個插件來了解具體的使用，此插件專門用作demo。我在這里簡要說名一下步驟：

首先在BourneliPlugin目錄下創建名為API.php的文件，在此文件中創建名為Piwik_BourneliPlugin_API的類，命名規則為Piwik_YourPluginName_API。需要注意，此類必須實現單一模式。

Piwik_BourneliPlugin_API中的方法主要是用于獲取數據并將你的數據填充到名為Piwik_DataTable的容器中，該類是Piwik自定義類，用于統一數據格式。

最后在Controller中的CGI方法中將對應視圖與API中的數據提供方法鏈接起來，就可以完成數據展示了。

這里提供實驗的完整例子，讀者也可以查看Piwik官方提供的ExampleUI這個例子中的源代碼，相信會更好，因為本人也是參照這個例子完成實驗的。同時，不要忘記直接查看Piwik的源代碼，這樣會更直接。