ThinkPHP驗(yàn)證碼不顯示的解決方案

Meils 發(fā)布于2019-07-01 10:04 / 1548人閱讀

摘要：今天遇到一個(gè)很奇怪的，就是我寫(xiě)了一個(gè)程序本地運(yùn)行正常，但是發(fā)布到甲方的服務(wù)器上出現(xiàn)無(wú)法顯示驗(yàn)證碼的。適用于驗(yàn)證碼圖片在新窗口打開(kāi)的時(shí)候顯示了報(bào)錯(cuò)信息以及一堆亂碼的情況下，如果有報(bào)錯(cuò)信息，請(qǐng)根據(jù)報(bào)錯(cuò)信息進(jìn)行檢查驗(yàn)證碼所調(diào)用的字體是否缺失。

今天遇到一個(gè)很奇怪的BUG，就是我寫(xiě)了一個(gè)PHP程序本地運(yùn)行正常，但是發(fā)布到甲方的服務(wù)器上出現(xiàn)無(wú)法顯示驗(yàn)證碼的BUG。

具體表現(xiàn)就是chorme瀏覽器上顯示一個(gè)裂了的圖片小圖標(biāo)，右鍵點(diǎn)擊該圖片在新窗口打開(kāi)，仍然是一個(gè)裂了的小圖片，并非報(bào)錯(cuò)信息（開(kāi)啟xdebug擴(kuò)展和php報(bào)錯(cuò)的情況下），如果是這樣那么就說(shuō)明驗(yàn)證碼URL路由和業(yè)務(wù)邏輯代碼沒(méi)問(wèn)題，是生成驗(yàn)證碼的環(huán)節(jié)出問(wèn)題了，我的Debug思路是這樣的：

1.檢查GD庫(kù)是否安裝正確，Linux推薦使用yum或者apt或者pecl等方式安裝，Windows推薦使用phpStudy這個(gè)集成環(huán)境，他集成好了常用擴(kuò)展，只需鼠標(biāo)右鍵開(kāi)啟即可。（適用于驗(yàn)證碼圖片在新窗口打開(kāi)的時(shí)候顯示了報(bào)錯(cuò)信息以及一堆亂碼的情況下，如果有報(bào)錯(cuò)信息，請(qǐng)根據(jù)報(bào)錯(cuò)信息進(jìn)行debug）

2.檢查驗(yàn)證碼所調(diào)用的字體是否缺失。有部分驗(yàn)證碼組件調(diào)用的字體在目標(biāo)計(jì)算機(jī)上并未安裝，這個(gè)需要分析驗(yàn)證碼模塊的源碼觀察。我用的是ThinkPHP官方的think-captcha，在vendortopthinkthink-captchasrc可以找到他的源碼，在vendortopthinkthink-captchaassets這里可以看到這款驗(yàn)證碼插件是自帶了字體的，所以ThinkPHP的驗(yàn)證碼基本上可以不用考慮字體問(wèn)題，如果是別的驗(yàn)證碼插件，那么還是要檢查一下這個(gè)地方的。

3.把有bug的驗(yàn)證碼圖片下載下來(lái)，以及本地測(cè)試正常的驗(yàn)證碼圖片下載下來(lái)，使用記事本查看并且對(duì)比。

上圖是本地環(huán)境的驗(yàn)證碼圖片的記事本，我們使用更專業(yè)的16進(jìn)制編輯器來(lái)分析一下文件差別。

如圖所示，我們發(fā)現(xiàn)bad這個(gè)壞文件除了前面多了EF BB BF等數(shù)字以外，其他內(nèi)容一模一樣，說(shuō)明是PHP在渲染圖片的時(shí)候多渲染了這些文字，至于原因我猜測(cè)可能是服務(wù)器上沒(méi)有專業(yè)的代碼編輯器，因此運(yùn)維人員使用普通的Windows記事本修改了php代碼導(dǎo)致多了這個(gè)BOM頭部。

如果是第三種原因，解決方法有兩個(gè)，一個(gè)是在驗(yàn)證碼的imagepng輸出圖片代碼調(diào)用之前用ob_clean清除php的輸出緩沖區(qū)。還有就是使用一些工具批量對(duì)代碼的bom進(jìn)行去除。

我這里使用的是ob_clean，在think-captcha的主文件Captcha.php的第203行之前加上ob_clean()，這樣一勞永逸。如果對(duì)性能和穩(wěn)定性有嚴(yán)苛要求，建議還是用工具批量去除bom比較保險(xiǎn)。同時(shí)也建議大家隨時(shí)在服務(wù)器上裝一個(gè)editplus等專業(yè)的代碼編輯器。不要用Windows的記事本修改代碼。