thinkphp框架管理员角色管理和状态设置

# 一、修改管理员状态

# ① 接口说明

请求方式：post [用postman测试]

接口示例：
本地路由地址：http://thinkphp.shop/admin/shopmanager/:id/update_status
本地路由示例：http://thinkphp.shop/admin/shopmanager/1/update_status (opens new window) 1代表管理员id

header头

参数是否必填类型说明

token 是 String token值

请求参数

参数是否必填类型说明

status 是 int 状态值：0不可用，1可用

返回
{
    "msg": "ok",
    "data": true
}

参数	是否必填	类型	说明
status	是	int	状态值：0不可用，1可用

# ② 控制器

app/admin/controller/Shopmanager.php

    //修改管理员状态
    public function updateStatus(){
        // 由于传递了id,在验证器里面已经将查询结果挂载到了request() -> Model
        /*
        $this -> request -> Model -> save([
            'status' => $this -> request -> param('status'),
        ]);
        */
        $shopmanager = $this -> request -> Model;
        //不能禁用自己
        if($this -> request->UserModel -> id === $shopmanager -> id) ApiException('不能禁用自己');


        $shopmanager -> status = $this -> request -> param('status');
        return apiSuccess($shopmanager -> save());
    }

# ③ 验证器

app/validate/admin/Shopmanager.php

...
//定义一个场景（场景名称可自定义，方便我们观察，可用控制器的方法名称）
protected $scene = [
    ...
    //修改管理员状态
    'updateStatus' => ['id','status'],
];

# ④ 路由

route/admin.php

// 必须是登录之后，才能访问（管理员身份）
Route::group('admin',function(){
    //修改管理员状态
    Route::post('shopmanager/:id/update_status','admin.ShopManager/updateStatus');
    ...
//加入中间件代码
})->middleware(\app\middleware\checkShopManagerToken::class);

# 二、角色列表

# ① 接口说明

请求方式：GET [用postman测试]
接口示例：
本地路由地址：http://thinkphp.shop/admin/role/:page?limit=[:limit]
本地路由示例：http://thinkphp.shop/admin/role/1?limit=5 (opens new window) 1代表第1页，5代表每页5条数据
header头

参数	是否必填	类型	说明
token	是	String	token值

请求参数

参数	是否必填	类型	说明
page	是	int	页码
limit	否	int	每页多少条数据

{
    "msg": "ok",
    "data": {
        "list": [
            {
                "id": 4,
                "name": "技术人员",
                "desc": "技术人员的一些权限",
                "status": 1,
                "create_time": "2025-03-21 18:47:35",
                "update_time": "2025-03-21 18:47:35",
                "rules": []
            },
            {
                "id": 1,
                "name": "普通管理员",
                "desc": "普通管理员角色",
                "status": 1,
                "create_time": "2025-03-21 17:43:25",
                "update_time": "2025-03-21 17:43:25",
                "rules": [
                    {
                        "id": 1,
                        "pid": 0,
                        "status": 1,
                        "name": "管理员管理",
                        "frontname": "",
                        "frontpath": "",
                        "condition": "",
                        "menu": 1,
                        "order": 50,
                        "icon": "",
                        "method": "POST",
                        "create_time": "2025-03-26 17:09:21",
                        "update_time": "2025-03-26 17:09:21",
                        "pivot": {
                            "id": 1,
                            "role_id": 1,
                            "rule_id": 1,
                            "create_time": "2025-03-26 21:12:50",
                            "update_time": "2025-03-26 21:12:50"
                        }
                    },
                    {
                        "id": 2,
                        "pid": 1,
                        "status": 1,
                        "name": "删除管理员",
                        "frontname": "",
                        "frontpath": "",
                        "condition": "admin.ShopManager/delete",
                        "menu": 1,
                        "order": 50,
                        "icon": "",
                        "method": "POST",
                        "create_time": "2025-03-26 17:12:39",
                        "update_time": "2025-03-26 17:12:39",
                        "pivot": {
                            "id": 2,
                            "role_id": 1,
                            "rule_id": 2,
                            "create_time": "2025-03-26 21:12:50",
                            "update_time": "2025-03-26 21:12:50"
                        }
                    },
                    {
                        "id": 4,
                        "pid": 0,
                        "status": 1,
                        "name": "角色管理",
                        "frontname": "",
                        "frontpath": "",
                        "condition": "",
                        "menu": 1,
                        "order": 50,
                        "icon": "",
                        "method": "POST",
                        "create_time": "2025-03-26 17:14:25",
                        "update_time": "2025-03-26 17:14:25",
                        "pivot": {
                            "id": 4,
                            "role_id": 1,
                            "rule_id": 4,
                            "create_time": "2025-03-26 21:14:14",
                            "update_time": "2025-03-26 21:14:14"
                        }
                    },
                    {
                        "id": 5,
                        "pid": 4,
                        "status": 1,
                        "name": "角色列表",
                        "frontname": "",
                        "frontpath": "",
                        "condition": "admin.Role/index",
                        "menu": 1,
                        "order": 50,
                        "icon": "",
                        "method": "POST",
                        "create_time": "2025-03-26 17:15:21",
                        "update_time": "2025-03-26 17:15:21",
                        "pivot": {
                            "id": 5,
                            "role_id": 1,
                            "rule_id": 5,
                            "create_time": "2025-03-26 21:15:43",
                            "update_time": "2025-03-26 21:15:43"
                        }
                    }
                ]
            }
        ],
        "totalCount": 4
    }
}

