文档首页 / HareAdmin 开发手册

常见问题

使用问题可到社区反馈:https://www.yetuadmin.com 。安装类问题优先看「安装说明」;命令参数看「常见命令行」。

如何开启调试模式?

修改 .env 或应用配置中的 app_debug 为 true。外网/生产请关闭,否则静态资源过多会很慢。

调试正常、生产失效?

若改过核心 JS/CSS,生产环境需执行 php think min 重新打包(见「常见命令行」)。并排查浏览器缓存。

如何启用后台登录验证码?

修改 config/yetuadmin.php 中 login_captcha 为 true。

CRUD 如何带回收站?

数据表增加默认为 null 的 deletetime 字段,再执行 php think crud。

如何取当前管理员 / 会员?

// 后台控制器
$this->auth->id;
\app\admin\library\Auth::instance();
\think\facade\Session::get('admin');

// 前台 / API
$this->auth->id;
\app\common\library\Auth::instance()->getUser();

安装后提示控制器不存在 E/N?

多为 Web 服务器 PATH_INFO / 伪静态未配好,按「安装说明」检查重写规则。

安装 SQL 在哪?

默认随安装流程建库建表。自定义安装包时可改 app/admin/command/Install/ 下的 SQL 文件(以仓库实际路径为准)。

前台自建控制器提示无权限?

继承 Frontend 时设 $noNeedRight = ['*'],或在后台会员规则中授权。

已分配权限仍无权限?

检查菜单节点是否完整、角色是否勾选、是否超级管理员组冲突,并清理权限/菜单缓存。

只能打开首页,其它 404 / no input file?

伪静态或 try_files / PATH_INFO 配置问题;站点根目录必须指向 public。

composer install 失败?

配置 Composer 镜像后重试;确认 PHP 版本满足要求。

上传 HTTP Error -200?

检查 PHP upload_max_filesize / post_max_size、fileinfo 扩展、目录可写,以及是否启用了错误的存储驱动配置。

安装无法写入配置?

给运行用户写入 config/、.env、runtime/ 的权限。

界面词条不生效?

使用 lang();确认 yt_lang 有小写 key;路径语言模式下 JS 请求带 ?lang=。