在整合 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 加入連結器旗標,導致執行期找不到符號。
cd /path/to/php-sourceconfigure(保持原有參數即可)。ZEND_EXTRA_LIBS 參數:make ZEND_EXTRA_LIBS='-liconv'make install 覆蓋原有模組。/usr/local/apache2/bin/apachectl restart啟動成功且無錯誤訊息,瀏覽器訪問 phpinfo() 頁面,確認 iconv 模組已載入且版本正常顯示。
libiconv 但位於非標準路徑(如 /usr/local/lib),可能需在 configure 時加入 --with-iconv=/usr/local。yum install libiconv-devel 後再重新編譯 PHP。依照上述步驟操作,即可徹底解決 Apache 啟動時的 undefined symbol: libiconv_open 問題,恢復 PHP 正常運作。