NanShan 如何解决DotProject中文乱码问题

青旅半醒 2022-08-23 12:59 117阅读 0赞

原文 [NanShan 如何解决DotProject中文乱码问题][NanShan _DotProject]

DotProject 是一个非常好的项目管理软件，[NanShan 即时通讯爱好者][NanShan] 推荐使用，DotProject中文乱码解决总结

Andrew(zhuyi)

DotProject是一个基于AMP(apache+mysql+php)的开源项目管理工具，DotProject可以支持多语言并采用模块化设计以便于扩展。  
最近需要一个项目管理软件，于是就下载DotProject进行了试用，感觉不错，但有中文有乱码问题，如：日历和gantt图。现就对解决DotProject乱码进行一下总结，由于本人以前没接触过PHP，初次修改有错的地方请大家指正。  
机器环境：WindowsXP SP2简体中文,apache2.0.59, mysql-5.0.16-win32, php-5.2.0,其他版本没有测过，不能保证在其他版本下正确运行，由其在PHP4下。  
1. 加入语言包  
DotProject有比较不错的多语言包，项目叫dot modules，在sourceforge上有。DotProject的语言包目录./locales，运行可根据配置动态加载语言包进行对照转换相应的语言。下载中文语言包解压后并复制到语言目录locales下，修改语言包文件夹下locales.php文件：  
$locale\_char\_set = 'GB2312';为$locale\_char\_set = 'utf-8';  
同时把英文语言包的同名文件也进行修改。使用'utf-8'的好处就是浏览器用unicode(utf-8)解码，页面可显示多种语言文字。防照英文语言包创建lang.php文件，加入如下内容：  
  
![None.gif][]<?php  
![None.gif][]$dir=basename(dirname(\_\_FILE\_\_));  
![None.gif][]$LANGUAGES\['zh-cn'\] =array ( $dir,'Chinese (Simplified)','简体中文','chs');  
![None.gif][]?>  
  
如果繁体则：  
  
