转改良Smarty的truncate插件：smartTruncate 简单

转自：http://hi.baidu.com/thinkinginlamp/blog/item/0dd3b2b76a4160f430add151.html

作者：老王

注意：本文笼统的把UTF-8下的中文长度定为3是不准确的，不过大多数情况下这样做没啥问题。

对于truncate的介绍，可以查看官方网站的文档。

原有的truncate的缺点：

一般网站页面的显示都不可避免的会涉及子字符串的截取，这个时候truncate就派上用场了，但是它只适合英文用户，对与中文用户来说，使用truncate会出现乱码，而且对于中文英文混合串来说，截取同样个数的字符串，实际显示长度上却不同，视觉上会显得参差不齐，不美观。这是因为一个中文的长度大致相当与两个英文的长度。此外，truncate也不能同时兼容GB2312, UTF-8等编码。

改良的smartTruncate：

文件名：modifier.smartTruncate.php：

<?php 
function smartDetectUTF8($string) 
{ 
     static $result = array(); 

     if(! array_key_exists($key = md5($string), $result)) 
     { 
        $utf8 = " 
             /^(?: 
                 [\x09\x0A\x0D\x20-\x7E]              # ASCII 
                 | [\xC2-\xDF][\x80-\xBF]             # non-overlong 2-byte 
                 | \xE0[\xA0-\xBF][\x80-\xBF]         # excluding overlongs 
                 | [\xE1-\xEC\xEE\xEF][\x80-\xBF]{2} # straight 3-byte 
                 | \xED[\x80-\x9F][\x80-\xBF]         # excluding surrogates 
                 | \xF0[\x90-\xBF][\x80-\xBF]{2}      # planes 1-3 
                 | [\xF1-\xF3][\x80-\xBF]{3}          # planes 4-15 
                 | \xF4[\x80-\x8F][\x80-\xBF]{2}      # plane 16 
             )+$/xs 
         "; 

        $result[$key] = preg_match(trim($utf8), $string); 
     } 

     return $result[$key]; 
}

function smartStrlen($string) 
{ 
    $result = 0; 

    $number = smartDetectUTF8($string) ? 3 : 2; 

     for($i = 0; $i < strlen($string); $i += $bytes) 
     { 
        $bytes = ord(substr($string, $i, 1)) > 127 ? $number : 1; 

        $result += $bytes > 1 ? 1.0 : 0.5; 
     } 

     return $result; 
} 

function smartSubstr($string, $start, $length = null) 
{ 
    $result = ''; 

    $number = smartDetectUTF8($string) ? 3 : 2; 

     if($start < 0) 
     { 
        $start = max(smartStrlen($string) + $start, 0); 
     } 

     for($i = 0; $i < strlen($string); $i += $bytes) 
     { 
         if($start <= 0) 
         { 
             break; 
         } 

        $bytes = ord(substr($string, $i, 1)) > 127 ? $number : 1; 

        $start -= $bytes > 1 ? 1.0 : 0.5; 
     } 

     if(is_null($length)) 
     { 
        $result = substr($string, $i); 
     } 
     else 
     { 
         for($j = $i; $j < strlen($string); $j += $bytes) 
         { 
             if($length <= 0) 
             { 
                 break; 
             } 

             if(($bytes = ord(substr($string, $j, 1)) > 127 ? $number : 1) > 1) 
             { 
                 if($length < 1.0) 
                 { 
                     break; 
                 } 

                $result .= substr($string, $j, $bytes); 
                $length -= 1.0; 
             } 
             else 
             { 
                $result .= substr($string, $j, 1); 
                $length -= 0.5; 
             } 
         } 
     } 

     return $result; 
} 

function smarty_modifier_smartTruncate($string, $length = 80, $etc = '...', 
                                       $break_words = false, $middle = false) 
{ 
     if ($length == 0) 
         return ''; 

     if (smartStrlen($string) > $length) { 
        $length -= smartStrlen($etc); 
         if (!$break_words && !$middle) { 
            $string = preg_replace('/\s+?(\S+)?$/', '', smartSubstr($string, 0, $length+1)); 
         } 
         if(!$middle) { 
             return smartSubstr($string, 0, $length).$etc; 
         } else { 
             return smartSubstr($string, 0, $length/2) . $etc . smartSubstr($string, -$length/2); 
         } 
     } else { 
         return $string; 
     } 
} 
?>

以上代码完整实现了truncate的原有功能，而且可以同时兼容GB2312和UTF-8编码，在判断字符长度的时候，一个中文字符算1.0，一个英文字符算0.5，所以在截取子字符串的时候不会出现参差不齐的情况。

简单测试：

插件的使用方式没有特别之处，这里简单测试一下：

{$content|smartTruncate:5:".."}（$content等于"A中B华C人D民E共F和G国H"）

显示：A中B华C.. （中文符号长度算1.0，英文符号长度算0.5，并且考虑省略符号的长度）

不管你是使用GB2312编码还是UTF-8编码，你会发现结果都正确，这也是为什么我在插件名字里加上smart字样的原因之一。