萬盛學電腦網

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

PHP trim() 函數深度解析:去除空白、自定字元、多字節陷阱與實戰技巧

函數簽名與預設行為

trim(string $string, string $characters = " \t\n\r\0\x0B"): string

預設去除字元(ASCII):

  • (32) 空格
  • \t (9) 水平製表符
  • \n (10) 換行
  • \r (13) 回車
  • \0 (0) NULL 字元
  • \x0B (11) 垂直製表符

關鍵特性:只移除字串首尾,中間字元不受影響。

基本用法

<?php
$str = "  \t\n  Hello World  \n\r\t  ";
echo strlen($str);           // 28
echo strlen(trim($str));     // 11 ("Hello World")

// 自定字元:移除首尾的 # 和空格
$str = "##  Hello World  ##";
echo trim($str, "# ");       // "Hello World"

// ltrim / rtrim:單側修剪
echo ltrim($str, "# ");      // "Hello World  ##"
echo rtrim($str, "# ");      // "##  Hello World"
?>

陷阱與誤區

1. 字元清單是「字元集合」,不是「子字串」

<?php
trim('abc', 'ab'); // 結果:"c" —— 移除首尾的 'a' 和 'b',而非 "ab" 子字串
trim('abc', 'ba'); // 同理:"c"
?>

2. 多字節字元(中文、Emoji)不支援

<?php
$str = "  你好 世界  ";
echo trim($str);           // "你好 世界" (正常,空格是 ASCII)
echo trim($str, "世");     // "  你好 界  " —— 只移除單字節 "世" 的位元組,破壞多字節字元!
?>

解決:多字節修剪請用 mb_trim() (PHP 8.2+) 或自寫正則。

3. 陣列/物件無法直接處理

<?php
$arr = ['  a  ', '  b  '];
// trim($arr) // Warning: trim() expects string
$clean = array_map('trim', $arr); // 正確
?>

實戰技巧

1. 清理使用者輸入(表單驗證前置)

<?php
function cleanInput(string $input): string
{
    // 1. 修剪首尾空白
    $input = trim($input);
    // 2. 合併內部多餘空白(可選)
    $input = preg_replace('/\s+/', ' ', $input);
    return $input;
}

$_POST = array_map('cleanInput', $_POST);
?>

2. 移除特定前綴/後綴(PHP 8.0+ ltrim/rtrim 不支援字串前綴)

<?php
function removePrefix(string $str, string $prefix): string
{
    if (str_starts_with($str, $prefix)) {
        return substr($str, strlen($prefix));
    }
    return $str;
}

function removeSuffix(string $str, string $suffix): string
{
    if (str_ends_with($str, $suffix)) {
        return substr($str, 0, -strlen($suffix));
    }
    return $str;
}

// 範例
echo removePrefix('https://example.com', 'https://'); // example.com
echo removeSuffix('image.jpg', '.jpg');               // image
?>

3. 清理 CSV/TSV 匯入資料

<?php
function cleanCsvField(string $field): string
{
    // 移除首尾引號與空白
    $field = trim($field, " \t\r\n\"'");
    // 處理雙引號轉義
    $field = str_replace('""', '"', $field);
    return $field;
}
?>

4. 安全路徑處理(防止目錄遍歷)

<?php
function safeBasename(string $path): string
{
    // 只取檔名,移除路徑分隔符
    $name = basename($path);
    // 再次修剪可疑字元
    return trim($name, " \t\n\r\0\x0B./\\");
}
?>

效能微基準

操作100萬次耗時備註
trim()~0.08 秒極快
preg_replace('/^\s+|\s+$/', '')~1.2 秒慢 15 倍,避免用於熱路徑
mb_trim() (PHP 8.2+)~0.15 秒多字節安全,稍慢

PHP 8.2 新功能:mb_trim / mb_ltrim / mb_rtrim

<?php
// PHP 8.2+
$str = "  你好 世界  ";
echo mb_trim($str);              // "你好 世界"
echo mb_trim($str, " 世");       // "你好 界" (正確處理多字節)
echo mb_ltrim($str, " 你");      // "好 世界  "
echo mb_rtrim($str, "界  ");     // "  你好"
?>

相關函數速查

函數說明PHP 版本
trim首尾修剪4+
ltrim左側修剪4+
rtrim右側修剪4+
choprtrim 別名4+
mb_trim多字節安全修剪8.2+
str_starts_with前綴檢查8.0+
str_ends_with後綴檢查8.0+

trim() 看似簡單,但掌握其字元集合語意、多字節限制、PHP 8.2 新函數,能避免許多隱性 Bug,寫出更健壯的字串處理程式碼。

copyright © 萬盛學電腦網 all rights reserved