本文说明如何开启开发者模式(IS_DEV)、如何安装「开发者工具」插件,以及该插件的主要作用。

二次开发、模板调试、故障排查时建议先开启开发者模式;

正式上线后务必关闭,并视情况卸载高权限插件。

开发者模式是什么

开发者模式由入口文件中的常量 IS_DEV 控制。

开启后全站会暴露更多调试与诊断信息,便于开发与排错;关闭后进入生产环境行为(精简报错、恢复缓存策略等)。

常见适用场景:

  • 插件 / 模块二次开发

  • 主题模板制作与排查模板路径

  • URL 重定向异常、性能与故障排查

  • 查看详细错误、SQL、系统变量等调试信息

  • 使用「开发者工具」等强制依赖开发者模式的插件

如何开启开发者模式

编辑 Web 入口文件 public/index.php(部分部署说明中也称根目录 index.php),将 IS_DEV 设为 1

// 是否是开发者模式(1开启、0关闭),上线之后建议关闭此开关
define('IS_DEV', 1);
  • IS_DEV = 1:开启,方便调试。

  • IS_DEV = 0:关闭,生产环境推荐值。

开启后可关注以下变化(不同页面表现可能略有差异):

  • 程序异常会展示更详细的错误信息(生产环境往往只提示开启开发者模式后可查看详情)。

  • 系统强制关闭部分缓存策略,模板变更更容易即时生效。

  • 页面源码中可能输出当前模板路径注释,便于定位「当前页对应哪个模板文件」。

  • 后台调试器会被强制开启;页面底部可能出现调试器入口(火苗图标),可查看 Database(SQL)、Files、views(模板与变量)、Events(钩子)、Vars(系统变量)等。

  • 部分跳转在开发者模式下会先提示说明再跳转,关闭后变为静默跳转或 404,便于发现错误 URL / 识别逻辑。

  • 系统体检会提示「开发者模式已开启,上线后需关闭」。

官方说明可参考:开发者模式

安全提示(务必阅读)

  • 项目正式上线后请将 IS_DEV 改回 0,避免泄露路径、SQL、变量等敏感信息,影响安全与性能。

  • 「开发者工具」权限极高(可执行 SQL / PHP、读写结构等),已上线项目请勿安装或长期保留

  • 插件自身也会在未开启开发者模式时拒绝使用。

  • 开发机与生产机配置分离时,仅在开发环境开启即可。

如何安装开发者工具插件

「开发者工具」对应应用目录一般为 Dever,应用商店编号为 APP449,用于在不破坏核心程序的前提下快速生成插件、控制器与 CRUD 等脚手架。

方式一:后台应用市场安装(推荐)

  1. 先按部署文档完成迅睿系统安装,并确保能正常登录后台。

  2. public/index.php 中开启开发者模式(IS_DEV = 1)。未开启时插件初始化会直接提示无法使用。

  3. 进入后台 → 应用市场,搜索 APP449 或「开发者工具」,点击安装。

  4. 安装成功后刷新后台;菜单中会出现「开发者 / 开发者工具」入口,即可进入使用。

商品与说明页:

方式二:本地目录安装

若已有插件源码包,可将应用目录部署到 dayrui/App/Dever/(目录名需与插件约定一致),再到后台「应用管理」中完成安装/启用。安装后同样必须开启 IS_DEV,否则访问插件会提示权限不足。

开发者工具插件的作用

该插件面向 PHP 二次开发者,核心目标是:

快速创建空白插件与模块、生成控制器与表结构相关代码、辅助查看数据字典与调试信息,

避免直接改动 dayrui/Fcms/ 等核心目录。

后台「开发者工具」常见能力如下(以当前插件菜单为准):

功能说明
应用插件浏览本地应用;创建空白插件、模块插件;为插件/表单等生成控制器与相关代码脚手架
字段控件代码按字段配置生成模板调用、导入配置、Table 二次开发及写入 field 表等代码片段
导出模块配置导出/管理模块相关配置,便于迁移或二次封装
数据表字典查看数据结构与字段信息,辅助建表与字段设计
执行 SQL 代码在受控环境下执行 SQL(高风险;开发者模式约束)
执行 PHP 代码临时执行 PHP 进行调试(高风险;仅限开发环境)
API 请求测试辅助测试接口请求
JSON / 代码格式化格式化 JSON 或代码,便于阅读与粘贴
常量 / 函数速查快速查看如 IS_DEV 等运行时常量与常用函数信息
可用 Hook 列表查看系统可用钩子,便于扩展点接入
调试变量记录查看开发调试过程中记录的变量信息
异常文件检测检测异常 PHP 文件,辅助排查部署与安全问题

插件入门能力说明也可对照官方开发者文档中的「先安装开发者工具,再创建空白插件」流程:插件开发文档

推荐使用顺序

  1. 开发环境将 public/index.phpIS_DEV 设为 1

  2. 安装并打开「开发者工具」(APP449 / Dever)。

  3. 用插件创建空白应用或模块,在 dayrui/App/dayrui/My/template/ 中完成二次开发。

  4. 结合调试器核对模板路径、SQL、钩子与变量。

  5. 上线前:关闭 IS_DEV、更新缓存,并卸载或禁用开发者工具等高权限插件。

本文地址:https://m.xunruicms.com/doc/xunrui/1488.html