后台菜单注解

什么是后台菜单注解

为了方便在代码里进行后台菜单管理我们新增了@adminMenu和@adminMenuRoot两个自定义的注解,通过这个注解我们可以很轻松地在代码中管理后台菜单,比如菜单的名称,排序,是否显示,父级等;@adminMenu是方法级的注解,只对方法有效,每个后台控制器方法只支持一个@adminMenu注解,@adminMenuRoot是类级的注解,只有在给类注释时有效,每个后台控制器类可以支持多个@adminMenuRoot注解

后台菜单入口注解@adminMenuRoot

下面以app\admin\controller\SettingController为例:

  1. <?php
  2. namespace app\admin\controller;
  4. use cmf\controller\AdminBaseController;
  6. use think\Db;
  8. /**
  9.  * Class SettingController
  10.  * @package app\admin\controller
  11.  * @adminMenuRoot(
  12.  * 'name' =>'设置',
  13.  * 'action' =>'default',
  14.  * 'parent' =>'',
  15.  * 'display'=> true,
  16.  * 'order' => 10000,
  17.  * 'icon' =>'cogs',
  18.  * 'remark' =>'系统设置入口'
  19.  * )
  20.  */
  21. class SettingController extends AdminBaseController
  22. {
  24.     /**
  25.      * 密码修改
  26.      * @adminMenu(
  27.      * 'name' => '密码修改',
  28.      * 'parent' => 'default',
  29.      * 'display'=> false,
  30.      * 'hasView'=> true,
  31.      * 'order' => 10000,
  32.      * 'icon' => '',
  33.      * 'remark' => '密码修改',
  34.      * 'param' => ''
  35.      * )
  36.      */
  37.     public function password()
  38.     {
  39.         return $this->fetch();
  40.     }
  42. }

以上代码中,我们给SettingController类增加了一个类级别的@adminMenuRoot注解,它的格式就是一个变形的php数组,语法和 php数组完全一样,数组里的属性就是这个后台菜单入口的属性,

  1. /**
  2.  * @adminMenuRoot(
  3.  * 'name' =>'设置', // 菜单名称
  4.  * 'action' =>'default', // 菜单操作,这是一个虚拟的控制器操作,它不会在这个控制器有对应的方法
  5.  * 'parent' =>'',//菜单父级,格式有三种:应用名/控制器/操作,控制器/操作,操作
  6.  * 'display'=> true,//菜单是否显示
  7.  * 'order' => 10000,//菜单排序
  8.  * 'icon' =>'cogs',//菜单图标
  9.  * 'remark' =>'系统设置入口' //菜单备注
  10.  * )
  11.  */

后台菜单注解@adminMenu

同样以app\admin\controller\SettingController为例:

  1. <?php
  2. namespace app\admin\controller;
  4. use cmf\controller\AdminBaseController;
  6. use think\Db;
  8. /**
  9.  * Class SettingController
  10.  * @package app\admin\controller
  11.  * @adminMenuRoot(
  12.  * 'name' =>'设置',
  13.  * 'action' =>'default',
  14.  * 'parent' =>'',
  15.  * 'display'=> true,
  16.  * 'order' => 10000,
  17.  * 'icon' =>'cogs',
  18.  * 'remark' =>'系统设置入口'
  19.  * )
  20.  */
  21. class SettingController extends AdminBaseController
  22. {
  24.     /**
  25.      * 密码修改
  26.      * @adminMenu(
  27.      * 'name' => '密码修改',
  28.      * 'parent' => 'default',
  29.      * 'display'=> false,
  30.      * 'hasView'=> false,
  31.      * 'order' => 10000,
  32.      * 'icon' => '',
  33.      * 'remark' => '密码修改',
  34.      * 'param' => ''
  35.      * )
  36.      */
  37.     public function password()
  38.     {
  39.         return $this->fetch();
  40.     }
  42. }

上面的代码中,我们给password操作增加了一个方法级别的@adminMenu注解,它的格式也是一个变形 php 数组,语法和 php 数组完全一样,数组里的属性就是这个后台菜单的属性,

  1. /**
  2. * @adminMenu(
  3. * 'name' => '密码修改', // 菜单名称
  4. * 'parent' => 'default', //菜单父级,格式有三种:应用名/控制器/操作,控制器/操作,操作
  5. * 'display'=> false, //菜单是否显示
  6. * 'hasView'=> false,//菜单是否有界面
  7. * 'order' => 10000, //菜单排序
  8. * 'icon' => '', //菜单排序
  9. * 'remark' => '密码修改', //菜单备注
  10. * 'param' => '' //菜单额外参数,一般没有
  11. * )
  12. */

导入菜单

快捷方式中的菜单管理只在调试模式下才会显示，如果生产环境中要进行后台菜单管理，可以访问：你的域名/admin/menu/index,后台菜单管理主要是给开发者用的，所以生产环境中会隐藏。

后台菜单注解 - 图1

点上面的导入新菜单按钮,你在控制器里加的菜单注解就会自动变成后台菜单,你不用改什么菜单就会创建好了!