Discuz! X5.0 安裝升級(jí)注意事項(xiàng)

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

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

【關(guān)于升級(jí)】
下面為安裝程序中對(duì)升級(jí)方法的原文，供一些尚未開(kāi)始升級(jí)的站長(zhǎng)參考：

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

如果您對(duì)上面的內(nèi)容看著的確有點(diǎn)摸不著頭腦，可以觀看《DiscuzX5.0正式版升級(jí)安裝保姆教學(xué)》的視頻教程，用完全覆蓋法升級(jí)。官方說(shuō)明里不會(huì)明確推薦覆蓋法的原因是由于 X5.0 架構(gòu)的升級(jí)，文件目錄結(jié)構(gòu)全變了，如果覆蓋你會(huì)分不清哪個(gè)是新文件哪個(gè)是舊文件，當(dāng)然如果你壓根不關(guān)心（或者看不懂）的話無(wú)所謂。再?lài)Z叨幾句，從 X3.5 升級(jí)時(shí)為了避免插件干擾，可以先關(guān)閉所有插件后再升級(jí)。同時(shí)推薦閱讀《Nginx+Discuz! X3.5/X5 安裝出錯(cuò)解決辦法》中的內(nèi)容調(diào)整服務(wù)器配置。

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

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

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

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

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

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

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

【關(guān)于 QQ 登錄、微信登錄相關(guān)插件】
由于 X5.0 系統(tǒng)級(jí)內(nèi)置了 QQ 登錄和微信登錄的關(guān)系，所以如果您之前在 X3.5 版本中使用了相關(guān)插件，無(wú)論是不是官方插件，如果希望使用 X5.0 內(nèi)置的第三方登錄功能，那么就需要把數(shù)據(jù)轉(zhuǎn)移到 X5.0 內(nèi)置的第三方登錄中，放棄使用以前的插件，因此您需要做以下操作：
1、關(guān)閉相關(guān)插件，注意是關(guān)閉不是卸載；
2、對(duì)于 “QQ 互聯(lián)” 插件，執(zhí)行下面的 SQL 語(yǔ)句，將用戶(hù)的數(shù)據(jù)轉(zhuǎn)移到系統(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ù)，微信(服務(wù)號(hào))登錄是數(shù)字 4，pre_common_member_connect 為 QQ 互聯(lián)用戶(hù)表名稱(chēng)。
對(duì)于其他第三方的 QQ 登錄、微信登錄插件，請(qǐng)和相關(guān)插件開(kāi)發(fā)者確認(rèn)后更改上面的 SQL 即可把數(shù)據(jù)導(dǎo)入到系統(tǒng)的第三方登錄數(shù)據(jù)中；
3、把之前填寫(xiě)在插件的相關(guān)配置信息填寫(xiě)到“第三方登錄”相關(guān)功能中去，新的跳轉(zhuǎn)地址留空提交，頁(yè)面刷新后自動(dòng)會(huì)告訴你正確的新地址，自己到相關(guān)平臺(tái)更換即可；
4、測(cè)試無(wú)誤后可酌情卸載舊插件；
友情提示：我們鼓勵(lì)第三方插件作者制作比 X5.0 內(nèi)置功能更完善的 QQ 登錄、微信登錄插件，但必須是基于 X5.0 第三方登錄機(jī)制的全新結(jié)構(gòu)登錄插件，舊版登錄插件按照 Discuz! 開(kāi)放平臺(tái)新規(guī)已被禁止在 X5.0 版本中更新。

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

2026-3-19 11:07 上傳

點(diǎn)擊文件名下載附件

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

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

【有相關(guān)服務(wù)嗎？】
官方的應(yīng)用中心提供 代安裝服務(wù) 和 升級(jí)服務(wù)，歡迎咨詢(xún)。同時(shí)，如果您有任何 X5 相關(guān)問(wèn)題、建議請(qǐng)發(fā)帖至 Discuz! X5 專(zhuān)區(qū)。

官方提供 安裝服務(wù) 和 升級(jí)服務(wù)，歡迎咨詢(xún)。

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

全新X5系列模板, 自帶H5自適應(yīng)手機(jī)版!

克米設(shè)計(jì)-伯樂(lè)頭條模板
https://addon.dismall.com/templates/comiis_bole.html

克米設(shè)計(jì)-簡(jiǎn)約19樓模板
https://addon.dismall.com/templates/comiis_x19lou.html

克米設(shè)計(jì)-簡(jiǎn)約時(shí)尚模板
https://addon.dismall.com/templates/comiis_vogue.html

??

好家伙，真來(lái)了呀?？磥?lái)得先把3.5的插件升級(jí)一下了

前排占位??，展望未來(lái)

前排支持一下，不錯(cuò)不錯(cuò)

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

3.8是吉利的日子

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

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

現(xiàn)在是預(yù)覽版，按理來(lái)說(shuō)還有一個(gè)測(cè)試版吧，距離真正可以用到運(yùn)營(yíng)的正式版，應(yīng)該在5月1日左右發(fā)布吧（按“營(yíng)銷(xiāo)借勢(shì)”）角度:lol