Discuz! X5.0 安裝升級注意事項

X5.0 下載安裝、升級前請大家先看此文再出手，內(nèi)容有點多，如果您想認真看完，絕對有收獲。

【環(huán)境要求】
從 X5.0 版本起，PHP 的最低要求已提升至 PHP8.0，如果您的 PHP 環(huán)境要求不滿足，請先升級到 PHP8.0。
如果您使用的是老版本的 Discuz!，版本低于 X3.5 的社區(qū)，請先升級到 X3.5 版本。已經(jīng)是 X3.5 版本的站點，可直接通過正常的安裝程序進行升級。同時，安裝程序內(nèi)置了工具箱，熟悉情況的老站長們就不必詢問為何 utility 目錄不見了。
詳閱：《Discuz! X5 安裝程序的優(yōu)化》

【關于升級】
不要到處找升級程序了，從 X5.0 開始安裝程序內(nèi)置升級程序，升級前請關閉站點、關閉所有插件。請詳細閱讀下面的內(nèi)容：

1、確保您的舊版本 Discuz! 必須為 X3.5 版本，如不滿足版本要求請先升級到此版本；
2、確保 UCenter 和 Discuz! 部署在一個數(shù)據(jù)庫中；
3、確保您已備份了數(shù)據(jù)庫和程序文件，將舊版本程序文件移動到其他目錄下；
4、將舊版本的配置文件 config/config_global.php、config/config_ucenter.php 復制到當前新版本的 config/ 目錄中；
5、點擊“下一步”開始升級；
6、升級完成后可以將舊版本中 source/plugin/ 目錄下的插件文件挑選后復制到新版本的對應目錄下、將 template/ 目錄下的模板文件挑選后復制到新版本的對應目錄下（不要復制 template/default/ 目錄）；
7、升級完成后 data/attachment/ 目錄以及 data/ 目錄下其他目錄請酌情復制；如舊版本應用涉及其他目錄中的文件，請自行咨詢相關開發(fā)者復制；

如果您對上面的內(nèi)容看著的確有點摸不著頭腦，可以觀看《DiscuzX5.0正式版升級安裝保姆教學》的視頻教程，用完全覆蓋法升級。官方說明里不會明確推薦覆蓋法的原因是由于 X5.0 架構的升級，文件目錄結構全變了，如果覆蓋你會分不清哪個是新文件哪個是舊文件，當然如果你壓根不關心（或者看不懂）的話無所謂。同時推薦閱讀《Nginx+Discuz! X3.5/X5 安裝出錯解決辦法》中的內(nèi)容調整服務器配置。

【插件模板兼容性】
1、插件方面，官方已經(jīng)在 X3.5 版本就強制要求必須兼容 PHP8.0，如果您使用的插件已經(jīng)做好兼容，那么恭喜，可以直接在 X5.0 中使用。否則，說明插件已經(jīng)落后了 2 個版本迭代了，請督促插件開發(fā)者速度適配 PHP8.0。
2、模板方面，嚴謹?shù)卣f X5.0 模板不可能 100% 兼容 X3.5 模板，但也不至于完全打不開的地步，可能使用某些新功能時會有異常。因此也請督促模板開發(fā)者速度適配 X5.0。

【升級補丁】
從 X5.0 起，官方在版本發(fā)布更新時將不再發(fā)布更新補丁程序，因為 X5.0 會自行提供補丁程序。當有新版本發(fā)布時，您可通過“管理中心”的“升級補丁”功能自行下載補丁文件后上傳覆蓋。若要使用此功能，請確保您的 PHP 已安裝 zip 擴展。如果您無法正常使用 X5.0 自帶的補丁下載功能，可重新下載官方發(fā)布的完整包覆蓋。
友情提示：官方發(fā)布包會按照 Tri-Monthly 的節(jié)奏更新，即每月 1 日、10 日、20 日固定時間更新，如變更的文件數(shù)量較少或無重大變更會跳過，歡迎站長們定時關注。

【UCenter 不再內(nèi)置】
從 X5.0 起，產(chǎn)品將不再內(nèi)置 UCenter 服務端，僅保留 UCenter 客戶端。有需要的用戶可在安裝 X5 前預先部署 UCenter 服務端（https://gitee.com/Discuz/UCenter）。不過，一般情況下這并無必要。即便您看重 UCenter 2.0 的 oAuth2 接口功能，X5 本身也已具備，而且目前能與 UCenter 對接的其他應用程序幾乎已不存在。此外，產(chǎn)品還內(nèi)置了多個 X5 站點相互登錄的功能。

【環(huán)境部署】
如果你確實對環(huán)境部署很小白，建議使用寶塔初始化 Discuz! X5 的環(huán)境（此處不是廣告哈），按照以下步驟安裝：
1、進入寶塔面板“軟件商店”；
2、選擇“PHP 8.x”，是 8+ 就可以，8.5 也是沒問題的，安裝后安裝擴展 opcache、redis；
3、選擇“Redis”，版本不限；
4、選擇“MySQL”，必須 5.7+（含），8.0 也是可以，看你服務器內(nèi)存情況；
5、選擇“Nginx”，版本越高越好不會有漏洞；
6、添加站點，上傳 upload 目錄中的代碼到網(wǎng)站根目錄。如需配置偽靜態(tài)規(guī)則，選擇“discuzx3”即可；
7、正常訪問網(wǎng)站，進行安裝，安裝完成當站點前后臺可以正常訪問后 config_global.php 修改以下內(nèi)容，開啟 Redis：

$_config['memory']['redis']['server'] = '127.0.0.1';
$_config['memory']['redis']['port'] = 6379;

