مدیریت بهینه داده‌های حجیم در لاراول با استفاده از streamJson

زمان کار با داده‌های حجیم و مهم برگردوند همه اون ها باعث میشه که برنامه‌تون کارایی خودش رو از دست بده و با مشکل حافظه مواجه بشه.

📩 با عضویت در خبرنامه، جدیدترین مطالب و آموزش‌ها را مستقیم در ایمیل خود دریافت کنید.

خبرنامه

لاراول یه راه‌حل خیلی جالب برای این کار پیشنهاد می‌ده به اسم streamJson.
این قابلیت زمانی به‌ کمک شما میاد که نیاز دارید به تدریج دیتاها رو در قالب json به کاربر ارائه بدید 😁.

پشتیبانی streamJson را در مستندات نسخهٔ نصب‌شدهٔ لاراول بررسی کنید؛ به‌روزرسانی پروژه باید همراه با بررسی سازگاری وابستگی‌ها باشد.

درک streamJson

متد streamJson توی لاراول، که از طریق Response قابل دسترسیه، بهت این امکان رو می‌ده که داده‌های JSON رو مرحله‌به‌مرحله استریم کنی. این روش باعث می‌شه برنامه سریع‌تر و
کم‌مصرف‌تر از نظر حافظه کار کنه و برای کار با دیتاست‌های بزرگ یه گزینه‌ی عالی باشه.

response()->streamJson(['data' => $yourDataset]);

مثال واقعی

بیاید یه مثال واقعی بزنیم، فرض کنید قراره یه لیست خیلی بزرگ از محصولات پروژه رو به کاربر نشون بدید با بعضی از رابطه‌هاش.

<?php

namespace App\Http\Controllers;

use App\Models\Inventory;

class InventoryController extends Controller
{
    public function list()
    {
        return response()->streamJson([
            'inventory' => Inventory::with('supplier', 'variants')->lazy(500)->map(function ($item) {
                return [
                    'id' => $item->id,
                    'sku' => $item->sku,
                    'quantity' => $item->quantity,
                    'supplier' => $item->supplier?->name,
                    'variants' => $item->variants->pluck('name'),
                ];
            }),
        ]);
    }
}

توی این مثال، ما از eager loading استفاده کردیم که از درخواست اضافه به دیتابیس جلوگیری کنیم.
از lazy(500) استفاده می‌کنیم تا مدل‌ها دسته‌ای خوانده شوند و eager loading رابطه‌ها نیز امکان‌پذیر باشد.

cursor() امکان eager loading رابطه‌ها را ندارد. برای این مثال از lazy() استفاده شده است؛ مصرف حافظه به اندازهٔ دسته‌ها، تعداد رابطه‌ها و اندازهٔ هر رکورد هم بستگی دارد.

خروجی کد بالا میشه

{
    "inventory": [
        {
            "id": 1,
            "sku": "INV-001",
            "quantity": 150,
            "supplier": "Global Supplies Inc",
            "variants": ["red", "blue", "green"]
        },
        {
            "id": 2,
            "sku": "INV-002",
            "quantity": 75,
            "supplier": "Quality Goods Ltd",
            "variants": ["small", "medium"]
        }
    ]
}

streamJson پاسخ را تدریجی ارسال می‌کند، اما نمایش تدریجی در مرورگر به کلاینت و buffering وب‌سرور یا پراکسی هم بستگی دارد. خواندن پاسخ با response.json() معمولاً تا تکمیل JSON صبر می‌کند.

این متد یک راه حل خیلی عالی و ارزشمند برای کار با دیتاهای بزرگ به شما ارائه میده 😁

امیدوارم از این مقاله خوشتون آمده باشه 👋

مرجع: مستندات رسمی؛ نسخهٔ مستندات را با نسخهٔ پروژهٔ خود تطبیق دهید.

بروزرسانی‌های خبرنامه

آدرس رایانامه‌ی خود را در زیر وارد کنید و مشترک خبرنامه‌ی ما شوید.

پاسخی بگذارید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *