萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Apache 啟動報錯 undefined symbol: libiconv_open 解決方案

在整合 Apache 與 PHP 時,若啟動 Apache 出現 undefined symbol: libiconv_open 錯誤,通常是因為 PHP 編譯時未正確連結 libiconv 函式庫。本文記錄快速修復步驟,助您順利完成部署。

錯誤現象

執行 ./apachectl start 時,終端輸出如下錯誤:

httpd: Syntax error on line 57 of /usr/local/apache2/conf/httpd.conf:
Cannot load /usr/local/apache2/modules/libphp5.so into server:
/usr/local/apache2/modules/libphp5.so: undefined symbol: libiconv_open

根本原因

PHP 的 libphp5.so 模組依賴 libiconv 提供字元編碼轉換功能,但在編譯階段未將 -liconv 加入連結器旗標,導致執行期找不到符號。

解決步驟

  1. 進入 PHP 原始碼目錄:
    cd /path/to/php-source
  2. 重新執行 configure(保持原有參數即可)。
  3. 編譯時額外傳入 ZEND_EXTRA_LIBS 參數:
    make ZEND_EXTRA_LIBS='-liconv'
  4. 編譯完成後執行 make install 覆蓋原有模組。
  5. 重新啟動 Apache:
    /usr/local/apache2/bin/apachectl restart

驗證修復

啟動成功且無錯誤訊息,瀏覽器訪問 phpinfo() 頁面,確認 iconv 模組已載入且版本正常顯示。

補充說明

  • 若系統已安裝 libiconv 但位於非標準路徑(如 /usr/local/lib),可能需在 configure 時加入 --with-iconv=/usr/local。
  • CentOS/RHEL 系統可直接 yum install libiconv-devel 後再重新編譯 PHP。

依照上述步驟操作,即可徹底解決 Apache 啟動時的 undefined symbol: libiconv_open 問題,恢復 PHP 正常運作。

copyright © 萬盛學電腦網 all rights reserved