تخطَّ إلى المحتوى

name: value

الوسائط المسمّاة (Named Arguments) name: value

تمرير قيمة لمعامل باسمه بدل ترتيبه الموضعي، مفيد لتخطّي معاملات اختيارية.

الوسائط المسمّاة (منذ PHP 8.0) تُكتب باسم المعامل متبوعًا بنقطتين ثم القيمة. يمكن تمريرها بأي ترتيب، ودمجها مع وسائط موضعية بشرط أن تأتي الموضعية أولًا.

الصياغة

functionName(paramName: $value, otherParam: $value2);

📄 مثال

function makeUser(string $name, string $role = "عضو", bool $active = true) {}

makeUser(name: "سارة", active: false);   // تخطّي role دون تكرار قيمته

أهم النقاط

العنصرالوظيفة
الترتيبلا يهمّ ترتيب الوسائط المسمّاة فيما بينها
الدمج مع الموضعيةالموضعية يجب أن تأتي قبل المسمّاة دائمًا

💡 نصائح عملية

  • استخدمها لتخطّي معاملات اختيارية وسطى دون تكرار قيمها الافتراضية

⚠️ أخطاء شائعة

  • تمرير نفس المعامل مرّتين (مسمّى وموضعي) — يرمي Error

خصائص ذات صلة

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار PHP الكامل بالعربي.