萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP substr() 函數完整指南:參數詳解、負索引技巧與多位元組字串處理

函數原型

substr(string $string, int $offset, ?int $length = null): string

參數詳細說明

參數類型說明
$stringstring輸入字串,多位元組字元(中文等)每個字元佔多個位元組
$offsetint起始位置。正數:從左往右(0 起始);負數:從右往左(-1 為最後一字元)。超出長度返回空字串
$lengthint|null可選。正數:最大返回長度;負數:從結尾向前略過的字元數;0/null/false:返回空字串。省略則返回到字串結尾

核心範例(ASCII 字串)

<?php
$str = 'abcdefghijklmn'; // 長度 14

// 基本用法
echo substr($str, 0) . PHP_EOL;      // abcdefghijklmn (從 0 到結尾)
echo substr($str, 1, 3) . PHP_EOL;   // bcd (索引 1 起取 3 字元)
echo substr($str, -3) . PHP_EOL;     // lmn (倒數 3 字元)
echo substr($str, -3, 2) . PHP_EOL;  // lm (倒數 3 起取 2)
echo substr($str, 1, -3) . PHP_EOL;  // bcdefghijk (索引 1 到倒數第 4)
echo substr($str, -7, -3) . PHP_EOL; // hijk (倒數 7 到倒數 4)
?>

負索引視覺化對照表

字串:  a  b  c  d  e  f  g  h  i  j  k  l  m  n
正索引: 0  1  2  3  4  5  6  7  8  9 10 11 12 13
負索引:-14 -13 -12 -11 -10 -9 -8 -7 -6 -5 -4 -3 -2 -1
  • substr($str, -7, -3) 相當於 substr($str, 7, 4)(從索引 7 取 4 字元)
  • 負 $length 表示「結尾前保留多少字元不取」

中文/多位元組字串陷阱與解決方案

❌ 錯誤示範

<?php
$zh = '你好世界';
echo substr($zh, 0, 2); // 輸出: '你' 的前半個位元組 + '好' 的前半個位元組 = 亂碼
?>

substr() 按位元組操作,UTF-8 中文佔 3 位元組,直接截取會破壞字元。

✅ 正確做法:使用 mb_substr()

<?php
$zh = '你好世界';

// 正確截取前 2 個字元
echo mb_substr($zh, 0, 2, 'UTF-8'); // '你好'

// 負索引同樣支援
echo mb_substr($zh, -2, 2, 'UTF-8'); // '世界'

// 省略編碼參數(使用內部編碼,建議開頭設定 mb_internal_encoding('UTF-8'))
echo mb_substr($zh, 1, 1); // '好'
?>

實戰應用場景

1. 文字摘要截斷(保留完整詞彙)

function truncate(string $text, int $limit = 100, string $suffix = '...'): string {
    if (mb_strlen($text, 'UTF-8') <= $limit) return $text;
    
    $truncated = mb_substr($text, 0, $limit, 'UTF-8');
    // 嘗試在最後一個標點或空格處截斷,避免斷詞
    $lastPunct = max(
        mb_strrpos($truncated, '。', 'UTF-8'),
        mb_strrpos($truncated, ',', 'UTF-8'),
        mb_strrpos($truncated, ' ', 'UTF-8'),
        mb_strrpos($truncated, '.', 'UTF-8'),
        mb_strrpos($truncated, ',', 'UTF-8')
    );
    
    if ($lastPunct !== false && $lastPunct > $limit * 0.7) {
        return mb_substr($truncated, 0, $lastPunct + 1, 'UTF-8') . $suffix;
    }
    return $truncated . $suffix;
}
?>

2. 手機號碼/身分證遮罩

function maskId(string $id, int $visibleStart = 3, int $visibleEnd = 4): string {
    $len = strlen($id);
    if ($len <= $visibleStart + $visibleEnd) return $id;
    $start = substr($id, 0, $visibleStart);
    $end = substr($id, -$visibleEnd);
    $mask = str_repeat('*', $len - $visibleStart - $visibleEnd);
    return $start . $mask . $end;
}

echo maskId('13812345678');      // 138****5678
echo maskId('A123456789');       // A12****789
?>

3. 解析固定格式字串(如日期、序號)

$serial = 'SN202401150042';
$prefix = substr($serial, 0, 2);     // 'SN'
$date = substr($serial, 2, 8);       // '20240115'
$seq = substr($serial, 10);          // '0042'

// 組合驗證
if ($prefix === 'SN' && strtotime($date) !== false && is_numeric($seq)) {
    echo "有效序號:日期 $date,流水號 $seq";
}
?>

效能提示

  • substr() 是 C 層級實現,極快,但僅適用單位元組字串或已知位元組偏移的場景。
  • 大量中文截取請用 mb_substr(),PHP 7.3+ 對其有優化,效能差距已大幅縮小。
  • 避免在循環中重複呼叫 mb_strlen() 獲取長度,預先儲存變數。

總結

substr() 是 PHP 字串切片的基石,掌握正負索引組合技巧能靈活處理各種定長/變長解析需求。處理多語言文本時,請堅持使用 mb_substr() 並顯式指定 'UTF-8' 編碼,確保字元級別的正確性。結合 mb_strpos()、mb_strrpos() 可構建強大的文字處理流水線。

copyright © 萬盛學電腦網 all rights reserved