شرح صفوف ومحتوى الفقرة
تقبل دالة insert في باني الاستعلامات مصفوفة ترابطية لإدراج سجل واحد أو مصفوفة من المصفوفات لإدراج مئات السجلات دفعة واحدة في جملة SQL واحدة. وعندما تحتاج للحصول فوراً على رقم المعرف التلقائي للسجل المضاف، استدعِ دالة insertGetId.
- الإدراج الفردي والجماعي (insert): إضافة صف واحد أو دفعة صفوف في استعلام واحد وإرجاع قيمة منطقية.
- استرجاع المعرف (insertGetId): إدراج سجل جديد وإرجاع رقم المعرف الأساسي المتزايد الذي ولدته القاعدة.
- الطوابع الزمنية: لا يملأ Query Builder حقول التاريخ تلقائياً عند الإدراج، لذا تمرر الدالة now صراحةً.
PHP
$orderId = DB::table('orders')->insertGetId([
'user_id' => 1,
'total' => 240.00,
'created_at' => now(),
]);