自 PHP 5.3 起,官方引入 E_DEPRECATED 錯誤級別,標誌著核心函數棄用機制的正式建立。隨著版本迭代至 5.5,大量舊式 API 被標記棄用甚至徹底移除,對存量專案升級構成實質挑戰。本文系統梳理三大版本的關鍵變更,提供對應替代方案與遷移策略。
5.3 版本棄用函數最為集中,核心涉及三大領域:
ereg()、ereg_replace()、eregi()、eregi_replace()、split()、spliti()、sql_regcase() 全面由 PCRE 族函數(preg_*)取代,需注意修飾符 i 的用法差異。mysql_db_query()、mysql_escape_string() 分別建議改用 mysql_select_db() + mysql_query() 組合與 mysql_real_escape_string();mysql_close() 強制要求傳入連接資源參數。session_register()、session_unregister()、session_is_registered() 應改用 $_SESSION 超全域陣列;define_syslog_variables()、dl()、set_magic_quotes_runtime() 等被標記棄用,其中魔術引號機制在 5.4 徹底移除,是重大破壞性變更。其他棄用項還包括:call_user_method()/call_user_method_array()(改用 call_user_func()/call_user_func_array())、set_socket_blocking()(改用 stream_set_blocking())、mktime() 的 is_dst 參數(改用時區處理函數)、區域設定字串傳遞(改用 LC_* 常數)。
5.4 僅棄用 mcrypt_generic_end() 與 mysql_list_dbs() 兩個函數,但引入大量語法糖(如陣列短語法 []、Trait、內建 Web 伺服器等),開發體驗顯著提升。值得注意的是,魔術引號(magic_quotes_gpc、magic_quotes_runtime)在此版本徹底移除,依賴自動轉義的舊專案必須手動補全輸入過濾邏輯。
5.5 標誌性變更是整個 ext/mysql 擴展標記棄用,執行 mysql_connect() 即拋出 E_DEPRECATED 警告:
Deprecated: mysql_connect(): The mysql extension is deprecated and will be removed in the future: use mysqli or PDO instead
同步棄用的加密函數包括 mcrypt_cbc()、mcrypt_cfb()、mcrypt_ecb()、mcrypt_ofb(),建議遷移至 OpenSSL 或 Sodium 擴展。此版本釋放的信號明確:PHP 7 將徹底移除舊 MySQL 擴展,專案必須規劃遷移至 MySQLi 或 PDO。
error_reporting(E_ALL | E_DEPRECATED),提前暴露棄用調用。mysql_* 調用。ereg、split 關鍵字,批次轉換為 preg_* 並驗證修飾符行為一致性。session_register 系調用,改用 $_SESSION['key'] = $value 直接操作。function mysql_escape_string($s){ return mysql_real_escape_string($s); })平滑過渡。市場上仍存大量 PHP 5.1/5.2 存量專案,升級至 5.3+ 需審慎評估棄用影響範圍。建議採用「雙軌並行」策略:新功能使用現代 API,存量代碼逐步重構,並配合自動化測試確保業務邏輯不回歸。