Discuz! 注册时间段限制插件（register_limit）

一、插件概述

二、插件安装与基础配置

1. 安装前提

• 适配 Discuz! X3.1/X3.2/X3.3/X3.4 等主流版本（兼容 PHP 5.6+、7.x 系列）；
• 论坛服务器需开启基础 PHP 环境，且管理员拥有插件安装 / 管理权限；
• 确保插件文件编码与论坛系统适配（XML 配置文件需为 GBK 编码，因 Discuz! 商店规范要求）。

2. 安装步骤

1. 下载插件压缩包，解压后得到 register_limit 文件夹；
2. 将该文件夹上传至论坛服务器的 source/plugin/ 目录下；
3. 登录 Discuz! 后台，进入「应用中心」→「插件」→「未安装插件」；
4. 找到「注册时间段限制」插件，点击「安装」，按提示完成权限配置；
5. 安装完成后，在插件列表中点击「设置」，进入配置页面。

3. 核心配置项

三、核心功能实现原理（开发视角）

1. 钩子（Hook）绑定

<?php
class register_limit {
// 插件初始化，绑定钩子
public function init() {
Hook::listen('member_register_start', array($this, 'check_register_time'));
}

// 注册时段校验核心方法
public function check_register_time() {
global $_G;

// 1. 获取插件配置
$plugin_setting = $_G['setting']['plugin']['register_limit'];
if (empty($plugin_setting['enable'])) {
return true; // 插件未开启，直接放行
}

// 2. 获取当前时间（时区适配）
$current_time = date('H:i');
$current_date = date('w'); // 星期几（0=周日，1=周一...6=周六）
$allow_time_range = $plugin_setting['allow_time']; // 允许注册时段
$allow_date_type = $plugin_setting['allow_date']; // 允许注册日期类型

// 3. 日期校验
$is_allow_date = $this->check_allow_date($current_date, $allow_date_type);
if (!$is_allow_date) {
showmessage($plugin_setting['tips'] ?: '当前日期不允许注册！');
}

// 4. 时段校验
$is_allow_time = $this->check_allow_time($current_time, $allow_time_range);
if (!$is_allow_time) {
// 可选：记录违规尝试日志、IP封禁逻辑
$this->handle_forbidden_ip();
showmessage($plugin_setting['tips'] ?: '当前时段不允许注册！');
}

// 校验通过，放行注册流程
return true;
}

// 日期校验辅助方法
private function check_allow_date($current_date, $allow_date_type) {
switch ($allow_date_type) {
case 'workday': // 仅工作日（周一至周五）
return in_array($current_date, array(1,2,3,4,5));
case 'custom': // 自定义日期（需额外配置）
$custom_dates = explode(',', $_G['setting']['plugin']['register_limit']['custom_dates']);
return in_array($current_date, $custom_dates);
default: // 全部日期
return true;
}
}

// 时段校验辅助方法
private function check_allow_time($current_time, $time_range) {
list($start_time, $end_time) = explode('-', $time_range);
return $current_time >= $start_time && $current_time <= $end_time;
}

// IP封禁处理方法
private function handle_forbidden_ip() {
global $_G;
$ban_ip_enable = $_G['setting']['plugin']['register_limit']['ban_ip_enable'];
if ($ban_ip_enable) {
$ban_duration = $_G['setting']['plugin']['register_limit']['ban_duration'] * 3600; // 小时转秒
// 写入IP封禁表（Discuz! 自带的common_banned表）
C::t('common_banned')->insert(array(
'ip' => $_G['clientip'],
'adminid' => 0,
'dateline' => TIMESTAMP,
'expiration' => TIMESTAMP + $ban_duration,
'reason' => '非允许时段尝试注册'
));
}
}
}

2. XML 配置文件作用discuz_plugin_register_limit.xml 是插件的核心配置文件（GBK 编码），用于定义插件基本信息、配置项、权限等，示例片段

<?xml version="1.0" encoding="GBK"?>
<plugin>
<name>register_limit</name>
<cname>注册时间段限制</cname>
<version>1.0.0</version>
<author>你的名称</author>
<description>管控用户注册时段，减少恶意注册</description>
<settings>
<setting>
<name>enable</name>
<type>radio</type>
<cname>开启插件</cname>
<options>
<option value="1">是</option>
<option value="0">否</option>
</options>
<value>1</value>
</setting>
<setting>
<name>allow_time</name>
<type>text</type>
<cname>允许注册时段</cname>
<tips>格式示例：08:00-22:00</tips>
<value>08:00-22:00</value>
</setting>
<!-- 其他配置项省略 -->
</settings>
</plugin>

四、常见问题与解决方案

1. 插件安装后不生效？

• 排查：确认插件已开启、钩子绑定成功，XML 文件编码为 GBK（可通过记事本另存为 GBK 编码）；
• 解决：后台「工具」→「更新缓存」，重启 PHP 服务，检查 member_register_start 钩子是否被其他插件覆盖。

2. 时段校验异常（比如 22:00 注册提示超时）？

• 排查：服务器时区与论坛时区不一致（Discuz! 后台「全局」→「时区设置」）；
• 解决：代码中增加时区适配，使用 date_default_timezone_set($_G['setting']['timeoffset']); 统一时区。

3. IP 封禁后无法解封？

• 排查：封禁时长配置错误，或 common_banned 表数据未自动清理；
• 解决：手动删除 common_banned 表中对应 IP 记录，或优化代码中封禁逻辑（增加过期自动清理）。

五、扩展建议

1. 增加「白名单 IP / 用户组」：允许特定 IP 段、管理员用户组不受注册时段限制；
2. 注册时段统计：新增后台统计模块，展示各时段注册尝试次数、封禁记录等；
3. 多时段配置：支持设置多个允许注册时段（如 08:00-12:00、14:00-22:00）；
4. 适配移动端：优化移动端注册提示语的展示样式，适配触屏界面。

六、注意事项

1. 升级 Discuz! 版本前，需测试插件兼容性（重点检查钩子是否变更）；
2. 建议定期清理 common_banned 表中的过期 IP 封禁记录，避免数据冗余；
3. 提示语配置避免使用特殊字符，防止前端展示乱码。