Joomla! UTF-8规范 (WIP)

4 第三方组件的UTF-8导则

UTF-8是第三方组件的重要方面，以下是第三方组件的UTF-8规范。

4.1 对于现有组件的兼容性约束

如果mysql数据是UTF-8兼容的，采用utf8字符集和字典顺序，现有组件是安全的。组件安装过程总创建的表是utf字符集，除非创建表的语句指定了字符集。

不推荐在低于4.1.2版本的数据库安装现有的组件，因为这容易导致字符串截断。

现有组件的采用php字串函数可能导致字符串截断。


4.2 创建Joomla 1.5组件的导则

4.2.1 数据库表创建

为了兼容性，表创建过程不应该在xml文件中，而应该写两个sql脚本，一个是utf版本，一个是非utf-8版本，非utf-8版本中的varchar字段应该按前面所述规则进行长度扩展。

下面是就的安装xml文件：


    
        
            ...query text...
        
        
            ...another query text...
        
    
...


以上应该替换为如下部分


  
    install.utf.sql
    install.nonutf.sql
  


以下是一个完整组件安装xml文件，注意其中的 两个安装sql脚本。



DailyMessage
10/4/2005
Joseph LeBlanc
This component in released under the GNU/GPL License
contact@jlleblanc.com为防备电子邮件地址收集器，这个 E-mail 地址被隐藏，你的浏览器必须支持 Javascript 才可看到这个邮件地址
www.jlleblanc.com
1.0.3

  dailymessage.php
  dailymessage.class.php


  
    install.utf.sql
    install.nonutf.sql
  



  
    uninstall.utf.sql
    uninstall.nonutf.sql
  



install.dailymessage.php



uninstall.dailymessage.php



Daily Message

  Edit Messages
  Configure

  
   admin.dailymessage.php
   admin.dailymessage.html.php
   toolbar.dailymessage.php
   toolbar.dailymessage.html.php
   install.utf.sql
   uninstall.utf.sql
   install.nonutf.sql
   uninstall.nonutf.sql
  



4.2.2 UTF-8 字符串处理

php字符串函数应该按照前述规则替换为相应的Jstring字符串函数。