文档首页 / HareAdmin 开发手册

控制器

后台业务控制器通常继承 app\common\controller\Backend(或项目封装的后台基类),前台继承 Frontend,接口继承 Api。

基类要点

  • $noNeedLogin / $noNeedRight:跳过登录或权限校验的方法名数组;['*'] 表示全部。
  • $this->auth:当前管理员 / 会员;后台也可用 Auth 单例或 Session。
  • $this->success() / $this->error(lang('…')):AJAX 统一反馈(默认成功文案 Operate success)。
  • $this->model:关联模型后,列表/增删改可复用基类 CRUD 能力。

基础结构

namespace app\admin\controller;

class Example extends Backend
{
    protected $model = null;
    protected $searchFields = 'id,name';

    public function _initialize()
    {
        parent::_initialize();
        $this->model = new \app\admin\model\Example;
    }
}

数据限制与关联

数据权限、关联查询、校验器与字段过滤以基类属性和 ThinkPHP 模型关联为准。一键 CRUD 生成的代码可作为范本;复杂关联请在模型中声明 belongsTo / hasMany 等。

视图与布局

后台视图默认走 AdminLTE 壳;弹层表单用 Fast.api.contentDialog,不要用过时的绝对定位 .form-layer 结构。列表页脚本优先写在当前视图内,或复用 Table.api / Form.api(见「前端介绍」「系统组件」)。

权限

菜单节点与控制器方法对应。分配角色权限后仍无权限时,检查节点是否生成、是否勾选到角色、缓存是否需清理。