一對一模型關聯

1. 前言

本小節介紹如何使用模型關聯，當你需要使用多表聯合查詢數據的時候，若使用模型關聯可以讓代碼變得更簡潔，一對一模型關聯主要針對的是兩個表中的數據只有一對一的關系，或者只需要取出一對一關系的數據。

2. 添加測試數據

這里為了演示方便，需要向之前新建好的 課程表(course)、教師表(teacher) 添加數據，添加教師表數據 SQL 如下：

如下圖所示:

添加課程表數據 SQL 語句如下：

如下圖所示：

3. 接口路由定義

這里以查詢課程表(course) 數據為例，通過一對一模型關聯出課程表對應的教師信息：

Route::get('courses','app\controller\Study\CourseController@courseList');

如下圖所示：

4. 控制器和方法定義

下面貼出路由中定義的控制器和查詢方法：

<?php
namespace app\controller\Study;
use app\BaseController;
use app\Models\Study\CourseModel;
class CourseController extends BaseController
{
    /**
     * 獲取教師列表
     */
    public function courseList()
    {
        $size = (int)$this->request->param('size', 15);
        $students = CourseModel::where('status', 1)->order('created_at DESC')->paginate($size);
        return json($students);
    }
}

如下圖所示：

5. 請求課程列表接口數據

下面使用 postman 請求接口數據如下：

{
    "total": 6,
    "per_page": 10,
    "current_page": 1,
    "last_page": 1,
    "data": [
        {
            "id": 1,
            "course_name": "廣義相對論",
            "teacher_id": 1,
            "created_at": 1603617951,
            "update_at": 0,
            "status": 1
        },
        {
            "id": 2,
            "course_name": "電動力學",
            "teacher_id": 2,
            "created_at": 1603617951,
            "update_at": 0,
            "status": 1
        },
        {
            "id": 3,
            "course_name": "電磁學",
            "teacher_id": 3,
            "created_at": 1603617951,
            "update_at": 0,
            "status": 1
        },
        {
            "id": 4,
            "course_name": "光學",
            "teacher_id": 4,
            "created_at": 1603617951,
            "update_at": 0,
            "status": 1
        },
        {
            "id": 5,
            "course_name": "信息論",
            "teacher_id": 5,
            "created_at": 1603617951,
            "update_at": 0,
            "status": 1
        },
        {
            "id": 6,
            "course_name": "天文學",
            "teacher_id": 6,
            "created_at": 1603617951,
            "update_at": 0,
            "status": 1
        }
    ]
}

如下圖所示：

6. 設置模型關聯方法

若要在課程列表數據中關聯出教師信息可以在 CourseModel 模型中使用如下 teacher 方法:

<?php
namespace app\Models\Study;
use think\Model;
class CourseModel extends Model
{
    protected $table = 'course';

    /**
     * 一對一模型關聯
     */
    public function teacher()
    {
        return $this->hasOne(TeacherModel::class, "id", "teacher_id");
    }
}

如下圖所示:

7. 使用 with 預加載出關聯信息

可以在課程列表接口的方法中使用 with() 方法預加載出關聯信息：

 $students = CourseModel::where('status', 1)
     ->with('teacher')
     ->order('created_at DESC')
     ->paginate($size);

Tips： 其中 with('teacher') 預加載出 teacher 屬性，也可以不使用 with 被動加載出 teacher ，如調用 $studentModel->teacher 的時候，若模型不存在 teacher 屬性，會觸發模型關聯同名的方法。

8. 請求模型關聯之后的數據

下面使用 postman 請求接口部分數據如下：

{
     "id": 1,
     "course_name": "廣義相對論",
     "teacher_id": 1,
     "created_at": 1603617951,
     "update_at": 0,
     "status": 1,
     "teacher": {
         "id": 1,
         "name": "愛老師",
         "age": 24,
         "id_number": "52011720100506XXXX",
         "created_at": 1603617951,
         "update_at": 0,
         "status": 1
     }
 }

Tips： 此時列表中出現了 teacher 屬性字段，這個字段就是課程列表一對一關聯出來的教師信息。

9. 小結

本小節主要介紹如何使用模型關聯一對一的方式，在查詢課程列表的時候關聯出教師信息，這樣就不必書寫繁瑣的連表查詢邏輯。

需要注意的是，一般情況下使用模型關聯最好使用 with 預加載出來，預加載列表信息底層實際使用的是 IN 查詢一次全部查出列表內容，若在列表中被動觸發可能會造成多次查詢帶來的性能問題。

Tips： 代碼倉庫：https://gitee.com/love-for-poetry/tp6