PHP CLI 模式配置文件加載差異排查：多版本共存導致的擴展失效案例

PHP CLI 模式配置文件加載差異排查：多版本共存導致的擴展失效案例

生產環境常見多 PHP 版本共存，CLI 模式下不同用戶加載不同配置文件導致擴展加載失效。本文記錄一次 protobuf 擴展在 root 與普通用戶下表現不一致的完整排查過程。

現象描述

• 普通用戶執行 php protoc-php.php ... 正常
• root 用戶執行報錯：Unable to load dynamic library 'protobuf.so' - undefined symbol: zend_new_interned_string
• 加上 sudo 後更多擴展報錯（curl、gd、json、redis 等均報 undefined symbol 或 cannot open shared object file）

排查關鍵步驟

1. 對比 php.ini 路徑：

   $ php -i | grep 'php.ini'
   # 普通用戶：/usr/local/php/lib/php.ini
   
   $ sudo php -i | grep 'php.ini'
   # root 用戶：/etc/php.ini

2. 對比 PHP 版本：

   $ which php
   # /usr/local/bin/php
   
   $ sudo which php
   # /usr/bin/php

根因分析

• 系統預裝 PHP 5.3.3 於 /usr/bin/php，/etc/php.ini 配置
• 編譯安裝 PHP 5.4.6 於 /usr/local/bin/php，/usr/local/php/lib/php.ini 配置
• 普通用戶 PATH 優先 /usr/local/bin，使用新版本
• root 用戶 secure_path 或環境變量導致優先 /usr/bin，使用舊版本
• 舊版本 php.ini 嘗試加載新版本編譯的擴展（protobuf.so 等），API 版本不匹配（20090626 vs 20100525）導致符號缺失

解決方案

1. 統一可執行文件（推薦）：

   mv /usr/bin/php /usr/bin/php.bak
   cp /usr/local/bin/php /usr/bin/php

   驗證：sudo php -v 顯示 5.4.6，擴展正常加載。
2. 修正 root 環境 PATH： 編輯 /etc/sudoers（visudo），確保 Defaults secure_path 包含 /usr/local/bin 且優先級高。
3. 顯式指定 PHP 路徑： 腳本中使用 /usr/local/bin/php 絕對路徑，或設置別名 alias php=/usr/local/bin/php。

最佳實踐建議

核心教訓

「配置文件不一致」往往是「可執行文件版本不一致」的表象。 遇到 CLI 行為差異，首要動作永遠是對比 which php 和 php -v，而非盯著 php.ini 改參數。

1. 上一篇文章： PHP + MySQL + jQuery 實現微博發布系統：後端邏輯完整實現
2. 下一篇文章： PHP 面試必考：文件後綴獲取五種寫法與目錄遞歸遍歷實現

PHP 相關知識

微信公眾號自定義菜單開發全流程指南

從零構建微信自定義菜單：類型解析、創建 API 與測試技巧

PHP 生成 Word 文檔 (.doc) 簡單實現：HTML 內容直接另存為

核心原理 Word 97-2003 (.doc) 可直接解析

WampServer 修改默認網站目錄完整教程：httpd.conf、wampmanager.ini、wampmanager.tpl 三文件聯動

WampServer 修改默認網站目錄完整教程：httpd.

海洋 CMS 響應式影視網站模板：支援手機 WAP、iPad、PC 三端自適應

海洋 CMS 響應式影視網站模板：支援手機 WAP、iPad