ThinkPHP6.0关联模型查询_ThinkPHP6.0关联查询写法【数据库】-ThinkPHP-PHP中文网

tp6.0关联查询必须严格匹配方法名、外键和表结构，否则with()或relation()会静默失败；方法名须与模型中定义的函数名逐字符一致（如profile()），外键类型需完全对齐，且hidden设置会传导影响关联字段输出。

thinkphp6.0关联模型查询_thinkphp6.0关联查询写法【数据库】

ThinkPHP6.0 的关联模型查询不是“写对了就能用”，而是必须严格匹配模型定义、方法名、外键和数据表结构，否则 with() 或 relation() 会静默失败或返回空数组。

TP6 不靠注解或配置推断关联，全靠方法名调用。比如你在 User 模型里写了 hasOne('Profile')，那必须定义一个叫 profile() 的方法（注意是小驼峰，不是 Profile() 或 userProfile()）：

class User extends Model
{
    public function profile()
    {
        return $this->hasOne(Profile::class, 'user_id', 'id');
    }
}

常见错误：方法名写成 Profile()、userProfile()、getProfile() —— 这些都会导致 User::with('profile')->find(1) 查不到关联数据，且无报错。

with() 是预加载（JOIN 或子查询），用于避免 N+1；relation() 是延迟加载（单独查一次），仅在访问属性时触发。二者不能混用场景：

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

下载

User::with('profile')->find(1)：查出用户后，立刻查一次 profile 表，合并进结果
User::find(1)->relation('profile')：先查用户，等你显式调用这个方法时才查关联，且只对当前实例生效
误用 relation() 在循环里（如 foreach ($users as $u) { $u->relation('profile'); }）会导致 N+1 查询
with() 不支持嵌套条件（如只查 status=1 的 profile），需改用 with(['profile' => function ($q) { $q->where('status', 1); }])

TP6 默认按约定推导外键（如 hasOne 会找 profile_id），但一旦自定义，就必须全部写清楚。最常踩的坑是字段类型不一致：

主表 user.id 是 BIGINT UNSIGNED，而关联表 profile.user_id 是 INT → 查询可能成功但结果为空（尤其 MySQL 严格模式下隐式转换失败）
外键名写错，比如 hasOne(Profile::class, 'uid', 'id')，但实际字段是 user_id → 静默无数据
使用 belongsTo 时，第二个参数是“当前模型在关联表中的外键名”，容易和 hasOne 搞反顺序

建议始终显式声明三个参数：hasOne(关联模型类, 外键名, 主键名)，哪怕符合约定也写上，避免后期表结构调整后失效。

关联模型如果设置了 protected $hidden = ['password']，它会影响整个关联数组的输出；更隐蔽的是，父模型的 $hidden 也会作用于关联结果（TP6 默认合并可见性）：

若 User 模型设置了 $hidden = ['id']，那么 User::with('profile')->find(1) 返回的 user.id 和 profile.user_id 都会被隐藏
想保留关联模型的某些字段，但父模型又不想暴露，得在关联方法里单独控制：return $this->hasOne(...)->withoutField('password');
不要依赖模型的 toArray() 自动处理，调试时直接 var_dump($user->profile->toArray()) 看原始数据