Сортировка связанных данных в Laravel: лучшие практики и примеры

Как сортировать данные в связанных моделях Laravel и передавать их в письмах?

В Laravel мы часто работаем со связанными моделями через Eloquent. Например, у нас есть:

• Модель Order (заказ),
• Связанная с ней модель OrderItem (позиции заказа),
• А также возможно связанная модель Product (товар), у которой есть название (поле name). Иногда нужно выводить позиции заказа в определённом порядке, например, по алфавиту или по дате. Ниже разберём несколько способов, как это сделать.

1. Сортировка по умолчанию (и почему она не работает «как надо»)

Когда мы получаем связанные данные через $order->items, Laravel не гарантирует никакого порядка. База данных может вернуть записи в любом порядке, поэтому для гарантированного результата сортировку нужно задать явно.

Важный момент: Даже если кажется, что элементы возвращаются в порядке добавления по полю id, это поведение не является гарантированным и может измениться при переносе данных, обновлении базы или при других условиях.

2. Сортировка в модели (используя orderBy() в методе связи)

Если ты хочешь, чтобы всегда при обращении к $order->items данные приходили отсортированными по одному и тому же полю, можно прописать сортировку в методе связи:

class Order extends Model
{
    public function items()
    {
        return $this->hasMany(OrderItem::class)->orderBy('name'); 
        // или orderBy('created_at') и т.д.
    }
}

После этого, когда ты делаешь $order->items, данные будут автоматически приходить в нужном порядке.

Преимущества

• Удобно, если нужно всегда одинаково сортировать items, где бы они ни использовались.

Недостатки

• Если понадобится другой порядок сортировки (например, по цене вместо имени), придётся прописывать отдельный метод связи или перегружать сортировку в запросе.

3. Сортировка в контроллере через with()

Если нужна гибкость и ты хочешь указать сортировку точечно (например, только при определённом запросе), можно сделать это в контроллере:

$order = Order::with(['items' => function ($query) {
    $query->orderBy('name'); // например, сортируем по имени
}])->find($orderId);

• В этом случае в $order->items мы уже получим готовую коллекцию, отсортированную на уровне базы.
• Это наиболее эффективный способ для больших таблиц: БД оптимизирована для сортировок, а значит результат может быть получен быстрее, чем при сортировке в PHP.

Ситуация, когда нужно сортировать по полю из связанной модели

Допустим, у OrderItem есть связь product(), и мы хотим сортировать по Product.name. В таком случае в join-запросе указываем таблицу products:

$order = Order::with(['items' => function ($query) {
    $query
        ->select('order_items.*') // укажи поля, которые тебе нужны
        ->join('products', 'order_items.product_id', '=', 'products.id')
        ->orderBy('products.name');
}])->find($orderId);

Не забудь добавить ->select() полей, чтобы Eloquent корректно создал объекты OrderItem. Иначе может произойти конфликт, когда Laravel не найдёт поля для order_items в выборке (так как часть полей может затереться полями из products).

4. Сортировка в Blade (через коллекцию)

Если по каким-то причинам нельзя менять запрос к базе (или сортировка нужна только в одном шаблоне, где данных немного), можно воспользоваться встроенным методом коллекций sortBy() в Blade:

@foreach($order->items->sortBy('name') as $item)
    {{ $item->name }}
@endforeach

Laravel получит все items без сортировки, а затем в PHP отсортирует коллекцию. Для небольших наборов это может быть приемлемо. Если же записей много, сортировка на уровне базы данных будет быстрее и эффективнее.

Сортировка по полю связанной модели

Если хочешь сортировать по product->name, нужно использовать анонимную функцию (callback), так как sortBy('product.name') напрямую не сработает:

@foreach($order->items->sortBy(fn($item) => $item->product->name ?? '') as $item)
    {{ $item->product->name }}
@endforeach

5. Сортировка в Mailable

Иногда нужно подготовить данные не только для вывода на странице, но и для отправки в письме. В Laravel для этого используются классы, наследующие Mailable. Пример:

class OrderPlacedForAdmin extends Mailable
{
    use Queueable, SerializesModels;
    public $order;
    public function __construct(Order $order)
    {
        $this->order = $order;
    }
    public function build()
    {
        return $this->view('emails.orders.placed-for-admin')
                    ->with([
                        'items' => $this->order->items,
                    ]);
    }
}

Если мы хотим, чтобы в письме позиции были отсортированы, есть два пути:

5.1. Сортировать в контроллере перед созданием Mailable

$order = Order::with(['items' => function ($query) {
    $query->orderBy('name');
}])->find($orderId);
Mail::to($adminEmail)->send(new OrderPlacedForAdmin($order));

5.2. Сортировать прямо в Mailable через коллекцию

public function build()
{
    return $this->view('emails.orders.placed-for-admin')
                ->with([
                    'items' => $this->order->items->sortBy(fn($item) => $item->product->name ?? ''),
                ]);
}

Какой способ выбрать?

1. Если нужно постоянное и единообразное поведение — пропиши сортировку в методе связи (модель Order, метод items()).
2. Если нужна гибкость — укажи сортировку в контроллере через with(). Это даёт лучший контроль и производительность (сортировка в базе).
3. Если сортировка нужна временно (только на одной странице) — сделай её в Blade через sortBy(). Но учти, что это происходит в PHP, что может быть не очень эффективно при больших объёмах данных.
4. В Mailable — можно воспользоваться любым из вариантов выше или отсортировать коллекцию непосредственно при передаче переменных в шаблон письма.

Вывод

• По умолчанию Eloquent не гарантирует никакого порядка в связанных моделях.
• Наиболее эффективна сортировка на уровне базы данных через orderBy().
• Если нужен кратковременный вариант (или быстро протестировать) — можно прибегнуть к sortBy() коллекции в PHP (например, в Blade или в Mailable). Таким образом, чтобы избежать путаницы с порядком вывода данных в ваших проектах, лучше заранее определиться, где именно нужно сортировать и каким образом, а также учесть производительность и удобство сопровождения кода. Удачи в работе с Laravel!