tencentci/discuz

Discuz! X3.5+ 每月构建【破坏性变更警告】

重要提示

数据库变更警告

2月27日合并的代码中需跟进数据库修改，否则会导致用户首次可登录、第二次无法登录！
存量X3.5网站更新代码后，需执行以下SQL进行数据库升级（uc_可能为pre_ucenter_，具体参照站点设置）：

sql
ALTER TABLE uc_members MODIFY COLUMN password varchar(255) NOT NULL DEFAULT '', MODIFY COLUMN salt varchar(20) NOT NULL DEFAULT ''

使用风险提示

• 不建议普通用户下载本分支代码
• 强烈建议无技术能力用户不要在非测试环境使用3.5！！！

在生产环境盲目使用及更新Discuz! X3.5（开发中版本）可能造成：

• 数据库结构错误导致数据丢失
• 部分功能故障导致网站无法运行
• 漏洞造成服务器遭到入侵

包括但不限于以上严重后果，请确认技术能力足以驾驭后再使用！

数据库结构更新提示

3.5的数据库结构会随时更新，已有用户每次更新代码时务必同步安装目录下sql文件的所有变更！

---

基于Docker的使用

镜像拉取

shell
docker pull tencentci/discuz

镜像运行

Discuz! X3.5项目代码位于容器中/var/www/html，可将此目录代码复制到宿主机后映射至容器完成持久化挂载，步骤如下：

1. 运行临时容器

shell
docker run --rm --name discuz -it -p 80:80 -d tencentci/discuz

2. 复制代码到宿主机

shell
docker cp discuz:/var/www/html/ $PWD/

完成后执行docker stop discuz销毁临时容器

3. 运行并使用容器

shell
docker run -it --name discuz -p 80:80 -p 443:443 -v /var/www/html/:$PWD/html/ -d tencentci/discuz

---

3.5版本说明

1. 数据库相关变更

3.5版本支持InnoDB与MyISAM两种数据库引擎，均不再支持utf8编码，转而支持utf8mb4编码。

1.1 数据库表结构变更

参考 https://gitee.com/oldhuhu/DiscuzX34235/blob/master/scheme/scheme-change-without-data-loss.sql%EF%BC%9A

• 所有IP地址字段改为varchar(45)类型
• 记录IP地址处增加端口号记录
• pre_common_banned表新增upperip和lowerip两个VARBINARY(16)字段，记录IP封禁范围最大/最小值
• 部分字段扩容（如INT→BIGINT，TEXT→MEDIUMTEXT）
• 为支持IPv6，移除所有IP1/IP2/IP3/IP4字段定义（参考https://gitee.com/oldhuhu/DiscuzX34235/blob/master/scheme/scheme-change-drop-columns.sql%EF%BC%89

1.2 InnoDB引擎相关变更

参考 https://gitee.com/oldhuhu/DiscuzX34235/blob/master/scheme/scheme-change-innodb.sql%EF%BC%9A

• pre_common_member_grouppm表新增索引
• pre_forum_post表取消position的auto_increment属性

配置文件新增数据库引擎配置项，升级用户需正确设置，否则可能导致发帖功能异常：

php
/*
 * 数据库引擎，根据实际数据库引擎设置，3.5默认innodb，之前版本为myisam
 * 从3.4升级且未转换引擎的用户需设为myisam
 */
$_config['db']['common']['engine'] = 'innodb';

1.3 utf8mb4相关变更

• MyISAM引擎：因1000字节索引长度限制，需重新定义部分索引（参考https://gitee.com/oldhuhu/DiscuzX34235/blob/master/scheme/scheme-change-myisam-utf8mb4.sql%EF%BC%89
• 所有表统一使用utf8mb4编码与utf8mb4_unicode_ci排序规则（参考https://gitee.com/oldhuhu/DiscuzX34235/blob/master/scheme/scheme-change-charset.sql%EF%BC%89

2. IP相关变更

为支持IPv6，3.5版本做了以下调整：

2.1 IP地址库

系统支持多地址库，通过配置文件选择：

