ThinkPHP5如何配置数据库前缀？_ThinkPHP5连接设置表名前缀【结构】-ThinkPHP-PHP中文网

thinkphp5表前缀仅通过数据库配置的'prefix'项或模型的$connection数组设置才生效；db::name()自动加前缀，db::table()和原生sql不加；修改后需清除runtime缓存。

thinkphp5如何配置数据库前缀？_thinkphp5连接设置表名前缀【结构】

ThinkPHP5 的表前缀不是靠模型类里写 $tablePrefix 或 $prefix 就能生效的——直接设这个变量完全无效。真正起作用的只有两处：数据库连接配置（全局或模块级）和模型的 $connection 属性（局部覆盖）。其他写法基本是白忙活。

database.php 里配置 prefix 是最常用方式

这是项目级统一前缀的唯一可靠入口。路径通常是 application/database.php 或模块下的 application/index/database.php，找到 'prefix' => '' 这一项，改成你想要的值：

'prefix' => 'tp_',

改完后所有用默认连接的 Db::name('user')、Db::table('tp_user')、模型查询都会自动拼上前缀。注意：Db::name('user') 会查 tp_user 表，但 Db::table('user') 不会加前缀，它查的就是字面名的 user 表。

如果配置文件里 'prefix' 留空，Db::name() 和模型都不会加前缀
模块级配置（如 application/admin/database.php）只影响该模块，且只写差异项即可，不用重复全局配置
改完必须清缓存（runtime/ 目录下删掉 cache/ 和 data/），否则可能不生效

模型中通过 $connection 指定前缀（非全局覆盖）

当某个模型要连不同前缀的表（比如对接遗留库），不能改全局配置，就得在模型里单独指定。不是设 $prefix，而是把整个连接参数塞进 $connection：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

namespace app\index\model;

use think\Model;

class User extends Model
{
    protected $connection = [
        'prefix' => 'old_',
    ];
}

这样 User::all() 查的是 old_user，不影响其他模型。关键点：

$connection 值是数组，不是字符串；填字符串（如 'db_config'）是引用配置名，不是设前缀
这种写法会绕过全局 database.php 的 prefix，以这里为准
如果同时设了 $table = 'old_user'，那 $connection['prefix'] 就被忽略——$table 是最高优先级

Db 类操作时临时指定前缀（极少用）

一般没必要，但如果你要动态切前缀（比如多租户场景），可以用 Db::connect() 手动构造连接：

$db = Db::connect([
    'type'     => 'mysql',
    'hostname' => '127.0.0.1',
    'database' => 'mydb',
    'username' => 'root',
    'password' => '',
    'prefix'   => 'tenant_a_',
]);
$result = $db->name('user')->select();

这种方式开销大，每次调用都新建连接，不适合高频场景。更合理的是提前在 config.php 里定义多个连接配置名（如 'tenant_a_db'），然后用 Db::connect('tenant_a_db') 复用。