PHP 5.3+ 升級遷移指南：棄用函數替換、靜態調用修正、魔術引號移除完整解決方案

PHP 5.3 引入重大變更：棄用 POSIX 正則函數、移除靜態賦值引用、關閉魔術引號運行時設置。大量舊代碼升級後報 `Deprecated` 警告甚至 Fatal Error。本文提供完整對照表、批量替換策略、兼容性封裝與遷移檢查清單。

核心變更對照表

具體替換示例

1. POSIX 正則 → PCRE

// 舊
if ( ereg('^[0-9]+$', $input ) ) { ... }
$str = ereg_replace('[^a-zA-Z0-9]', '', $str);

// 新
if ( preg_match('/^[0-9]+$/', $input ) ) { ... }
$str = preg_replace('/[^a-zA-Z0-9]/', '', $str);

// 注意：ereg 隱含 ^...$ 全匹配，preg_match 需顯式加 ^$
// ereg 區分大小寫，eregi 不區分 → preg_match 加 i 修飾符

2. 靜態賦值引用移除

// 舊 (報 Deprecated: Assigning the return value of new by reference is deprecated)
$instance = & new Singleton();

// 新
$instance = new Singleton();
// PHP 5+ new 默認返回對象引用，無需 &

3. 魔術引號相關清理

// 舊啟動文件常見代碼
set_magic_quotes_runtime(0); // 直接刪除此行

// 舊輸入過濾
if ( get_magic_quotes_gpc() ) {
    $_GET   = array_map('stripslashes', $_GET);
    $_POST  = array_map('stripslashes', $_POST);
    $_COOKIE = array_map('stripslashes', $_COOKIE);
}
// PHP 5.4+ get_magic_quotes_gpc() 恒返回 false，上述代碼無效且無必要
// 現代框架 (Laravel/Symfony/Yii2) 已內建輸入處理，無需手動干預

批量遷移工具與策略

1. PHP_CodeSniffer + PHPCompatibility 標準

# 安裝
composer require --dev squizlabs/php_codesniffer phpcompatibility/php-compatibility

# 掃描項目 (檢測 5.3-8.2 兼容性)
phpcs --standard=PHPCompatibility /path/to/project -p

2. Rector 自動化重構 (推薦)

composer require --dev rector/rector
# 建立 rector.php 配置
vendor/bin/rector process /path/to/project --dry-run
vendor/bin/rector process /path/to/project

Rector 可自動完成：ereg→preg、& new 移除、魔術引號清理、類型聲明補全等數十項重構。

3. 手動 grep 替換 (小項目)

# 查找所有 ereg 系列
grep -rn "ereg" --include="*.php" .

# 批量替換 (謹慎使用，建議先備份)
find . -name "*.php" -exec sed -i 's/ereg(/preg_match(/g' {} \;
find . -name "*.php" -exec sed -i 's/ereg_replace(/preg_replace(/g' {} \;
# 後續需手動補全定界符與修飾符

運行時錯誤抑制 (臨時過渡)

升級初期可抑制 `E_DEPRECATED` 讓舊代碼暫時運行，但**必須盡快修復**：

// php.ini
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT

// 或代碼中
error_reporting(E_ALL & ~E_DEPRECATED & ~E_STRICT);

遷移檢查清單

現代化建議

1. 最低要求 PHP 7.4+：PHP 5.6/7.0/7.1/7.2/7.3 均已停止安全更新。
2. 啟用嚴格模式：declare(strict_types=1); 所有文件頂部。
3. 類型聲明：參數、返回值、屬性全部加類型 (PHP 7.4+)。
4. Composer 依賴管理：移除手動 include，全面 PSR-4 自動加載。
5. 現代框架：Laravel 10+, Symfony 6+, Yii 2.0.47+ 均要求 PHP 8.0+。

系統化遷移而非打補丁，能徹底消除兼容性隱患，享受現代 PHP 的性能與語法紅利。