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 الكامل بالعربي.