## setTableName('数据库表名') | 版本 | 更新内容 | | --- | --- | | 1.0.7 | 支持使用模型 | 默认情况下,批量操作或者右侧的启用、禁用,其他快捷操作会去修改”`当前模块名_当前控制器名`“的数据表,如果需要额外指定,可以使用`setTableName`方法。 ~~~ // 使用ZBuilder快速创建数据表格 return ZBuilder::make('table') ->setTableName('admin_user') // 指定数据表名 ->fetch(); // 渲染页面 ~~~ >[danger] 注意:数据表名无需填写表前缀 ### 使用模型 默认情况下,“启用”、“禁用”、“快速编辑”等默认操作,都是使用Db类来操作数据。从1.0.7版本开始,支持使用自定义模型来操作数据。 以角色管理控制器为例,路径为:`application\user\admin\Role.php` 即,模块为`user`,控制器为`role`,要操作的表为`admin_role`,默认我们创建表格是这样写的 ~~~ public function index() { // 获取查询条件 $map = $this->getMap(); // 数据列表 $data_list = RoleModel::where($map)->paginate(); // 使用ZBuilder快速创建数据表格 return ZBuilder::make('table') ->setTableName('admin_role') // 设置表名 ->setSearch(['name' => '角色名称', 'id' => 'ID']) // 设置搜索参数 ->addColumns([ // 批量添加列 ['id', 'ID'], ['name', '角色名称'], ['description', '描述'], ['create_time', '创建时间', 'datetime'], ['access', '是否可登录后台', 'switch'], ['status', '状态', 'switch'], ['right_button', '操作', 'btn'] ]) ->addTopButtons('add,enable,disable,delete') // 批量添加顶部按钮 ->addRightButtons('edit,delete') // 批量添加右侧按钮 ->setRowList($data_list) // 设置表格数据 ->fetch(); // 渲染模板 } ~~~ 因为模块为`user`,控制器为`role`,而我们要操作的表不是`user_role`而是`admin_role`,所以我们需要用setTableName()方法来设置正确的表名。 这里我们无论是使用快速编辑还是删除、禁用、启用,都是用Db类来操作数据的。 如果希望用模型来操作数据,那可以这样写: ~~~ ->setTableName(true) ~~~ 表名设置为`true`,则框架会优先实例化“当前模块名/当前控制器名”这个模型,如上面的会实例化`user`模块下`role`模型(即`application\user\model\Role.php`这个文件)。 如果想指定模型,可直接输入模型参数,并且`setTableName`的第二个参数设置为true,如: ~~~ ->setTableName('role', true) ~~~ 这样表示使用`model('user/role')`来处理,如果不指定模块,则默认是当前模块。 也可以指定完整的模型类,如: ~~~ ->setTableName('admin/role', true) ~~~ 表示使用`model('admin/role')`来处理数据。 除了可以设置第二个参数为true之外,也可以设置0,1,2三种中的一种 | 参数 | 含义 | | --- | --- | | 0 | 表示使用Db::table()实例化(不加表前缀) | | 1 | 默认类型,表示使用Db::name()实例化(自动加表前缀) | | 2 | 表示使用model()实例化 | | true | 表示使用model()实例化,作用和参数2相同 | ~~~ ->setTableName('role', 0) // 表示使用Db::table('role') ~~~ ~~~ ->setTableName('role', 1) // 表示使用Db::name('role') ~~~ ~~~ ->setTableName('role', 2) // 表示使用model('user/role') ~~~ ~~~ ->setTableName('admin/role', 2) // 表示使用model('admin/role') ~~~ 等同于 ~~~ ->setTableName('admin/role', true) // 表示使用model('admin/role') ~~~ ### 需要注意的地方 setTableName方法虽然可以设置使用哪种方式来操作数据,但它的作用是可以被addRightButton或者addTopButton方法所覆盖的。 ~~~ // 使用ZBuilder快速创建数据表格 return ZBuilder::make('table') ->setTableName('admin_role') // 设置表名 ->addRightButton('delete') // 批量添加右侧按钮 ->fetch(); // 渲染模板 ~~~ 这种情况下,默认是使用`Db::name('admin_role')`来操作数据的。 如果我们在添加右侧按钮的时候,指定了表名,则优先使用右侧按钮参数所设置的类型。 ~~~ // 使用ZBuilder快速创建数据表格 return ZBuilder::make('table') ->setTableName('role', true) // 设置表名 ->addRightButton('delete', ['table' => 'admin_role']) // 批量添加右侧按钮 ->fetch(); // 渲染模板 ~~~ 我们可以看到,虽然上面使用了`->setTableName('role', true)`指定使用实例化模型方式操作数据,但右侧按钮的删除指定了表名,则删除按钮的时候,默认还是会使用`Db::name('admin_role')`来操作数据。 当然,也可以指定其他类型,如: ~~~ // 使用ZBuilder快速创建数据表格 return ZBuilder::make('table') ->setTableName('role', true) // 设置表名 ->addRightButton('delete', ['table' => 'admin_role', 'prefix' => 0]) // 批量添加右侧按钮 ->fetch(); // 渲染模板 ~~~ 点击删除按钮时,使用`Db::table('admin_role')`来操作数据。 >[info] 即,如果添加右侧按钮,或者顶部按钮时,指定了表名,则会忽略setTableName方法所设置的内容。 >[danger] ### 注意,当添加右侧或顶部按钮时,指定了表名,没有指定prefix参数时,setTableName方法的位置会影响实际的操作类型。 ~~~ // 使用ZBuilder快速创建数据表格 return ZBuilder::make('table') ->setTableName('role', true) // 设置表名 ->addRightButton('delete', ['table' => 'admin_role']) // 批量添加右侧按钮 ->fetch(); // 渲染模板 ~~~ 这样写法,表示删除按钮使用`model('user/admin_role')`来操作数据,因为`setTableName`先执行,它设置了操作模式为模型方式,而`addRightButton`方法没有指定prefix参数,则会使用`setTableName`方法所指定的类型操作。但如果`setTableName`方法放在添加按钮的后面,则效果就不一样了。 ~~~ // 使用ZBuilder快速创建数据表格 return ZBuilder::make('table') ->addRightButton('delete', ['table' => 'admin_role']) // 批量添加右侧按钮 ->setTableName('role', true) // 设置表名 ->fetch(); // 渲染模板 ~~~ 表示使用`Db::name('admin_role')`来操作数据,因为在生成按钮时, `setTableName`方法还未执行,所以就使用了默认的操作类型。