PHP Smarty 中文截取外掛開發完整教學

前言

Smarty 內建 truncate 不支援中文多位元組字元，直接使用會導致亂碼。本文完整教學開發 truncate_cn 修飾器外掛，支援中英文混排精準截取。

一、Smarty 外掛基礎知識

二、開發 modifier.truncate_cn.php

<?php
/**
 * Smarty 中文截取修飾器
 * 用法：{$str|truncate_cn:長度:省略字元:起始位置}
 */
function smarty_modifier_truncate_cn($string, $length = 0, $ellipsis = '…', $start = 0) {
    // 1. 清理標籤與特殊字元
    $string = strip_tags($string);
    $string = preg_replace('/\n/is', '', $string);
    $string = preg_replace('/&nbsp;/is', '', $string);

    // 2. UTF-8 字元切分（支援多位元組）
    preg_match_all(
        "/[\x01-\x7f]|[\xc2-\xdf][\x80-\xbf]|\xe0[\xa0-\xbf][\x80-\xbf]|[\xe1-\xef][\x80-\xbf][\x80-\xbf]|\xf0[\x90-\xbf][\x80-\xbf][\x80-\xbf]|[\xf1-\xf7][\x80-\xbf][\x80-\xbf][\x80-\xbf]/",
        $string, $matches
    );

    if (is_array($matches) && !empty($matches[0])) {
        $string = implode('', $matches[0]);
        if (strlen($string) < $start + 1) return '';

        // 3. 精準截取
        preg_match_all("/./su", $string, $ar);
        $result = '';
        $skipped = '';
        for ($i = 0; isset($ar[0][$i]); $i++) {
            if (strlen($skipped) < $start) {
                $skipped .= $ar[0][$i];
            } else {
                if (strlen($result) < $length + strlen($ar[0][$i])) {
                    $result .= $ar[0][$i];
                } else break;
            }
        }
        return $string === $result ? $result : $result . $ellipsis;
    }
    return '';
}
?>

三、安裝與使用

1. 將檔案存為 modifier.truncate_cn.php
2. 放入 smarty/lib/plugins/ 目錄
3. 模板中直接使用：{$news.content|truncate_cn:30}

參數說明

進階：支援 HTML 標籤保留版本

若需保留 HTML 結構（如 <b>、<a>），需更複雜的 DOM 解析邏輯，建議使用 HTMLPurifier 或 mb_strimwidth 搭配預處理。