Laravel 跨資料庫關聯：不同連線模型間的 BelongsTo 實現

Laravel 跨資料庫關聯：不同連線模型間的 BelongsTo 實現

預設情況下，Eloquent 關聯假設雙方模型使用同一資料庫連線。當 `ModelA` 與 `ModelB` 分屬不同連線（甚至不同資料庫伺服器）時，需手動構建查詢建構器並注入關聯實例。

同連線情況（標準用法）

// ModelB
public function a()
{
    return $this->belongsTo(ModelA::class);
}

跨連線情況（手動組裝）

// ModelB
public function a()
{
    // 1. 建立目標模型實例並切換連線
    $instance = new ModelA;
    $instance->setConnection('connection_name_for_a'); // config/database.php 中定義的連線名

    // 2. 取得該連線下的查詢建構器
    $query = $instance->newQuery();

    // 3. 手動實例化 BelongsTo 關聯物件
    // 建構子: new BelongsTo(Builder $query, Model $parent, $foreignKey, $ownerKey, $relationName)
    return new \Illuminate\Database\Eloquent\Relations\BelongsTo($query, $this);
}

關鍵點解析

• `setConnection()`：動態指定模型使用的連線，不影響全域預設。
• `newQuery()`：回傳綁定該連線的 `Illuminate\Database\Query\Builder`。
• `BelongsTo` 建構子：第一參數為查詢建構器，第二參數為父模型（`$this`），其餘參數可選（外鍵、擁有者鍵、關聯名），框架會按慣例自動推斷。
• 注意：跨資料庫無法使用 `JOIN`、`with()` 預載入（Eager Loading）會退化為 N+1 查詢，需在服務層手動批次載入或接受效能代價。

進階封裝建議

若專案大量跨庫關聯，可建立 Trait 復用：

trait CrossDatabaseRelations
{
    protected function belongsToCross($modelClass, $connection, $foreignKey = null, $ownerKey = null, $relation = null)
    {
        $instance = new $modelClass;
        $instance->setConnection($connection);
        return new \Illuminate\Database\Eloquent\Relations\BelongsTo(
            $instance->newQuery(), $this, $foreignKey, $ownerKey, $relation
        );
    }
}

// 使用
class ModelB extends Model
{
    use CrossDatabaseRelations;

    public function a()
    {
        return $this->belongsToCross(ModelA::class, 'mysql_a');
    }
}