PHP 5.4 傳址呼叫移除詳解：Call-time pass-by-reference 錯誤原因與修正指南

PHP 5.4 移除「呼叫時傳址」：從 Fatal Error 到正確寫法完整遷移指南

PHP 5.4 正式移除 Call-time pass-by-reference（呼叫端以 & 強制傳址），升級後大量舊代碼噴出 Fatal error: Call-time pass-by-reference has been removed。本文詳細說明語法變更、三類典型場景修正範例，助你快速修復相容性問題。

語法變更對照

核心原則：傳址意圖應在函數簽名宣告，而非呼叫端。

場景一：遞迴函數傳址修改變數

// 舊寫法 (PHP 5.3)
function test($aa, &$bb) {
  if ($aa < $bb) { echo $bb--; test($aa, &$bb); }
}
test(3, &$bb); // Fatal Error in 5.4+

// 新寫法：呼叫端移除 &
function test($aa, &$bb) {
  if ($aa < $bb) { echo $bb--; test($aa, $bb); } // 這裡也不用 &
}
$bb = 6;
test(3, $bb); // 輸出 5 4 3

場景二：單次呼叫傳址

function test($aa, &$bb) {
  if ($aa < $bb) { $bb--; echo $bb; }
}
$aa = 3; $bb = 6;
test($aa, $bb); // PHP 5.3/5.4 皆輸出 5
// test($aa, &$bb); // 5.4 報錯

場景三：內建函數歷史殘留

早期代碼常見 sort(&$arr)、array_push(&$arr, $v)、next(&$arr) 等。**所有內建函數現已統一由定義端決定傳址，呼叫端一律不可加 &**。

快速檢測與批量修正

1. 全專案搜尋 &\$（正則 &\s*\$）定位呼叫端傳址。
2. 確認對應函數定義已有 &，直接刪除呼叫端的 &。
3. 若函數定義**沒有** & 但呼叫端強制加 &，需評估是否真需傳址（通常不需），改為回傳值或物件封裝。

其他 PHP 5.4+ 重大變更提醒

• session_unregister()、session_is_registered()、session_register() 完全移除，改用 $_SESSION 陣列操作。
• safe_mode、register_globals、register_long_arrays 移除。
• htmlspecialchars()、htmlentities() 預設編碼從 ISO-8859-1 改為 UTF-8。
• array_combine()、array_diff() 等空陣列行為統一。

升級檢查清單

# 1. 掃描呼叫端傳址
grep -rn "&\$" --include="*.php" .
# 2. 檢查已移除函數
grep -rn "session_(unregister|is_registered|register)" --include="*.php" .
# 3. 執行測試套件 / 人工驗證核心流程

建議在預演環境完整跑測試後再上線，避免隱性 Bug 爆發。

1. 上一篇文章： PHP 實現 Word 轉 HTML：基於 COM 元件呼叫 Microsoft Word 完整方案
2. 下一篇文章： PHP Session 鎖機制與並發阻塞深度解析：原理、現象與解決方案

PHP 相關知識

PHP 正則提取中文實戰筆記：編碼陷阱與 PCRE u 修飾符正確姿勢

PHP 正則提取中文實戰筆記：編碼雙位元組陷阱與 PCRE

Ubuntu 10.04 配置 Nginx + PHP-FPM 完整指南

前言 本文記錄在 Ubuntu 10.04 上透過 PPA

XHGui 實戰指南：基於 XHProf 的 PHP 性能分析與優化利器

為什麼選擇 XHGui？ Profiling 是定位性能瓶頸

PHP 微信支付開發完整實戰指南（基於 ThinkPHP 3.2）

PHP 微信支付開發完整實戰指南 本文詳細記錄了基於 Thi