其他 Redis 配置信息酌情修改。
友情提示：如果您服務器內(nèi)存足夠，請給 PHP 留出足夠多的內(nèi)存（php.ini 中 memory_limit 的設置）

【關于 config_global.php 的說明】
1、前臺和后臺可以同時登錄 2 個賬號
$_config['admincp']['mustlogin'] = 0 且 $_config['admincp']['synclogin_front'] = 0 的時候，如果社區(qū)前臺已經(jīng)登錄一個賬號的情況下，登錄“管理中心”可以登錄另一個賬號互不沖突；
2、僅掃碼登錄后臺
管理中心綁定了微信掃碼登錄后，如果設置 $_config['admincp']['qrcode_only'] = 1，那么后臺就只能掃碼才能登錄，不會出現(xiàn)用戶名密碼的輸入框，增加后臺的安全性；
3、后臺二次校驗
當 $_config['admincp']['validate']['method'] = 'default' 的時候設置 ['user'] 和 ['pass'] 可為管理中心增加一個額外校驗，校驗通過后才會顯示管理中心界面。更多二次校驗方法可以通過應用中心下載；
4、日志文件
$_config['log']['type'] = 'mysql' 說明日志文件默認是寫入數(shù)據(jù)庫的，如果您擔心數(shù)據(jù)庫膨脹過快可以改成 'file'；
5、官方 IP 庫
X5 默認啟用官方的 IP 庫，可以把 $_config['ipdb']['setting']['ipv4'] = 'system'。IPv6 同理，但是庫文件較大默認是不帶的，符合 IPv6 條件的服務器可以自行下載 https://gitee.com/Discuz/IP。

【關于 QQ 登錄、微信登錄相關插件】
由于 X5.0 系統(tǒng)級內(nèi)置了 QQ 登錄和微信登錄的關系，所以如果您之前在 X3.5 版本中使用了相關插件，無論是不是官方插件，如果希望使用 X5.0 內(nèi)置的第三方登錄功能，那么就需要把數(shù)據(jù)轉移到 X5.0 內(nèi)置的第三方登錄中，放棄使用以前的插件，因此您需要做以下操作：
1、關閉相關插件，注意是關閉不是卸載；
2、對于 “QQ 互聯(lián)” 插件，執(zhí)行下面的 SQL 語句，將用戶的數(shù)據(jù)轉移到系統(tǒng)表中

INSERT INTO `pre_common_member_account` (uid, atype, account)
SELECT uid, 6, conopenid
FROM `pre_common_member_connect`;

注意上面數(shù)字 6 為 QQ 登錄數(shù)據(jù)，微信(服務號)登錄是數(shù)字 4，pre_common_member_connect 為 QQ 互聯(lián)用戶表名稱。
對于其他第三方的 QQ 登錄、微信登錄插件，請和相關插件開發(fā)者確認后更改上面的 SQL 即可把數(shù)據(jù)導入到系統(tǒng)的第三方登錄數(shù)據(jù)中；
3、把之前填寫在插件的相關配置信息填寫到“第三方登錄”相關功能中去，新的跳轉地址留空提交，頁面刷新后自動會告訴你正確的新地址，自己到相關平臺更換即可；
4、測試無誤后可酌情卸載舊插件；
友情提示：我們鼓勵第三方插件作者制作比 X5.0 內(nèi)置功能更完善的 QQ 登錄、微信登錄插件，但必須是基于 X5.0 第三方登錄機制的全新結構登錄插件，舊版登錄插件按照 Discuz! 開放平臺新規(guī)已被禁止在 X5.0 版本中更新。

【地區(qū)設置數(shù)據(jù)空缺】
為了方便各位站長個性化配置適合自己社區(qū)的地區(qū)數(shù)據(jù)，從 X5.0 開始地區(qū)設置的數(shù)據(jù)默認是空的，如需要請下載此文件后在“地區(qū)設置”中導入。
district_default.txt (74.74 KB, 下載次數(shù): 451)

2026-3-19 11:07 上傳

點擊文件名下載附件

（數(shù)據(jù)較多導入時請耐心等待，可能需要1分鐘左右）

【舊版本的 X5.0 升級】
X5.0 正式發(fā)布前的所有版本都屬于開發(fā)者版范疇，請訪問下方鏈接下載 SQL 文件自行更新數(shù)據(jù)庫。
《X5 官方 Git 已經(jīng)變更為開源版的聲明》

【有相關服務嗎？】
官方的應用中心提供 代安裝服務 和 升級服務，歡迎咨詢。同時，如果您有任何 X5 相關問題、建議請發(fā)帖至 Discuz! X5 專區(qū)。

官方提供 安裝服務 和 升級服務，歡迎咨詢。

??占位攜全新X5模板一起支持 Discuz! X5 發(fā)布!!! ??????

全新X5系列模板, 自帶H5自適應手機版!

克米設計-伯樂頭條模板
https://addon.dismall.com/templates/comiis_bole.html

克米設計-簡約19樓模板
https://addon.dismall.com/templates/comiis_x19lou.html

克米設計-簡約時尚模板
https://addon.dismall.com/templates/comiis_vogue.html

??

好家伙，真來了呀。看來得先把3.5的插件升級一下了

前排占位??，展望未來

前排支持一下，不錯不錯

已經(jīng)準備好了，明天發(fā)布？????期待正式版

3.8是吉利的日子

注定與我無緣啊，我PHP8開啟網(wǎng)站空白，3.5版本

什么時候發(fā)布？有具體時間表嗎？

現(xiàn)在是預覽版，按理來說還有一個測試版吧，距離真正可以用到運營的正式版，應該在5月1日左右發(fā)布吧（按“營銷借勢”）角度:lol