![None.gif][]<?php  
![None.gif][]$dir=basename(dirname(\_\_FILE\_\_));  
![None.gif][]$LANGUAGES\['zh-tw'\] =array ( $dir,'Chinese (Traditional)','繁體中文','cht');  
![None.gif][]?>  
同时把目录下的所有对照文件转换为utf-8编码存储(可用ultraEdit等文本编辑器转换或登录后用DotProject翻译管理进行更改)，初步汉化完成。  
2. 修正在中文下日历的乱码问题  
本地化语言后日历的星期显示为乱码，这是由于DotProject采用读取操作系统本地语言区域日期格式引起的，在windowsXP中文版默认是“星期几，xxxx-x-x”，且可能为GB2312编码（本地区域语言可以更改）。DotProject读取操作系统的日期用utf8\_encode转换后再显示，这样只要操作系统的本地区域日期语言格式和运行DotProject选取的语言不一至时就会出现乱码，显然不是聪明的做法。  
1）语言包文件夹下locales.php文件中加入日期格式对照表变量如下：  
![None.gif][]$locale\_weeks=array('星期日','星期一','星期二','星期三','星期四','星期五','星期六');  
![None.gif][]$locale\_short\_week=array('日','一','二','三','四','五','六');  
![None.gif][]$locale\_months=array(null,'一月','二月','三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月');  
![None.gif][]$locale\_short\_months=array(null,'1月','2月','3月','4月','5月','6月','7月','8月','9月','10月','11月','12月');  
2）DotProject的日期处理基类在lib/PEAR/Date下Calc.php文件中，修改或增加其中的相关几个函数。  
加入和修改如下函数：  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]//得到月全名称列表  
![None.gif][]function getMonthNames()  
![None.gif][]\{  
![None.gif][]    global$locale\_months;  
![None.gif][]  if(!empty($locale\_months))\{  
![None.gif][]    $months =$locale\_months;  
![None.gif][]  
![None.gif][] \}else\{  
![None.gif][]    for($i=1;$i<13;$i\++)\{  
![None.gif][]        $months\[$i\] =strftime('%B',mktime(0,0,0,$i,1,2001));  
![None.gif][]    \}  
![None.gif][]  \}  
![None.gif][]  return($months);  
![None.gif][]\}  
![None.gif][]  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]//得到月短名称列表      
![None.gif][]function getMonthShortNames($length=3)  
![None.gif][]\{  
![None.gif][]        global$locale\_short\_months;  
![None.gif][]   if(!empty($locale\_short\_months))\{  
![None.gif][]    $months =$locale\_short\_months;  
![None.gif][]     
![None.gif][]  \}else\{  
![None.gif][]            for($i=1;$i<13;$i\++)\{  
![None.gif][]                $months\[$i\] =strftime('%B',mktime(0,0,0,$i,1,2001));  
![None.gif][]                $months\[$i\] =substr($months\[$i,0,$length);  
![None.gif][]            \}  
![None.gif][]        \}  
![None.gif][]        return($months);  
![None.gif][]\}    
![None.gif][]  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]//得到星期全名称列表       
![None.gif][]function getWeekDays()  
![None.gif][]\{  
![None.gif][]        global$locale\_weeks;  
![None.gif][]   if(!empty($locale\_weeks))\{  
![None.gif][]    $weekdays =$locale\_weeks;  
![None.gif][]    
![None.gif][]  \}else\{  
![None.gif][]      for($i=0;$i<7;$i\++)\{  
![None.gif][]            $weekdays\[$i\] =strftime('%A',mktime(0,0,0,1,$i,2001));  
![None.gif][]            \}  
![None.gif][]        \}          
![None.gif][]        return($weekdays);  
![None.gif][]\}  
![None.gif][]  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]//得到星期短名称列表     
![None.gif][]function getShortWeekDays($length=3)  
![None.gif][]\{  
![None.gif][]        global$locale\_short\_week;  
![None.gif][]   if(!empty($locale\_short\_week))\{  
![None.gif][]    $weekdays =$locale\_short\_week;  
![None.gif][]     
![None.gif][]  \}else\{  
![None.gif][]            for($i=0;$i<7;$i\++)\{  
![None.gif][]                $weekdays\[$i\] =strftime('%A',mktime(0,0,0,1,$i,2001));  
![None.gif][]                $weekdays\[$i\] =substr($weekdays\[$i,0,$length);                 
![None.gif][]            \}  
![None.gif][]        \}  
![None.gif][]        return($weekdays);  
![None.gif][]\}  
![None.gif][]  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]//得到月全名称  
![None.gif][]function getMonthFromFullName($month)  
![None.gif][]\{  
![None.gif][]        $month=strtolower($month);  
![None.gif][]        $months= Date\_Calc::getMonthNames();  
![None.gif][]        while(list($id,$name) =each($months))\{  
![None.gif][]            if(ereg($month,strtolower($name)))\{  
![None.gif][]                return($id);  
![None.gif][]            \}  
![None.gif][]        \}  
![None.gif][]        return(0);  
![None.gif][]\}    
![None.gif][]  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]//得到月短名称   
![None.gif][]function getMonthAbbrname($month,$length=3)  
![None.gif][]\{  
![None.gif][]        $month=strtolower($month);  
![None.gif][]        $months= Date\_Calc::getMonthShortNames();  
![None.gif][]        while(list($id,$name) =each($months))\{  
![None.gif][]            if(ereg($month,strtolower($name)))\{  
![None.gif][]                return($id);  
![None.gif][]            \}  
![None.gif][]        \}  
![None.gif][]        return(0);  
![None.gif][]\} // end func getMonthAbbrname  
![None.gif][]  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]//得到星期短名称  
![None.gif][]function getWeekdayFullname($day="",$month="",$year="")  
![None.gif][]\{  
![None.gif][]        if(empty($year))  
![None.gif][]            $year= Date\_Calc::dateNow("%Y");  
![None.gif][]        if(empty($month))  
![None.gif][]            $month= Date\_Calc::dateNow("%m");  
![None.gif][]        if(empty($day))  
![None.gif][]            $day= Date\_Calc::dateNow("%d");  
![None.gif][]  
![None.gif][]        $weekday\_names= Date\_Calc::getWeekDays();  
![None.gif][]        $weekday= Date\_Calc::dayOfWeek($day,$month,$year);  
![None.gif][]  
![None.gif][]        return$weekday\_names\[$weekday\];  
![None.gif][]  
![None.gif][]\} // end func getWeekdayFullname  
![None.gif][]  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]//得到星期短名称  
![None.gif][]function getWeekdayAbbrname($day="",$month="",$year="",$length=3)  
![None.gif][]\{  
![None.gif][]        if(empty($year))  
![None.gif][]            $year= Date\_Calc::dateNow("%Y");  
![None.gif][]        if(empty($month))  
![None.gif][]            $month= Date\_Calc::dateNow("%m");  
![None.gif][]        if(empty($day))  
![None.gif][]            $day= Date\_Calc::dateNow("%d");  
![None.gif][]  
![None.gif][]        $weekday\_names= Date\_Calc::getShortWeekDays();  
![None.gif][]        $weekday= Date\_Calc::dayOfWeek($day,$month,$year);  
![None.gif][]  
![None.gif][]        return$weekday\_names\[$weekday\];          
![None.gif][]          
![None.gif][]\} // end func getWeekdayAbbrname  
![None.gif][]  
![None.gif][]  
以上几个函数有的是修改的，有的是新加的，由于较多，不再一一详细说明。思路是明显的，就是通过对日期列表的的映射获得相应语言名称。有兴趣的朋友可能进行补充和更正。  
3）修改日期显示的乱码处，在modules/calendar/calendar.class.php文件把function \_drawDays()函数中  
  
