一键调试模式插件

预计阅读 5 分钟
版本: 3.0.0 | 适用于 WordPress 5.0+ | PHP 7.4+

功能介绍

核心功能

  • 一键开启/关闭 WordPress 调试模式
  • 实时查看、搜索、筛选 debug.log 日志
  • 完整的系统信息报告
  • 操作历史记录(含IP、UA信息)
  • wp-config.php 备份与恢复

安全特性

  • IP白名单控制
  • 自动关闭机制
  • 邮件通知
  • 生产环境警告
  • 权限验证

增强功能

  • 深色模式
  • 日志统计
  • 日志搜索筛选
  • 响应式设计
  • 快捷键支持

安装配置

系统要求

  • WordPress 5.0+
  • PHP 7.4+
  • wp-config.php 可写

安装步骤

  1. 上传插件到 /wp-content/plugins/ 目录
  2. 后台插件页面启用
  3. 确保 wp-config.php 权限为 644 或 755

初始配置

插件启用后访问:后台菜单 → 一键调试

使用方法

仪表盘

显示当前调试状态,一键开启/关闭调试模式。
状态常量说明:
  • WP_DEBUG – 核心调试开关
  • WP_DEBUG_LOG – 错误日志记录
  • WP_DEBUG_DISPLAY – 页面显示错误
  • SAVEQUERIES – 数据库查询保存
  • SCRIPT_DEBUG – 开发版JS/CSS
快捷键: Ctrl+D 快速切换调试状态

日志查看

  • 刷新日志 – 重新加载
  • 下载日志 – 导出文件
  • 清空日志 – 清空内容
  • 搜索筛选 – 关键词/级别/行数
日志统计: 自动显示 Error/Warning/Notice/Fatal 数量

系统信息

完整的环境报告,支持导出:
  • WordPress 信息
  • PHP 信息(含扩展状态)
  • 服务器信息
  • 数据库信息
  • 主题信息
  • 插件列表

操作历史

详细记录每次操作:
  • 操作时间和用户
  • 操作类型和详情
  • IP地址
  • User-Agent

备份管理

  • 自动备份 wp-config.php
  • 最多保留5个备份
  • 一键恢复

参数说明

显示设置

参数
默认
说明
show_admin_bar
true
显示管理栏状态
show_frontend_notice
true
前台调试提醒
dark_mode
false
深色模式
warn_production
true
生产环境警告

快速操作

参数
默认
说明
enable_savequeries
false
快速开启时启用SAVEQUERIES
enable_script_debug
false
快速开启时启用SCRIPT_DEBUG

自动关闭

参数
可选值
说明
auto_close_hours
0,1,2,4,8,12,24,48,72,168
自动关闭时间(小时),0为不自动关闭

通知设置

参数
说明
enable_notification
启用邮件通知
notification_email
通知邮箱(默认管理员邮箱)

IP白名单

每行一个IP,支持CIDR:
192.168.1.1 10.0.0.0/8
留空表示允许所有IP。

注意事项

安全提醒

  1. 生产环境慎用调试模式
  2. 建议配置IP白名单
  3. 调试完成后及时关闭
  4. 定期清理日志文件

性能影响

选项
影响
建议
WP_DEBUG
中等
按需启用
WP_DEBUG_DISPLAY
生产环境禁用
SAVEQUERIES
仅排查问题时启用
SCRIPT_DEBUG
中等
调试前端时启用

常见问题

Q: wp-config.php不可写?
A: chmod 644 wp-config.php
Q: IP不在白名单?
A: 编辑设置添加当前IP或临时清空白名单
Q: 日志文件过大?
A: 点击清空日志或设置自动关闭时间

更新日志

v3.0.0 (2026-05-18)

  • 新增IP白名单功能
  • 新增自动关闭机制
  • 新增邮件通知
  • 新增生产环境警告
  • 新增深色模式
  • 新增备份管理页面
  • 新增日志搜索筛选
  • 新增日志统计
  • 优化操作历史记录
  • 优化代码结构

v2.0.0

  • 全新UI设计
  • 支持多标签页
  • 日志查看优化

v1.0.0

  • 初始版本
© 版权声明
THE END
喜欢就支持一下吧
点赞8793支持作者 分享
评论标题 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片快捷回复

    暂无评论内容