زمان کار با دادههای حجیم و مهم برگردوند همه اون ها باعث میشه که برنامهتون کارایی خودش رو از دست بده و با مشکل حافظه مواجه بشه.
📩 با عضویت در خبرنامه، جدیدترین مطالب و آموزشها را مستقیم در ایمیل خود دریافت کنید.
لاراول یه راهحل خیلی جالب برای این کار پیشنهاد میده به اسم 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 صبر میکند.
این متد یک راه حل خیلی عالی و ارزشمند برای کار با دیتاهای بزرگ به شما ارائه میده 😁
امیدوارم از این مقاله خوشتون آمده باشه 👋
مرجع: مستندات رسمی؛ نسخهٔ مستندات را با نسخهٔ پروژهٔ خود تطبیق دهید.