![None.gif][]   foreach( $wkas$day ) \{  
![None.gif][]   $s.=" <th width="14%">".htmlentities(utf8\_encode($day), ENT\_COMPAT, $locale\_char\_set)  ."</th>";  
![None.gif][] \}  
utf8\_encode函数去掉修改为  
  
![None.gif][]foreach(  $wkas$day ) \{  
![None.gif][]   $s.=" <th width="14%">".htmlentities($day, ENT\_COMPAT,$locale\_char\_set) ."</th>";  
![None.gif][] \}  
完整的函数如下：  
  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]function \_drawDays() \{  
![None.gif][]  global$locale\_char\_set;  
![None.gif][]  
![None.gif][]  $bow= Date\_Calc::beginOfWeek( null,null,null,null,LOCALE\_FIRST\_DAY );  
![None.gif][]  $y=substr( $bow,0,4 );  
![None.gif][]  $m=substr( $bow,4,2 );  
![None.gif][]  $d=substr( $bow,6,2 );  
![None.gif][]  $wk= Date\_Calc::getCalendarWeek( $d,$m,$y,"%a", LOCALE\_FIRST\_DAY );  
![None.gif][]  
![None.gif][]  $s=$this\->showWeek ?" <th>&nbsp;</th>":"";  
![None.gif][]  foreach( $wkas$day ) \{  
![None.gif][]   $s.=" <th width="14%">".htmlentities($day, ENT\_COMPAT,$locale\_char\_set) ."</th>";  
![None.gif][]  \}  
![None.gif][]  
![None.gif][]  return" <tr>$s </tr>";  
![None.gif][]\}  
![None.gif][]//\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
![None.gif][]  
![None.gif][]  
修改文件module/tasks/ae\_dates.php  
![None.gif][]function cal\_work\_day\_conv($val) \{  
![None.gif][]GLOBAL$locale\_char\_set;  
![None.gif][]$wk= Date\_Calc::getCalendarWeek( null,null,null,"%a", LOCALE\_FIRST\_DAY );  
![None.gif][]  
![None.gif][]$day\_name =$wk\[($val\- LOCALE\_FIRST\_DAY)%7\];  
![None.gif][]  
![None.gif][]//把utf8\_encode调用处注释，不进行编码转换  
![None.gif][]/\*  
![None.gif][] if ($locale\_char\_set == "utf-8" && function\_exists("utf8\_encode")) \{  
![None.gif][]     $day\_name = utf8\_encode($day\_name);  
![None.gif][] \}  
![None.gif][]\*/  
![None.gif][]returnhtmlentities($day\_name, ENT\_COMPAT, $locale\_char\_set);  
![None.gif][]  
![None.gif][]\}  
![None.gif][]  
![None.gif][]  
以上是把显示日期名称时的utf8\_encode转码去掉，因为读到的日期名称本来就是utf-8编码，类似的地方可能还有，如果找到都要去掉。  
3. 修正在中文下Gantt图的乱码问题  
DotProject的图形模块使用了jpgraph。JpGraph是PHP专门进行绘制图表的类库。它使得作图变成了一件非常简单的事情，你只需从数据库中取出相关数据，定义标题，图表类型，然后的事情就交给JpGraph，只需掌握为数不多的JpGraph内置函数（可以参照JpGraph附带例子学习），就可以画出非常炫目的图表！  
JpGraph要求PHP版本为4.04以上，并且支持GD库且GD库的版本应为2.0，而不是1.0。JpGraph有PHP4和PHP5两种版本（由于我的环境是PHP5，所以下载了最新PHP5版本，在附件中修改过的DotProject包含这个版本，请使用PHP4更换相应的版本）。  
Gantt图的乱码问题的在于jpgraph中没有对中文及其他语言文字处理好。  
1）修改jpgraph配置文件  
新建字体文件夹和修改lib/jpgraph/src/jpg-config.inc.php文件，在lib/jpgraph路径新建fonts文件夹，把所要的字库复制到该文件夹下。  
在文件lib/jpgraph/src/jpg-config.inc.php中加入如下语句(或把相应的注释去掉后修改)  
![None.gif][]DEFINE('TTF\_DIR','./lib/jpgraph/fonts/'); //设置jpgraphTTF（字体）文件夹  
![None.gif][]DEFINE('SIMSUN\_TTF\_FONT','simsun.ttc');//使用'simsun.ttc'(windows下的宋体)  
![None.gif][]DEFINE('CHINESE\_TTF\_FONT','simsun.ttc');  
2）修改文件module/tasks/gantt.php和module/projects/gantt.php  
新版在绘制Gantt图时报错：You are trying to use the locale (%s) which your PHP installation does not support. Hint: Use ‘ ’ to indicate the default locale for this geographic region.  
这是由于jpgraph没有加入选定的日期格式如'chs'，可修改SetDateLocale处如下：  
![None.gif][]$jpLocale= dPgetConfig(  'jpLocale' );  
![None.gif][]if ($jpLocale) \{  
![None.gif][]$graph\->scale\->SetDateLocale( $jpLocale );  
![None.gif][]\}  
![None.gif][]else \{  
![None.gif][]    $graph\->scale\->SetDateLocale( $AppUI\->user\_lang\[0\] );//第一个估计会有或注释掉和设为 ‘ ’  
![None.gif][]  
![None.gif][]\}  
![None.gif][]  
Gantt图绘制分两部分，一部分是由DotProject生成的项目管理的标题等，一部分是用户业务产生的内容区部分如项目和任务名称。对于第一部分绘制字体编码保持和DotProject一致。  
在语言包文件夹下locales.php文件中加入如下定义（本例是简体中文）  
$LOCALE\_FONT=30;  
30是在jpgraph中定义的语言字体标识（如中文为DEFINE("FF\_SIMSUN",30);），详见jpgraph.php文件。 这样在绘制标题部分取FF\_SIMSUN索引的字体。  
在文件module/tasks/gantt.php和module/projects/gantt.php中定义当前标题要使用的字体，加入如下语句：  
  