php
$_config['ipdb']['setting']['fullstack'] = '';    // 全栈IP库，优先级最高
$_config['ipdb']['setting']['default'] = '';     // 默认IP库，优先级最低
$_config['ipdb']['setting']['ipv4'] = 'tiny';    // IPv4库，留空使用默认
$_config['ipdb']['setting']['ipv6'] = 'v6wry';   // IPv6库，留空使用默认

地址库对应class为ip_<地址库名称>，位于source/class/ip目录，可自定义扩展配置：

php
// 扩展IP库配置格式
$_config['ipdb']['扩展ip库名称']['设置项名称'] = '值';
// 示例
$_config['ipdb']['redis_ip']['server'] = '172.16.1.8';

系统内置IPv4和IPv6库。

2.2 IP封禁

• 不再使用*作为通配符，改用子网掩码(CIDR)指定封禁范围
• 封禁配置保存在pre_common_banned表，用户每次访问触发检查（带索引SQL查询，效率较高）
• 可启用Redis缓存提升性能，或关闭功能使用外部防火墙：

php
$_config['security']['useipban'] = 1; // 是否开启IP允许/禁止功能，高负载站点建议疏解至HTTP Server/CDN等

2.3 IP地址获取

默认仅信任REMOTE_ADDR，可通过配置扩展获取方式：

php
/**
 * IP获取扩展
 * 为空使用默认体系，非空调用source/class/ip/getter_值.php的get方法
 * 系统提供dnslist(IP反解析域名白名单)、serverlist(IP白名单，支持CIDR)、header扩展
 * 扩展配置格式：$_config['ipgetter']['IP获取扩展名称']['设置项名称'] = '值'
 */
$_config['ipgetter']['setting'] = '';
$_config['ipgetter']['header']['header'] = 'HTTP_X_FORWARDED_FOR';
$_config['ipgetter']['iplist']['header'] = 'HTTP_X_FORWARDED_FOR';
$_config['ipgetter']['iplist']['list']['0'] = '127.0.0.1';
$_config['ipgetter']['dnslist']['header'] = 'HTTP_X_FORWARDED_FOR';
$_config['ipgetter']['dnslist']['list']['0'] = 'comsenz.com';

3. 缓存

3.5增强了Redis缓存支持，使用Redis时完全消除内存表依赖：

• session内存表功能由Redis实现
• setting分批按需加载
• IP封禁检测结果缓存

提示：PHP认为实现ArrayAccess接口的对象不等同于数组，原有依赖array_key_exists的插件或二次开发需取消依赖。
注：以上增强对memcached无效。

4. 功能开关

支持几乎所有功能开关，管理员可关闭论坛仅使用门户，详见https://gitee.com/Discuz/DiscuzX/pulls/291%E3%80%82

5. 其它改动

• 新增测试框架，位于upload/tests，测试用例可在upload/tests/class添加
• 安装程序最后一步日志实时显示
• 仅支持mysqli驱动，不再使用mysql
• 内置function_debug.php，通过$_config['debug'] = 1开启

6. 最低运行环境要求

安全提示：建议使用仍在支持期内的软件，避免安全隐患。
性能提示：MySQL < 5.7或MariaDB < 10.2时InnoDB性能下降，生产环境建议升级至MySQL >= 5.7或MariaDB >= 10.2。

---

声明

您可以Fork本站代码，但未经许可禁止在本产品整体或任何部分基础上发展派生版本、修改版本或第三方版本用于重新分发。

友情提示

• 本站不再发布其他编码版本，可通过https://gitee.com/Discuz/DiscuzX/attach_files%E8%87%AA%E8%A1%8C%E8%BD%AC%E7%A0%81%EF%BC%8C%E6%88%96%E4%B8%8B%E8%BD%BD%E6%8E%88%E6%9D%83https://gitee.com/3dming/DiscuzL/attach_files
• Git版Release版本号不再更新，DiscuzFans打包版会更新
• X3.2、X3.3已停更，X3.4漏洞修补同样适用于X3.2、X3.3，需关注https://gitee.com/Discuz/DiscuzX/commits/master%E5%B9%B6%E6%89%8B%E5%8A%A8%E4%BF%AE%E8%A1%A5%E4%BB%A5%E4%BF%9D%E6%8C%81%E5%AE%89%E5%85%A8%E3%80%82