萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 5.4+ 解決 Dedecms 後台登入空白:移除已棄用 session_register 兼容寫法

Dedecms 早期版本使用 session_register() 註冊 Session 變數,該函式於 PHP 5.3 棄用、PHP 5.4 移除,導致 PHP 5.4+ 環境下後台登入直接白屏。本文給出 include/userlogin.class.php 精確修改方案,並說明為何不建議單純加 @ 抑制錯誤。

問題根因

// 原始碼(約第 180 行附近)
@session_register($this->keepUserIDTag);
$_SESSION[$this->keepUserIDTag] = $this->userID;
// ... 重複 6 次

session_register() 會嘗試將全域變數註冊到 $GLOBALS 並建立同名 Session,PHP 5.4 移除後直接拋出 Fatal Error,被 @ 隱藏卻中斷腳本執行,造成白屏。

最小修正版(保持原邏輯、相容 PHP 5.4~8.x)

<?php
// 替換原有 6 組 session_register 區塊為:
if (!isset($_SESSION[$this->keepUserIDTag])) {
    $_SESSION[$this->keepUserIDTag] = $this->userID;
}
if (!isset($_SESSION[$this->keepUserTypeTag])) {
    $_SESSION[$this->keepUserTypeTag] = $this->userType;
}
if (!isset($_SESSION[$this->keepUserChannelTag])) {
    $_SESSION[$this->keepUserChannelTag] = $this->userChannel;
}
if (!isset($_SESSION[$this->keepUserNameTag])) {
    $_SESSION[$this->keepUserNameTag] = $this->userName;
}
if (!isset($_SESSION[$this->keepUserPurviewTag])) {
    $_SESSION[$this->keepUserPurviewTag] = $this->userPurview;
}
if (!isset($_SESSION[$this->keepAdminStyleTag])) {
    $_SESSION[$this->keepAdminStyleTag] = $adminstyle ?? 'dedecms';
}

// Cookie 寫入保持不變
PutCookie('DedeUserID', $this->userID, 3600 * 24, '/');
PutCookie('DedeLoginTime', time(), 3600 * 24, '/');

完整替換區塊對照(含原作者提供的 global 變數宣告)

<?php
global $admincachefile, $adminstyle;
if (empty($adminstyle)) $adminstyle = 'dedecms';

// 原:@session_register($this->keepUserIDTag);
$_SESSION[$this->keepUserIDTag] = $this->userID;
// 原:@session_register($this->keepUserTypeTag);
$_SESSION[$this->keepUserTypeTag] = $this->userType;
// 原:@session_register($this->keepUserChannelTag);
$_SESSION[$this->keepUserChannelTag] = $this->userChannel;
// 原:@session_register($this->keepUserNameTag);
$_SESSION[$this->keepUserNameTag] = $this->userName;
// 原:@session_register($this->keepUserPurviewTag);
$_SESSION[$this->keepUserPurviewTag] = $this->userPurview;
// 原:@session_register($this->keepAdminStyleTag);
$_SESSION[$this->keepAdminStyleTag] = $adminstyle;

PutCookie('DedeUserID', $this->userID, 3600 * 24, '/');
PutCookie('DedeLoginTime', time(), 3600 * 24, '/');

為何不建議「註冊鍵名 = 鍵名」的寫法?

原文提供的替換碼中出現 $_SESSION[$this->keepUserIDTag] = $this->keepUserIDTag; 這類「值等於鍵名」的賦值,**極大機率是筆誤**,會導致 Session 值錯誤(存成字串 keepUserIDTag 而非實際 userID)。請以 最小修正版 為準。

驗證步驟

  1. 修改 include/userlogin.class.php 並儲存。
  2. 清除瀏覽器 Cookie / 重啟瀏覽器。
  3. 重新訪問 /dede/login.php 登入後台,確認不再白屏並能正常進入管理介面。
長期建議:Dedecms 官方已停止更新,建議規劃遷移至現代框架(Laravel/ThinkPHP)或至少升級至 PHP 8.1 相容分支(如 DedeCMS-V5.7-UTF8-SP2),徹底移除 session_register 等棄用 API。
copyright © 萬盛學電腦網 all rights reserved