PHP 字串截取函數 substr 與多位元組支援方案

基本函數：substr()

substr() 是 PHP 內建的字串截取函數，僅支援單位元組編碼（ASCII、Latin-1 等）。對於中文等多位元組編碼（UTF-8、GBK），直接使用會導致亂碼或截斷錯誤。

語法與常用範例

<?php
$str = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';

echo '原字串：' . $str . '<br>';
echo '從第 5 個字元開始：' . substr($str, 5) . '<br>';
echo '從第 9 個字元取 4 個：' . substr($str, 9, 4) . '<br>';
echo '取倒數 5 個字元：' . substr($str, -5) . '<br>';
echo '從倒數第 8 個開始取 4 個：' . substr($str, -8, 4) . '<br>';
echo '從倒數第 8 個取到倒數第 2 個：' . substr($str, -8, -2) . '<br>';
?>

多位元組字串截取：mb_substr()

PHP 提供 mb_substr()（需啟用 mbstring 擴展）正確處理 UTF-8、GBK 等編碼：

<?php
$str = '你好，世界！';
echo mb_substr($str, 0, 2, 'UTF-8'); // 輸出：你好
?>

自訂函數：支援中英混排的截取（舊版相容）

若環境無 mbstring，可使用以下函數（基於 ord() 判斷雙位元組字元）：

<?php
function substr_cut($str, $length) {
    if (strlen($str) > $length) {
        for ($i = 0; $i < $length; $i++) {
            if (ord($str[$i]) > 128) $i++; // 跳過雙位元組字元的第二個位元組
        }
        $str = substr($str, 0, $i) . '..';
    }
    return $str;
}

// 使用範例
$text = 'PHP 程式設計教學';
echo substr_cut($text, 10); // 輸出：PHP 程式..
?>

注意：此函數假設雙位元組字元首位元組 > 128，適用於 Big5/GBK，不適用於 UTF-8（UTF-8 中文字元佔 3 位元組）。現代專案請直接使用 mb_substr()。

最佳實踐建議

1. 專案編碼統一使用 UTF-8，並啟用 mbstring 擴展。
2. 所有字串截取、長度計算、比對均使用 mb_* 系列函數（mb_substr、mb_strlen、mb_strpos 等）。
3. 資料庫連線、HTML 頁面、PHP 檔案編碼三者保持一致。