****************************************************
Joomla! Debug雜記(1)
*Joom!Fish
--written by Dandy
*****************************************************
1.前言
這份筆記是用來記錄Joomla!這套優秀的Opensource CMS除錯過程,為了防止個人偶發性失憶而寫,筆者不負責任何修正及教學.

2.環境
PHP 架設在: Linux 2.6.18-8.el5xen #1 SMP Fri Jan 26 14:42:21 EST 2007 i686
資料庫版本: 5.0.82sp1
資料庫校對: utf8_general_ci
PHP 版本: 5.2.9
網站伺服器: Apache/2.2.3 (Red Hat)
網站伺服器的PHP 介面: apache2handler
Joomla! 版本: Joomla! 1.5.14 Stable [ Wojmamni Ama Naiki ] 30-July-2009 23:00 GMT
用戶代理: Mozilla/5.0 (Windows; U; Windows NT 5.1; zh-TW; rv:1.9.1.4) Gecko/20091016 Firefox/3.5.4
安裝Joom!Fish 2.0.4+JoomFish_2.0.3_zh-TW.zip

3.Joomla!的設計理念很明確,整體系統除了核心(Core)外,分成五個部份構成,可以在安裝後的Extensions(擴充包)看到:
(1)元件(Components)
(2)模組(Module)
(3)外掛(Plugin)
(4)樣版(Templete)
(5)語言(Language)

在核心套件及所附的元件及模組,外掛,樣版上當然release之前有經過開發團隊的重重測試,所以不大容易發現bug,但後面自行安裝的語言包及其他元件就容易出現一些小bug,大多數的bug不會顯示出來,僅會造成組合語法不佳,效能低落等情況,因此我們必須開啟(全域設定)/(系統)的除錯設定
[attachment=4:30nckx8f]<!-- ia4 -->Snap15.jpg<!-- ia4 -->[/attachment:30nckx8f]

開啟後可見到最底下的debug頁面,分成幾個部份:
•概略資訊•
•記憶體使用率•
•資料庫查詢記錄•
•已載入語言檔案•
•除錯時期未翻譯字串•
•設計時期未翻譯字串•

一般由逗點•xx•組合起來的字串是可套用語言包的字串,由於使用變數不同,所以也有可能是'?xx?'
[attachment=3:30nckx8f]<!-- ia3 -->Snap2_調整大小.jpg<!-- ia3 -->[/attachment:30nckx8f]
一開始就抓到2條問題,由於Joomla!的檔案分成前台(site)跟後台(admin),所以我們在後台除錯的頁面,大部份是administrator目錄裡面的code,
切回英文介面,沒有抓到錯誤,所以判定是中文語言包有兩條沒翻到,找到上面寫的plg_system_debug::OnAfterRender(),表示在plg_system_debug.ini的OnAfterRender()時出錯,
所以找到zh-TW.plg_system_debug.ini,補上
UNTRANSLATED STRINGS DESIGNER=設計時期未翻譯字串
UNTRANSLATED STRINGS DIAGNOSTIC=除錯時期未翻譯字串
Refresh後正常,繼續檢查其他後面安裝的東西,這篇主要是JoomFish的除錯,所以開始檢查Fish,
元件/JoomFish/控制台
[attachment=2:30nckx8f]<!-- ia2 -->Snap3_調整大小.jpg<!-- ia2 -->[/attachment:30nckx8f]
這邊出現的錯誤比較多,而且中英文都錯,表示其原本的英文語言包就出錯,補上這幾條在administrator\language\en-GB\en-GB.com_joomfish.ini,因為中文語言包大多依照英文翻譯,當然在administrator\language\en-GB\zh-TW.com_joomfish.ini也要改:
BEST AVAILABLE= BEST AVAILABLE
MYSQL DRIVER=MYSQL DRIVER
PERFORMANCE INFORMATION=PERFORMANCE INFORMATION
TRANSLATION CACHING=TRANSLATION CACHING
TRANSLATION VISIBLE=Translation visible
MODULE CLASS SUFFIX=Module Class Suffix
NO CACHING=No caching
PARAMMODULECLASSSUFFIX=PARAMMODULECLASSSUFFIX
SELECT WHETHER TO CACHE THE CONTENT OF THIS MODULE=Select whether to cache the content of this module
THE TIME BEFORE THE MODULE IS RECACHED=The time before the module is recached
NO_PREVIEW=NO PREVIEW

到此慢慢有個除錯的方向,一般coding由上到下,debug由下到上,由錯誤訊息反推回去,上面default.php跟view.php有呼叫到語言包的部份,找不到才出錯.

[attachment=1:30nckx8f]<!-- ia1 -->Snap7_調整大小.jpg<!-- ia1 -->[/attachment:30nckx8f]
切到元件/JoomFish/翻譯,這邊錯的更多,有7條,都是同樣的原因,切回英文一樣,語言包檢查過也沒問題,看來不是語言包,再往語言包的應用來找,
對照一下,應該是這7個標題呼叫函數出錯,
[attachment=0:30nckx8f]<!-- ia0 -->Snap10_調整大小.jpg<!-- ia0 -->[/attachment:30nckx8f]
好吧,檔案只能附5個,待續...