ThinkPHP Db::name和Db::table通过Facade怎么用-ThinkPHP-PHP中文网

Db::name()自动添加配置的数据库前缀并支持映射，Db::table()使用裸表名不加前缀、不转换大小写；Facade下可直接链式调用二者，跨库/第三方表等非标场景必须用table()。

thinkphp db::name和db::table通过facade怎么用

Db::name() 和 Db::table() 的本质区别在哪

两者都用于指定操作的数据表，但语义和底层行为不同：Db::name() 会自动加上配置的数据库前缀（如 prefix_），而 Db::table() 是“裸表名”，不加前缀、不处理大小写转换、也不走表名映射逻辑。

如果你的表名是 user，且配置了 'prefix' => 'tp_'，那么：

Db::name('user') 实际操作的是 tp_user
Db::table('user') 实际操作的就是 user（哪怕数据库里真实表名是 tp_user，也会报错）

Facades 下怎么调用 name() 和 table()

ThinkPHP 的 Db Facade 是对 think\db\Connection 的静态代理，所有链式方法（包括 name()、table()）都直接可用，不需要 new 实例或手动获取连接对象。

常见写法就是直接链式调用：

// 正确：Facade 方式，name() 自动加前缀
$user = Db::name('user')->where('id', 1)->find();

// 正确：table() 不加前缀，适合跨库/临时表/无前缀表
$log = Db::table('sys_log')->where('level', 'error')->select();

// 错误：Db::name() 不能传带前缀的完整表名（会导致双重前缀）
Db::name('tp_user')->find(); // 实际查的是 tp_tp_user

什么时候必须用 table() 而不能用 name()

当你要操作的表不属于当前数据库配置的前缀规则时，table() 是唯一选择。典型场景包括：

Academic Reader

PDF转Markdown转换器——从PDF文件提取文本、表格和公式，生成干净的Markdown。适用于PDF文档转换、内容提取、解析等场景。

下载

查询第三方系统表（如 mysql.user、information_schema.tables）
临时表或视图（如 tmp_report_2024），它们没有统一前缀
跨库查询（如 other_db.product），此时需写全名：Db::table('other_db.product')
表名含特殊字符或大写（如 UserInfo），而你的前缀配置开启了自动小写转换（'strict' => true），name() 可能把它转成 userinfo 导致失败