PHPXref的主要功能包括
1.檔案管理。無論要找什麼檔案,用它能很快地搜尋到,如果你的檔案中有符合文法規則的注釋,PHPXref還能將它列在檔案名稱的旁邊,更容易瞭解這個檔案的功能用途,也不用為了找一個檔案翻遍整個檔案夾,開啟每個檔案尋找注釋了。
2.函數、變數、常量、類管理。Wordpress內建了多種功能強大的函數、類,無論是字元處理還是遠程URL讀取等都有現成的函數,但我們往往不知道這個函數能在Wordpress裡面找到,現在容易多了,搜尋一下就找到了,如果在開發過程中遇到某個Wordpress函數,不知道它是幹什麼用的,這時候就得找到這個函數在哪裡定義的,可是Wordpress裡面上百個檔案上哪找去?還是用PHPXref好了。
3.檔案包含管理。Wordpress中需要很多 include,require包含別的檔案,但偶爾也會遇到重複包含導致出錯,雖然require_once可以解決,但我們也最好要瞭解某個指令碼包含了哪些檔案,要調用這個檔案時也心中有數。PHPXref提供了每個檔案的包含檔案清單和被包含的檔案。
4.原始碼高亮。這個功能也是比較實用的,但在實際測試中偶爾會出錯。
5.出色的關聯功能。在瀏覽原始碼時,將滑鼠指到某個函數名,就會在滑鼠旁邊出現函數的定義頁面,以及被使用次數,此外,還對使用較多的變數名,也是可以直接有個頁面顯示所有的關於這個變數的使用方式。
既然PHPxref那麼強大,該如何使用呢?
1.首先,從SF下載最新的程式,現在的版本是0.7,下載那個win32的版本就好了。下載後解壓出來。
2.phpxref目錄下有一個 source 的檔案夾,這是存放原始碼的檔案夾,把另外下載的Wordpress原始碼放到這裡來,請注意,不要把 wordpress/這整個目錄放進來,而是裡面的檔案放進來就行了,確保以 source/index.php,source/wp-content/ ..這樣的格式就行。
3.運行可執行檔phpxref.exe ,將進行產生文檔的工作,這個過程大約需要1分鐘左右,由於需要高頻率讀取硬碟和大量計算消耗CPU資源,請暫停其他工作。
4.提示成功後,output 這個目錄下就是所有的文檔了,建議在本地上用XAMPP進行調試,把整個output 檔案夾搬到 xampp的 htdocs 的目錄下,再把名字改為好記的 phpxref ,這樣,就可以通過 http://localhost/phpxref/ 訪問了。效果和 http://phpxref.com/xref/wordpress/ 的是一模一樣,當然,速度快了很多。
PHPXref還提供了在Linux下產生文檔的版本,但我很少用Ubuntu,也沒有去Ubuntu下測試了,我想更多數人需要的還是Win系統下的,如果有需要,把Win下產生的文檔可以搬到伺服器上去供大家訪問,還可以在頁面下面放點Google Adsense廣告賺點外快。但PHPxref產生的文檔實在太大了,一個1.2MB的Wordpress(壓縮包),解壓後再產生文檔,居然要80多 MB的位置!壓縮完後也需要接近20MB,所以我打消了把它放在自己伺服器上的願望(說不定製作重複的鏡像還會被搜尋引擎處罰)。
除了用PHPXref來產生已有的Wordpress或其他PHP示範程式(如Discuz)進行學習外,用PHPXref來產生自己製作的PHP 程式,進行檢驗錯誤或者是整理代碼資源也很有用。我從學PHP至今大概寫過5個比較大型的程式(我認為算比較大型了,但沒有一個是成型的商業產品),幾乎也是寫了5次的郵件地址驗證函式,使用者名稱驗證函式,密碼驗證函數,MySQL類…看來還得用PHPXref來整理資源了。
PHPXref官方有個已經製作好的Wordpress的分析文檔:http://phpxref.com/xref/wordpress/,此外,PHPXref還製作了多種PHP程式的分析文檔,有興趣的可以Google站內搜尋一下。