PHP 5.3+ 棄用 ereg/eregi 系列函數遷移指南：preg_replace 完美替代方案

PHP 5.3.0 起棄用 POSIX 正則函數 (ereg、eregi 等)，5.7.0 移除。必須遷移至 PCRE 函數 (preg_* 系列)。本文提供完整對照表與遷移技巧。

棄用函數對照表

遷移核心規則

1. 添加分隔符：模式兩側加 / (或 #、~ 等)
2. 修飾符後置：eregi → /pattern/i
3. 特殊字符轉義：PCRE 元字符更多，注意 $、^、. 等在字符類中行為差異
4. 字符類差異：POSIX [:alnum:] → PCRE \w / [a-zA-Z0-9]

實戰遷移示例

<?php
// 1. 簡單匹配
// ereg('^test', $file)
if (preg_match('/^test/', $file)) { ... }

// 2. 大小寫不敏感
// eregi('^test', $file)
if (preg_match('/^test/i', $file)) { ... }

// 3. 替換
// ereg_replace('\.php$', '.html', $url)
$url = preg_replace('/\.php$/', '.html', $url);

// 4. 分割
// split(':', $str)
$parts = preg_split('/:/', $str);
// 非正則分割更快
$parts = explode(':', $str);

// 5. sql_regcase 手動替代
// sql_regcase('abc') → '[aA][bB][cC]'
function pcre_regcase($str) {
    return preg_replace_callback('/./', function($m) {
        $c = $m[0];
        return '[' . strtolower($c) . strtoupper($c) . ']';
    }, $str);
}

常見遷移陷阱

性能優化建議

• 非正則分割用 explode()：比 preg_split 快 10 倍以上
• 預編譯模式：循環外定義 $pattern = '/.../'，避免重複編譯
• 簡單匹配用 strpos/stripos：無正則開銷，速度最快
• JIT 優化 (PHP 8+)：PCRE2 支持 JIT 編譯，複雜模式加速顯著

批量遷移腳本思路

<?php
// 簡單掃描項目文件
$files = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator(__DIR__)
);

foreach ($files as $file) {
    if ($file->isFile() && $file->getExtension() === 'php') {
        $content = file_get_contents($file->getPathname());
        
        // 檢測棄用函數
        if (preg_match('/\b(ereg|eregi|split|spliti|sql_regcase)\b/', $content)) {
            echo "需遷移: " . $file->getPathname() . "\n";
        }
    }
}

遷移清單：1) 全局搜索棄用函數 2) 按對照表替換 3) 重點測試正則邏輯 4) 性能基準對比 5) 更新 CI/CD 檢查規則禁止回歸。