# ② 功能代码

# 1. 创建角色控制器

php think make:controller admin/Role

# 2. 控制器代码 `app/controller/admin/Role.php`

...
use app\BaseController;

class Role extends BaseController
{
    //角色列表
    public function index()
    {
        // return apiSuccess('角色列表');
        //拿到参数数组, 如：页码等
        // $param = $request ->param();
        $param = $this->request->param();
        //可选参数，如limit:每页多少条，查询keyword:搜索关键字
        $limit = getValueByKey('limit',$param,10);

        //计算一下一共查了多少条数据
        $totalCount = $this->model -> count();

        //列表数据
        $list = $this->model ->
               //分页
               page($param['page'],$limit) ->
               //排序
               //order('id','desc') ->
               order(['id'=>'desc']) ->
               //查询
               select();

        return apiSuccess([
            'list' => $list,
            'totalCount' =>$totalCount,
        ]);
    
    }
}

# 3. 创建验证器

php think make:validate admin/Role

# 4. 验证器代码 `app/validate/admin/Role.php`

...
use app\validate\BaseValidate;

class Role extends BaseValidate
{
    
    protected $rule = [
        'page' => 'require|integer|>:0',
        'limit' => 'integer|>:0',
    ];

    ...

    //定义一个场景（场景名称可自定义，方便我们观察，可用控制器的方法名称）
    protected $scene = [
        //角色列表验证场景
        'index' => ['page','limit'],
    ];
}

# 5. 路由 `route/admin.php`

// 必须是登录之后，才能访问（管理员身份）
Route::group('admin',function(){
    ...

    //角色列表
    Route::get('role/:page','admin.Role/index');
    
//加入中间件代码
})->middleware(\app\middleware\checkShopManagerToken::class);

# 三、为角色创建权限

我们在前面已经创建了角色表：role，为了方便角色的管理，我们可以为角色创建权限，让定义的角色访问对应的权限。

# 1. 角色权限表 `rule`

具体角色权限表rule设计，具体查看：点击查看角色的权限表 rule

# 2. 角色权限中间表 `role_rule`

说明：

我们前面讲shop_manager表的时候，是通过在表中设置外键字段 role_id来关联role表，那么这里我们换另外一种方式来做表的关联，就是这种中间表，比如 role_rule, 来关联角色表role和权限表rule, 让大家能够学习到更多关联关系的处理。

具体角色权限中间表 role_rule设计，具体查看：点击查看角色权限中间表 role_rule

# 四、角色列表数据中，包含该角色对应的权限

# 1. 先手动往权限表 `rule` 插入一些权限数据（根据路由写）