![None.gif][]if (!empty($LOCALE\_FONT))\{  
![None.gif][]    define("CRURRENT\_FONT",$LOCALE\_FONT);  
![None.gif][]\}  
![None.gif][]else \{  
![None.gif][]    define("CRURRENT\_FONT",FF\_ARIAL);  
![None.gif][]\}  
![None.gif][]  
这样在设定字体的地方设定CRURRENT\_FONT就可以了。把  
//$graph->scale->actinfo->SetFont(FF\_ARIAL);改为  
$graph->scale->actinfo->SetFont(CRURRENT\_FONT, FS\_NORMAL, 10);//标题信息  
找到  
if (is\_file( TTF\_DIR."arialbd.ttf" ))  
$graph->scale->tableTitle->SetFont(FF\_ARIAL,FS\_BOLD,12); 改为  
$graph->scale->tableTitle->SetFont(CRURRENT\_FONT, FS\_NORMAL, 11);//标题头  
在最后  
$vline = new GanttVLine($today, $AppUI->\_('Today', UI\_OUTPUT\_RAW));语句后插入如下语句：  
$vline->title->SetFont(CRURRENT\_FONT, FS\_NORMAL, 10);//显示today(今天)  
这样绘制标题部分就修改完毕。  
第二部分内容区则要根据要绘制的文字编码动态设定字体。因此在module/tasks/gantt.php和module/projects/gantt.php文件中加入判断字符在什么语言区返回相应的字体（根据utf-8）本例只实现中文区，可以有不对地方，望大家指正。  
  
