Discuz! X3.4 升级到 Discuz! X3.5 的升级程序及教程

zidon

一、Discuz! X3.4 升级到 Discuz! X3.5 的升级程序

项目地址：https://gitee.com/oldhuhu/DiscuzX34235/tree/dev/
下载地址：https://gitee.com/oldhuhu/DiscuzX34235/repository/archive/dev.zip

说明：该程序为  Discuz! X3.5 开发团队维护的升级项目。因 Discuz! X3.5 正式版目前尚未发布，所以暂时不建议任何对生产站点的升级尝试，对生产站点升级前请假设在任何时间节点（含升级完成后）遇到的任何问题的解决方案均为恢复升级前的数据库备份并回退老版本！

二、Discuz! X3.4 升级到 Discuz! X3.5 的升级教程

从 Discuz! X3.2 - X3.4 或其他基于此版本开发的未进行数据库结构变更的修改版本进行升级的升级流程：

1、备份数据库和程序文件，请不要忘记备份 UCenter 数据库和程序文件。

2、进入您的 UCenter 所在目录（默认为 论坛根目录/uc_server），建立文件夹 old，将 UCenter 目录下除 data 目录以外的其他文件夹移动进入 old 目录中。如移动文件中存在包括但不限于 .htaccess 或 .user.ini 等的网站配置文件，请不要移动。

3、上传 UCenter 1.7.0 程序（压缩包中 upload/uc_server 目录中的文件）， 如上传时候提示覆盖目录，请选择 “是”。

4、上传 update_ucenter_adult.php 到 UCenter 所在目录（默认为 uc_server ）下的 install 目录，并删除 UCenter 所在目录下 data 目录的 update.lock 文件。

5、访问 UCenter 所在目录下 install 目录下的 update_ucenter_adult.php 并参照提示进行升级即可。升级时间随着数据的大小和服务器性能而变。

6、将除 data, config 目录，和 UCenter 所在目录（默认为 uc_server，如果该目录不在论坛根目录下的话可排除此项）以外的其他文件夹移动进入 old 目录中。如移动文件中存在包括但不限于 .htaccess 或 .user.ini 等的网站配置文件，请不要移动。

7、将 old/source/plugin 和 old/template 目录下除 default 以外的目录，移动回 source 和 template 目录下面（也可在上一步移动文件时，直接在原位置保留这部分文件）。

8、上传 Discuz! X3.5 程序（压缩包中 upload 目录中的文件）， 如上传时候提示覆盖目录，请选择 “是”。

9、上传 update_adult.php 到 Discuz! 所在目录下 install 目录，并删除 Discuz! 所在目录下 data 目录的 update.lock 文件。

10、访问 Discuz! 所在目录下 install 目录下的 update_adult.php 并参照提示进行升级即可。升级时间随着数据的大小和服务器性能而变。

三、Discuz! X3.4 升级到 Discuz! X3.5 的升级注意事项

1、请在升级之前做好站点全量数据（含数据库、文件）的备份操作，并小心操作。

2、由于 UCenter 1.7.0 更新了数据库编码，对于您当前数据库内不支持 utf8mb4_unicode_ci 编码的用户名，UCenter 程序会将用户重命名为 15 位随机字符，请您自行在升级成功后在 UCenter 后台查询用户更名日志和通知日志，保证更名通知已经成功下发到各应用后再进行应用升级操作（对于 UCenter 对接其他非 Discuz! X 系统的站点，请确认应用正确实现了 UCenter 通知改名接口。），并在升级完成后通过站点公告、电子邮件、手机短信等多种方式手动通知此类用户通过更名卡等方式自行修改用户名。如果需要通过更名卡方式修改用户名的站点，请在转换完成后手动在后台配置道具中心的更名卡，以支持上述用户自助改名。

3、由于 UCenter 1.7.0 更新了数据库编码，为了防止安全提问内的中文影响用户登录，因此将为您清空安全提问，请将此情况如实告知用户，并要求用户在登录时请不要输入安全提问。如您希望自行编写兼容代码，请自行在后续流程选择不清空用户的安全提问。

4、由于 UCenter 1.7.0 更新了数据库编码，对于极个别采用非标准字符集用作密码的账号可能会出现密码错误的情况，遇到此情况请引导用户选择找回密码并按提示操作找回密码，重新设置密码后即可重新登录。

