搞定ThinkPHP驗證碼不顯示的問題

下面由thinkphp框架教學欄位來介紹ThinkPHP驗證碼不顯示的解決方案，希望對需要的朋友有幫助！

今天遇到一個很奇怪的BUG，就是我寫了一個PHP程式本地運作正常，但是發佈到甲方的伺服器上出現無法顯示驗證碼的BUG 。

具體表現就是chorme瀏覽器上顯示一個裂了的圖片小圖標，右鍵點擊該圖片在新視窗打開，仍然是一個裂了的小圖片，並非報錯資訊（開啟xdebug擴充和php報錯的情況下），如果是這樣那麼就說明驗證碼URL路由和業務邏輯碼沒問題，是產生驗證碼的環節出問題了，我的Debug思路是這樣的：

1.檢查GD庫是否安裝正確，Linux推薦使用yum或apt或pecl等方式安裝，Windows推薦使用phpStudy這個整合環境，他整合好了常用擴展，只需滑鼠右鍵開啟即可。 （適用於驗證碼圖片在新視窗開啟的時候顯示了報錯訊息以及一堆亂碼的情況下，如果有報錯訊息，請根據報錯訊息進行debug）

2.檢查驗證碼所呼叫的字型是否缺失。有部分驗證碼元件呼叫的字型在目標電腦上並未安裝，這個需要分析驗證碼模組的源碼觀察值。我用的是ThinkPHP官方的think-captcha，在vendortopthinkthink-captchasrc可以找到他的源碼，在vendortopthinkthink-captchaassets這裡可以看到這款驗證碼插件是自帶了字體的，所以ThinkPHP的驗證碼基本上可以不用考慮字體問題，如果是別的驗證碼插件，那麼還是要檢查一下這個地方的。

3.把有bug的驗證碼圖片下載下來，以及本地測試正常的驗證碼圖片下載下來，使用記事本查看並且比較。

上圖是本地環境的驗證碼圖片的記事本，我們使用更專業的16進位編輯器來分析一下檔案差異。

如圖所示，我們發現bad這個壞檔案除了前面多了EF BB BF等數字以外，其他內容一模一樣，說明是PHP在渲染圖片的時候多渲染了這些文字，至於原因我猜測可能是伺服器上沒有專業的程式碼編輯器，因此運維人員使用普通的Windows記事本修改了php程式碼導致多了這個BOM頭部。

如果是第三種原因，解決方法有兩個，一個是在驗證碼的imagepng輸出圖片程式碼呼叫之前用ob_clean清除php的輸出緩衝區。還有就是使用一些工具批量對程式碼的bom進行去除。

我這裡使用的是ob_clean，在think-captcha的主檔案Captcha.php的第203行之前加上ob_clean()，這樣一勞永逸。如果對性能和穩定性有嚴格要求，建議還是用工具批量去除bom比較保險。同時也建議大家隨時在伺服器上裝一個editplus等專業的程式碼編輯器。不要用Windows的記事本修改程式碼。

以上是搞定ThinkPHP驗證碼不顯示的問題的詳細內容。更多資訊請關注PHP中文網其他相關文章！