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.

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

Рекомендательные технологии Подробнее

Условные операторы if else в Bash и shell-скриптах

Использование условных операторов if, else и elif в shell-скриптах Bash. Рассматриваются базовый синтаксис, числовые и строковые сравнения, проверки файлов, вложенные условия и практические примеры для повседневных задач администрирования и автоматизации.

Как ускорить Laravel-приложение: параллельные API-запросы через Http::pool и Http::batch

Статья объясняет, как ускорить Laravel-приложения, выполняя API-запросы параллельно с помощью Http::pool и Http::batch. Приводятся практические примеры, обработка ответов и советы по таймаутам.

Распространённые ошибки производительности в Laravel и простые способы их устранения

Практическое руководство по распространённым ошибкам производительности в Laravel и простым способам их устранения. Разбор N+1-запросов, кэширования, оптимизации выборок и других типичных проблем.