什么是后台菜单注解

为了方便在代码里进行后台菜单管理我们新增了@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. */

导入菜单

后台菜单注解 - 图1

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

原文: https://www.thinkcmf.com/docs/cmf/后台菜单注解.html