ECShop 在 PHP 5.5+ 高版本兼容性修復指南：Deprecated 錯誤與引用傳遞問題完美解決

常見報錯類型

修復一：preg_replace /e 修飾符 → preg_replace_callback

文件：includes/cls_template.php 第 300 行左右

// 原代碼
return preg_replace("/{([^\}\{\n]*)}/e", "\$this->select('\\1');", $source);

// 修復為
return preg_replace_callback(
    "/{([^\}\{\n]*)}/",
    function ($matches) {
        return $this->select($matches[1]);
    },
    $source
);

修復二：array_shift 引用傳遞問題

文件：includes/cls_template.php 第 422 行左右

// 原代碼
$tag_sel = array_shift(explode(' ', $tag));

// 修復為
$tag_arr = explode(' ', $tag);
$tag_sel = array_shift($tag_arr);

修復三：靜態調用非靜態方法

文件：includes/lib_base.php 第 346 行

// 原代碼
return cls_image::gd_version();

// 修復為
$image = new cls_image();
return $image->gd_version();

修復四：會員整合接口兼容

文件：includes/modules/integrates/ 下各文件

// 將 __construct 移到類開頭，舊構造函數重命名或刪除
class cls_sql_dump {
    function __construct(&$db, $max_size = 0) {
        $this->db = $db;
        $this->max_size = $max_size;
    }
    
    // 靜態方法聲明
    static function get_random_name() { ... }
}

修復六：PHP 8.1+ 額外兼容

// 1. 隱式兼容性：strpos/strstr 等 needle 為非字符串
// 修復：strpos($haystack, (string)$needle)

// 2. htmlentities 默認編碼變更
htmlentities($str, ENT_QUOTES, 'UTF-8'); // 顯式指定編碼

// 3. 動態屬性棄用 (8.2+)
// 類中聲明屬性或使用 #[AllowDynamicProperties]

// 4. 彌補缺失函數
if (!function_exists('get_magic_quotes_gpc')) {
    function get_magic_quotes_gpc() { return false; }
}

驗證清單

1. 關閉 display_errors，開啟 log_errors 觀察 error_log
2. 逐頁測試：首頁、分類、商品詳情、購物車、結算、後台登錄
3. 檢查模板編譯緩存：temp/caches/ 清空後重新生成
4. 支付/物流/會員整合插件逐個測試

長期建議

• ECShop 官方已停止維護，建議遷移至 ECShopX、OpenMall 或 Laravel/ThinkPHP 重構
• 若必須維護，鎖定 PHP 7.4 版本（安全支持至 2022/11，可用第三方長期支持）
• 建立自動化測試覆蓋核心流程，防止版本升級引入回歸