5、由于 Discuz! X3.5 更新了 IP 黑名单存储方式，因此对于系统内当前批量封禁的 IP 地址，只支持 IPv4 地址规则，且地址掩码为 8 的整数倍且不大于 32 的存量数据，数据库内原有数据将自动删除。建议您在升级前导出原规则，如有需要请在升级后按新系统规则重新配置。

6、由于 Discuz! X3.5 对 Session 、 IP 黑名单功能进行了优化，此类优化由于依赖部分高级特性，因此不支持除 Redis 外的其它内存缓存库。因此如果您的站点流量较大，建议您卸载原有内存缓存库，更换内存缓存库为 Redis ，这样可以最大程度的优化您站点的运行速度，并且不依赖数据库内的 HEAP 表。

7、由于 Discuz! X3.5 对站点功能开关功能进行了优化，升级完成后将为您打开站点所有功能，请在升级完成后自行评估您站点运营具体需要开启的功能，并根据站点运营需求关闭不需要的功能。

8、由于 Discuz! X3.5 更新了数据库编码和默认模板，升级程序会将程序数据表和插件数据表转换至 utf8mb4 ，并试图对您的插件文件进行转码，同时在升级完成后将关闭所有非系统插件并恢复默认风格。请您在升级完成后对您的插件进行验证，对于多数插件、模板而言，在转换之后可在 utf8mb4 环境下继续运行或进行少量改造后继续运行，少量插件、模板可能需要自行对文件做转码，甚至进行一定程度的改造才能够正常在 Discuz! X3.5 上运行。

9、请不要重复执行升级程序，重复执行可能导致未知的问题，如遇升级出错请不要关闭页面，尝试根据提示解决后刷新继续，如无法实现请恢复备份重新开始升级。

四、Discuz! X3.4 升级到 Discuz! X3.5 的其他相关事项

1、请务必在升级之前备份数据库和程序文件，否则可能对您的站点带来不可逆的严重伤害，请务必注意。

2、请提前准备足够的硬盘空间和时间用于升级，推荐 UTF-8 编码版本对每 1GB 数据库预留 2-3GB 空闲磁盘空间和 1-2 小时升级时间预留，对于其他编码版本推荐在上述基础上增加 1-2 倍的空闲磁盘空间和升级时间预留，对于安装了大量插件或进行了大量二次开发的站点推荐在上述基础上增加 1-2 倍的空闲磁盘空间和升级时间预留。

3、对于超大数据库站点，数据库升级可能因超时而失败，请调整 PHP 的超时时间后，根据 https://gitee.com/oldhuhu/Discuz ... 20c7e88e11c6c87103d 调整 MySQL 超时时间，需要注意的是此功能需要 MySQL 的 SUPER privilege 权限。

4、请务必在升级之前检查 UCenter 到各个应用的通信是否正常，并且请确认对接其他非 Discuz! X 系统的应用正确实现了 UCenter 通知改名接口，如果上述两项未实现，请自行调试通信和实现通知改名接口，否则可能导致 UCenter 升级无法正确完成。

5、建议建站时使用较低版本软件的站点、中大型、超大型站点或二次开发、第三方插件模板较多的站点进行一次或多次本地升级演练，并准备足够可行的回退方案和回退时间，以免升级时因意外导致升级失败且无法按时回退导致的问题。

6、本升级程序不支持含有数据库从服务器的站点和进行了数据库分布部署站点的升级。如您的站点含有数据库从服务器请在升级期间通过配置文件暂时屏蔽从服务器，如您的站点进行了数据库分布部署请通过脚本手动进行升级。

7、如数据库内单个表内容较多，且 MySQL 版本低于 5.7.5 ，建议升级 MySQL 到 5.7.5 或更高版本（推荐升级 MySQL 8），或者按照 https://gitee.com/oldhuhu/DiscuzX34235/issues/I3IUOR 的建议配置较大的 innodb_log_file_size ，否则可能会导致升级异常中断。

zpuer

Discuz! X3.4 升 Discuz! X3.5 也是挺麻烦的，不知道这个程序是升级到 Discuz! X3.5 哪个版本？升级程序是也随 Discuz! X3.5 每日构建升级的吗？

zidon

是实时更新到Discuz! X3.5的每日构建的最新版本的，这个升级项目是由老周部落跟进更新的。

nihaolai

好好好好好好好好好好好好好好好好好顶