Laravel: Eager loading может выполнить запрос не туда

Когда вы работаете с несколькими базами данных в Laravel, есть один довольно хитрый подвох при использовании жадной загрузки (eager loading) и он легко может сбить вас с толку.

Представьте, что в вашем приложении есть две модели:

  • Order - хранится в внешней базе данных;

  • Customer - живёт в основной (дефолтной) базе данных.

Примерно так:

class Order extends Model
{
    protected $connection = 'external';

    public function customer(): BelongsTo
    {
        return $this->belongsTo(Customer::class);
    }
}

class Customer extends Model
{
    // использует базу по умолчанию
}

Вы могли бы логично ожидать, что при выполнении запроса:

Order::with('customer')->get();

Laravel получит заказы из внешней базы данных (external) и отдельно клиентов из основной (mysql), как указано в настройках. Но на практике это не работает так, как кажется.

Фреймворк пытается найти таблицу customers в той же базе данных, что и заказы, то есть в external. Это приведёт к ошибке, потому что таблицы там просто нет.

Почему так происходит

В Laravel при eager loading создаётся новый экземпляр модели, на который затем накладываются ограничения для связи. Но если связанная модель не имеет явного свойства $connection, то Laravel автоматически унаследует соединение родителя.

А это означает, что связь customer будет искать customers в той же базе данных, что и orders, то есть в external, хотя мы хотим, чтобы она использовала дефолтную базу.

Как исправить

Решение простое: всегда указывайте свойство $connection даже для модели, которая должна использовать стандартное соединение. Так Laravel не будет приписывать ей внешний connection от родителя.

В итоге модель Customer должна выглядеть так:

class Customer extends Model
{
    protected $connection = 'mysql';
}

Теперь запрос Order::with('customer')->get() будет работать корректно: заказы получаются из external, а данные клиентов из mysql.

Похожие статьи

Рекомендательные технологии Подробнее
Разработка и инструменты 7 месяцев назад

Генерация PDF в Laravel: Spatie Laravel PDF vs Laravel DomPDF

Сравнение двух популярных пакетов для генерации PDF в Laravel, современного Spatie Laravel PDF с рендерингом через браузер и классического Laravel DomPDF, который работает в чистом PHP. Обсуждаем преимущества, примеры, ограничения и когда что использовать.

Разработка и инструменты 7 месяцев назад

Оптимизация Laravel-приложений с Octane

Полное руководство по Laravel Octane: от базовой концепции до настройки, особенностей и сравнения с классическим подходом. Узнайте, как Octane ускоряет Laravel-приложения и когда его стоит использовать.