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"
?>
<?php
trim('abc', 'ab'); // 結果:"c" —— 移除首尾的 'a' 和 'b',而非 "ab" 子字串
trim('abc', 'ba'); // 同理:"c"
?>
<?php
$str = " 你好 世界 ";
echo trim($str); // "你好 世界" (正常,空格是 ASCII)
echo trim($str, "世"); // " 你好 界 " —— 只移除單字節 "世" 的位元組,破壞多字節字元!
?>
解決:多字節修剪請用 mb_trim() (PHP 8.2+) 或自寫正則。
<?php
$arr = [' a ', ' b '];
// trim($arr) // Warning: trim() expects string
$clean = array_map('trim', $arr); // 正確
?>
<?php
function cleanInput(string $input): string
{
// 1. 修剪首尾空白
$input = trim($input);
// 2. 合併內部多餘空白(可選)
$input = preg_replace('/\s+/', ' ', $input);
return $input;
}
$_POST = array_map('cleanInput', $_POST);
?>
<?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
?>
<?php
function cleanCsvField(string $field): string
{
// 移除首尾引號與空白
$field = trim($field, " \t\r\n\"'");
// 處理雙引號轉義
$field = str_replace('""', '"', $field);
return $field;
}
?>
<?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
// 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+ |
| chop | rtrim 別名 | 4+ |
| mb_trim | 多字節安全修剪 | 8.2+ |
| str_starts_with | 前綴檢查 | 8.0+ |
| str_ends_with | 後綴檢查 | 8.0+ |
trim() 看似簡單,但掌握其字元集合語意、多字節限制、PHP 8.2 新函數,能避免許多隱性 Bug,寫出更健壯的字串處理程式碼。