![None.gif][]//utf-8 region segment 一-鿿  
![None.gif][]function GetutfTTF($str)  
![None.gif][]\{  
![None.gif][]  if (preg\_match("/^(\[".chr(228)."\-".chr(233)."\]\{1\}\[".chr(128)."\-".chr(191)."\]\{1\}\[".chr(128)."\-".chr(191)."\]\{1\})\{1\}/",$word) ==true||preg\_match("/(\[".chr(228)."\-".chr(233)."\]\{1\}\[".chr(128)."\-".chr(191)."\]\{1\}\[".chr(128)."\-".chr(191)."\]\{1\})\{1\}$/",$word) ==true||preg\_match("/(\[".chr(228)."\-".chr(233)."\]\{1\}\[".chr(128)."\-".chr(191)."\]\{1\}\[".chr(128)."\-".chr(191)."\]\{1\})\{2,\}/",$str) ==true)  
![None.gif][]  \{  
![None.gif][]     return (FF\_CHINESE); //返回中文字体标识FF\_CHINESE  
![None.gif][]  \}  
![None.gif][]     return (FF\_ARIAL); //返回默认字体标识FF\_ARIAL  
![None.gif][]\}  
![None.gif][]  
然后在画gantt图相应的项目和任务要显示的名称判断是否在中文，设置对应的字体，如：  
$bar->title->SetFont(GetutfTTF($name), FS\_NORMAL, 10);  
$bar2->title->SetFont(GetutfTTF($t\["task\_name"\]), FS\_NORMAL, 10);  
…  
所有$bar绘制都属于内容区，都把相应部分用如上方法设定字体。绘制Gantt图部分就修改完毕，看看效果：  
英文：  
  
  
  
中文：  
  
4. 其他补充说明  
以上所有的编码都设定为utf-8，因此建议把数据库的服务器端和客户端字符集都改为utf-8。Mysql修改配置文件my.cnf或my.ini即可。  
如phpmyadmin浏览DotProject的mysql数据库，设定为”中文-Chinese Simplified(utf-8)”,如果发现在乱码，请在includes/db\_adodb.php文件中function db\_connect()函数加上  
$db->Query("Set Names 'utf8'");  
这样字符编码就和phpmyadmin保持一致，用phpmyadmin浏览数据就没有乱码了。  
后话：  
本文虽然是解决乱码问题，其中包含软件国际化思想。在软件支持多语言文字时，可以分为两部分，一部分软件本身通过配置有多种语言版本，一部分就是支持不同语言文字的处理。就象浏览器，虽然各种语言版本，但可以正常浏览不同语言的网页。这主要是由于采用了统一编码utf8-unicode（大多采用此种编码）。可以预见，不久乱码问题由于都采用统一编码将不复存在。软件的多语言只是软件国际化第一步，中国软件业国际化任重道远。  
在附件中是由DotProject2.1rc版修改过的压缩文件，并加入了最新的JpGraph for PHP5版本。有兴趣的朋友可以下载大家共同研究。（由于不能上传附件，需要的朋友可以留下email地址）

[NanShan _DotProject]: http://www.nanshan.biz/thread-14527-1-1.html
[NanShan]: http://www.nanshan.biz/
[None.gif]: /images/20220823/b3b6e3231efb4a4eb4d44e79dd461acd.png