# 2. 然后手动往中间表 `role_rule` 插入一些数据（根据角色id和权限id插入）

# 3. 创建 `rule` 表模型（因目前还没有）

php think make:model Rule

# 4. 创建中间表 `role_rule` 表模型（因目前还没有）

php think make:model RoleRule

# 5. `Role` 模型代码

app/model/Role.php

   //角色表role对应权限表rule, 一个角色，比如：普通管理员角色
   //普通管理员角色可以设置很多权限，同样，一个权限可以被很多角色拥有
   // 角色对权限，多对多的关系：belongsToMany
   //参考文档https://www.kancloud.cn/manual/thinkphp6_0/1037601 模型关联
   //belongsToMany('关联模型','中间表','外键','当前模型关联键');
   public function rules(){
       // 默认关联
       // return $this->belongsToMany('Rule', 'role_rule');
       // 指定关联
       return $this->belongsToMany(Rule::class, 'role_rule', 'rule_id', 'role_id');
   }

# 6. `Rule` 模型代码

app/model/Rule.php

   //权限对角色，一个权限可以对应很多角色，一个角色对应很多权限
   //权限对角色, 多对多：belongsToMany
   //参考文档https://www.kancloud.cn/manual/thinkphp6_0/1037601 模型关联
   // 角色-规则多对多关系 belongsToMany（第一个：关联的模型，第二个：中间表）
   // 一条 Rule规则 对应多个 role角色
   public function roles(){
       return $this->belongsToMany('Role','role_rule');
       // 指定关联
       return $this->belongsToMany(Role::class, 'role_rule', 'role_id', 'rule_id');
   }

# 7. 角色关联权限代码

app/controller/admin/Role.php


   // 角色列表(关联权限)
   public function index()
   {
       // return apiSuccess('角色列表');
       //拿到参数数组, 如：页码等
       // $param = $request ->param();
       $param = $this->request->param();
       //可选参数，如limit:每页多少条，查询keyword:搜索关键字
       $limit = getValueByKey('limit',$param,10);

       //计算一下一共查了多少条数据
       $totalCount = $this->model -> count();

       //列表数据
       $list = $this->model ->
              //分页
              page($param['page'],$limit) ->
              // 关联权限
              with(['rules']) -> 
              //排序
              // order('id','desc') ->
              order(['id'=>'desc']) ->
              //查询
              select();

       return apiSuccess([
           'list' => $list,
           'totalCount' =>$totalCount,        
       ]);
   }

# 一、修改管理员状态

# ① 接口说明

# ② 控制器

# ③ 验证器

# ④ 路由

# 二、角色列表

# ① 接口说明

# ② 功能代码

# 1. 创建角色控制器

# 2. 控制器代码 app/controller/admin/Role.php

# 3. 创建验证器

# 4. 验证器代码 app/validate/admin/Role.php

# 5. 路由 route/admin.php

# 三、为角色创建权限

# 1. 角色权限表 rule

# 2. 角色权限中间表 role_rule

# 四、角色列表数据中，包含该角色对应的权限

# 1. 先手动往权限表 rule 插入一些权限数据（根据路由写）

# 2. 然后手动往中间表 role_rule 插入一些数据（根据角色id和权限id插入）

# 3. 创建 rule 表模型（因目前还没有）

# 4. 创建中间表 role_rule 表模型（因目前还没有）

# 5. Role 模型代码

# 6. Rule 模型代码

# 7. 角色关联权限代码

# 2. 控制器代码 `app/controller/admin/Role.php`

# 4. 验证器代码 `app/validate/admin/Role.php`

# 5. 路由 `route/admin.php`

# 1. 角色权限表 `rule`

# 2. 角色权限中间表 `role_rule`

# 1. 先手动往权限表 `rule` 插入一些权限数据（根据路由写）

# 2. 然后手动往中间表 `role_rule` 插入一些数据（根据角色id和权限id插入）

# 3. 创建 `rule` 表模型（因目前还没有）

# 4. 创建中间表 `role_rule` 表模型（因目前还没有）

# 5. `Role` 模型代码

# 6. `Rule` 模型代码