核心函數對比
| 函數 | 用途 | 返回值 | 多位元組安全 |
| strpos | 尋找子字串首次出現位置 | int 位置 / false | 否 (按字節) |
| stripos | 大小寫不敏感尋找 | int / false | 否 |
| mb_strpos | 多位元組尋找 | int / false | 是 |
| substr | 截取子字串 (字節) | string / false | 否 |
| mb_substr | 多位元組截取 | string | 是 |
| strstr | 從首次出現處截取到結尾 | string / false | 否 |
| stristr | 大小寫不敏感 strstr | string / false | 否 |
| mb_strstr | 多位元組 strstr | string | 是 |
實戰範例
<?php
$str = 'Hello 世界 😀';
// 1. 尋找位置
echo strpos($str, '世'); // 6 (字節位置)
echo mb_strpos($str, '世'); // 6 (字符位置,UTF-8 下相同)
echo mb_strpos($str, '😀'); // 9 (字符位置)
// 2. 截取
echo substr($str, 6, 6); // 世界 (字節截取,風險:可能截斷多位元組)
echo mb_substr($str, 6, 2); // 世界 (正確字符截取)
echo mb_substr($str, -1); // 😀 (負數從結尾計算)
// 3. 從特定字元分割
$email = 'user@example.com';
echo strstr($email, '@', true); // user (PHP 5.3+ 第三參數 true 返回前段)
echo strstr($email, '@'); // @example.com
// 4. 解析 URL 參數
$query = 'name=john&age=25&city=taipei';
parse_str($query, $params);
// $params = ['name'=>'john', 'age'=>'25', 'city'=>'taipei']
?>
常見陷阱與最佳實踐
- 嚴禁對中文/Emoji 使用 `substr`/`strpos`,必須用 `mb_*` 對應函數,並在腳本開頭設定 `mb_internal_encoding('UTF-8')`。
- `strpos` 可能返回 `0` (找到在開頭),判斷必須用 `=== false`,不可用 `!` 或 `== false`。
- 大量字串處理時,考慮使用 `Stringable` 介面 (PHP 8.0+) 或專用庫 (如 `voku/portable-utf8`)。
- 正則替代:`preg_match('/pattern/u', $str)` `u` 修飾符啟用 UTF-8 模式。
自定義多位元組安全截取輔助函數
<?php
function str_cut(string $str, int $length, string $suffix = '...'): string
{
if (mb_strlen($str) <= $length) return $str;
return mb_substr($str, 0, $length) . $suffix;
}
function str_between(string $str, string $start, string $end): ?string
{
$sPos = mb_strpos($str, $start);
if ($sPos === false) return null;
$sPos += mb_strlen($start);
$ePos = mb_strpos($str, $end, $sPos);
if ($ePos === false) return null;
return mb_substr($str, $sPos, $ePos - $sPos);
}
?>