substr(string $string, int $offset, ?int $length = null): string
| 參數 | 類型 | 說明 |
|---|---|---|
$string | string | 輸入字串,多位元組字元(中文等)每個字元佔多個位元組 |
$offset | int | 起始位置。正數:從左往右(0 起始);負數:從右往左(-1 為最後一字元)。超出長度返回空字串 |
$length | int|null | 可選。正數:最大返回長度;負數:從結尾向前略過的字元數;0/null/false:返回空字串。省略則返回到字串結尾 |
<?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 位元組,直接截取會破壞字元。
<?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); // '好'
?>
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;
}
?>
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
?>
$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() 可構建強大的文字處理流水線。