PHP函数imagefttext( )因--enable-gd-jis-conv引发中文乱码解决方案

阐述

最近几天与公司的PHP开发人员测试即将上线的WEB站点（致难忘的青春岁月：http://hd.gfan.com），在内网测试环境没有任何问题，但在线上测试时，发现通过PHP的GD函数 p_w_picpathfttext（）引用FreeType字体将文本信息写入图像时，出现中文乱码；对此问题，我们在整个排查过程中，总结了三个能引起中文乱码的原因，如下：

1、Linux系统字符集是否支持中文？

root@exiuxiu-web1:~#locale
LANG=en_US.UTF-8
LANGUAGE=en_US.UTF-8
LC_CTYPE="en_US.UTF-8"
 
root@exiuxiu-web1:~#echo $LANG
en_US.UTF-8

##提示

在Linux系统中，支持中文的字符集有Unicode、GB1232、UTF-8、GBK、GB18030，通过命令locale，echo $LANG可以查询系统默认使用的字符集是否支持中文，如果你的系统默认字符集不支持中文，请浏览扩展阅读，了解相关中文字符集的信息，在根据你架构的实际需求选择字符集。

扩展阅读：

http://zh.wikipedia.org/wiki/GB18030

http://zh.wikipedia.org/wiki/GB2312

http://zh.wikipedia.org/wiki/UTF8

http://zh.wikipedia.org/wiki/GBK

http://zh.wikipedia.org/wiki/Unicode

2、Linux是否支持Windows字体（黑体、宋体）？

在测试之前，整个WEB站点的PHP代码是通过SVN更新至线上的服务器，其中有一点需要说明的是，在使用PHP的GD函数p_w_picpathfttext（）将文本写入图片时，引用了Windows端的字体库（simhei.ttf黑体、simsun.ttc宋体、simfang.ttf仿宋），所以我们怀疑是否因为Linux系统不支持Windows系统的字体而引起的，为此在Linux系统下添加了Windows系统的字体库，不幸的是问题并没有解决；引用Linux字体库也是如此；

##扩展阅读：

如何向Linux添加Windows字体

http://www.cnblogs.com/hiflex/archive/2012/08/12/2634532.htmlhttp://os.51cto.com/art/201402/429516.htm

3、是否由PHP编译参数引发中文乱码问题？

通过phpinfo（）函数输出测试环境与线上环境的PHP编译参数，相互对比发现线上环境比测试环境多了个--enable-gd-jis-conv参数，对此，我们在PHP官方文档中查的如下信息：

*虽然 p_w_picpathttftext()文档标明只接受UTF-8编码，但如果PHP编译时启用–enable-gd-jis-conv选项的话，那么非ASCII字符(例如汉字、拼音、希腊文和箭头) 会被当成EUC-JP编码(phpinfo中美其名曰“支持JIS编码的字体”), 从而导致乱码(由于西文字体没有假名或汉字，一般表现为全部是方框)。

Although p_w_picpathttftext()documentation indicates it only accepts UTF-8 encoding, but if–enable-gd-jis-conv is specified when compiling PHP, then non-ASCII characters(like Chinese, accented characters, Greek and arrows) will be (mis-)treated asEUC-JP encoding (referred to as “JIS-mapped Japanese Font Support” in phpinfo)leading to mojibake (this usually shows up as hollow rectangles, as most fontsfor western text lacks glyphs for kanji or kana).

3、1 启用PHP参数–enable-gd-jis-conv，测试结果如下：

Firefox浏览器附加web调试工具firebug

#提示：从图中输出的结果，我们可以得知服务器端是支持中文字符集,问题发生在GD函数p_w_picpathfttext()将文本信息写入图片时，发生了乱码的情况，附加测试图片如下：

3、2 禁用PHP参数–enable-gd-jis-conv，测试结果如下：

我想说，调试bug是一个非常细心，讲究团队协作的事情，首先，我们先不管问题是不是由开发人员、运维人员造成的，但是你需要明白的是两个部门它是一个团队，彼此间需要相互协作，争取在最短的时间内解决问题，因为在没有得到最终的结论之前，我们都无法确定问题是谁导致的，该由谁去负责，希望这篇文档能帮助到大家；

扩展阅读：

http://nekotoba.nfshost.com/b/2011/04/267/a-workaround-for-p_w_picpathttftext-garbage-chracters-due-to-enable-gd-jis-conv