PHP 進階：preg_replace 如何平滑遷移至 preg_replace_callback？

從舊式回調到現代寫法的完整指南

PHP 7.4 起棄用 preg_replace 的 /e 修飾符，PHP 8.0 完全移除。舊代碼 preg_replace('#{([a-z_0-9]+)}#Uei', "\$data[\1]", $str) 必須重寫。本文詳細拆解遷移步驟與陷阱。

核心差異對比

標準遷移模板

$pattern = '#\{([a-z_0-9]+)\}#Uei'; // 保持原修飾符
$callback = function ($matches) use ($data) {
    $key = $matches[1]; // $matches[0] 整個匹配，[1] 第一個捕獲組
    return isset($data[$key]) ? $data[$key] : $matches[0]; // 找不到保留原樣
};
$result = preg_replace_callback($pattern, $callback, $data['setting']['url']['list']);

關鍵點詳解

1. 捕獲組索引： $matches[1] 對應正則中第一個 ()，舊寫法 \1 現在不可用。
2. 外部變量注入： 必須用 use ($data) 將外部數組引入閉包，否則作用域不可见。
3. 修飾符保留： U（非貪婪）、e（已棄用）、i（忽略大小寫）需視業務調整，建議顯式聲明 #Uiu（Unicode）。
4. 返回值處理： 回調必須返回替換字符串，null 會轉為空串。

進階技巧：靜態緩存編譯正則

高頻調用時，將正則編譯結果緩存：

static $compiled = null;
if ($compiled === null) $compiled = '#\{([a-z_0-9]+)\}#Uiu';
return preg_replace_callback($compiled, $callback, $subject);

遷移完成後，代碼更安全、可讀、可維護，且兼容 PHP 8.1+。