PHP 版本相容性導致 ShopEx 4.8.5 安裝失敗的完整排查與解決方案

ShopEx 4.8.5 為老舊電商系統，強依賴 Zend Optimizer 加密擴展，而 PHP 5.3+ 已移除 Zend Optimizer 改用 Zend Guard Loader，且編譯版本 (VC6/VC9、TS/NTS) 需精確匹配。本文記錄完整踩坑過程與最終解決方案。

版本相容性對照表

踩坑時間軸

1. 嘗試 PHP 5.3.5 (WAMP 2.1e, VC6 TS) → 無法載入 Zend Guard Loader (需 VC9 NTS)。
2. 嘗試 PHP 5.3.4 (WAMP 2.1d 64bit, VC9 TS) → TS 版不支援 Guard Loader。
3. 手動編譯/下載 PHP 5.3 VC9 NTS → Guard Loader 載入成功，但 ShopEx 報錯「Zend 版本過高無法解析」。
4. 結論：ShopEx 4.8.5 加密格式僅相容 Zend Optimizer 3.3.3，必須退回 PHP 5.2.x + VC6 TS 環境。

最終可行環境組合

• PHP 5.2.17 (VC6, Thread Safe) — 官方最後一個 5.2 版本
• Zend Optimizer 3.3.3 (對應 PHP 5.2.x)
• Apache 2.2 (VC6 編譯版，搭配 PHP 5.2 TS 模組)
• MySQL 5.1.x (見下文)

關鍵配置步驟

1. php.ini 載入 Zend Optimizer

[Zend]
zend_optimizer.optimization_level=15
zend_extension_manager.optimizer_ts="C:/php/zendOptimizer/lib/Optimizer-3.3.3"
zend_extension_ts="C:/php/zendOptimizer/lib/ZendExtensionManager.dll"
zend_extension="C:/php/zendOptimizer/lib/ZendExtensionManager.dll"

路徑請依實際安裝位置調整，重啟 Apache 後 phpinfo() 應顯示 "Zend Optimizer v3.3.3"。

2. MySQL 版本陷阱

安裝過程卡在建立資料庫步驟，檢查發現僅建立 97 張表 (正常應 109 張)。

原因： MySQL 5.5+ 的 sql_mode 預設較嚴格 (如 STRICT_TRANS_TABLES)，導致舊版 SQL 語句 (如 INSERT INTO ... VALUES ('') 對整數欄位) 失敗靜默跳過。

解決： 降級至 MySQL 5.1.55 或修改 my.ini 移除嚴格模式：

[mysqld]
sql_mode=""

完整安裝檢查清單

1. PHP 5.2.17 VC6 TS + Zend Optimizer 3.3.3
2. Apache 2.2 VC6 (載入 php5apache2_2.dll)
3. MySQL 5.1.x (或 5.5+ 設定 sql_mode="")
4. php.ini: register_globals=On (ShopEx 需求), magic_quotes_gpc=On
5. 目錄寫入權限: config.php, statics/, temp/, uploads/
6. 安裝鎖檢查: 刪除 install/install.lock 重新安裝

長期維護建議

ShopEx 4.8.5 已停止維護多年，存在已知安全漏洞 (SQL注入、XSS、文件上傳繞過)。強烈建議 規劃遷移至現代電商框架 (如 ShopEx 6/ECShopX、Magento 2、OpenCart、Shopify 或自研 Laravel/Go 方案)，並在遷移前完成資料遷移驗證與壓力測試。