PHP5动态改表名,设置数据库表名 · DolphinPHP1.5.0完全开发手册-基于ThinkPHP5.1.41LTS的快速开发框架 · 看云...
## 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`方法还未执行，所以就使用了默认的操作类型。