PHP 連結階段報錯：未定義符號參考解決方案

錯誤現象

執行 make 連結階段出現 undefined reference 錯誤，提示某些符號找不到定義。

排查步驟

1. 檢查連結指令：確認所有必要函式庫（-l 參數）皆正確包含且路徑正確。
2. 常見缺失函式庫：
   • -ldl（動態載入庫）常被遺漏
   • 資料庫客戶端庫（如 -lmysqlclient、-lpq、-loci）版本不符或路徑錯誤
3. Apache 1.2.x 專屬：若編譯 Apache 1.2.x，需在 Apache Configuration 檔案的 EXTRA_LIBS 加入必要庫，並重新執行 Apache ./Configure。

經驗分享

部分開發者回報：將 -ldl 放在 libphp3.a **之前** 可解決連結順序問題。GNU ld 對庫順序敏感，依賴關係的庫必須放在被依賴者之後。

現代建議

• 使用 pkg-config --libs 自動獲取正確連結參數。
• 改用動態模組（--with-apxs2）避免靜態連結複雜度。
• PHP 7+ 建置系統已大幅改善依賴解析，此類問題較少見。