لا توفر لغة PHP آلية مباشرة لإرجاع قيم متعددة من دالة كما هو الحال في بعض اللغات الأخرى (مثل بايثون باستخدام التuples). ومع ذلك، هناك عدة تقنيات تحاكي هذه الوظيفة بفعالية. تستعرض هذه المقالة أربعة من الأساليب الشائعة والفعالة: استخدام المصفوفات، واستخدام المنطق الشرطي، وجمع المصفوفات والمنطق الشرطي، والاستفادة من المُولِّدات.
جدول المحتويات
- إرجاع قيم متعددة باستخدام المصفوفات
- الاسترجاعات الشرطية
- جمع المصفوفات والمنطق الشرطي
- استخدام المُولِّدات لقيم متعددة
إرجاع قيم متعددة باستخدام المصفوفات
تتمثل أبسط الطرق وأكثرها استخدامًا في إرجاع مصفوفة تحتوي على قيم متعددة. يتم الوصول إلى كل قيمة باستخدام مفتاحها أو مؤشرها. هذا الأسلوب نظيف وسهل القراءة بشكل خاص لإرجاع مجموعة ثابتة من القيم.
<?php
function getUserData($userId) {
// محاكاة جلب البيانات من قاعدة البيانات
$userData = [
'id' => $userId,
'name' => 'John Doe',
'email' => '[email protected]',
];
return $userData;
}
$user = getUserData(123);
echo "معرف المستخدم: " . $user['id'] . "<br>";
echo "اسم المستخدم: " . $user['name'] . "<br>";
echo "بريد المستخدم الإلكتروني: " . $user['email'] . "<br>";
?>
يُرجع هذا المثال مصفوفة ارتباطية. يصل الكود المُستدعي إلى كل قيمة باستخدام مفتاحها.
الاسترجاعات الشرطية
عندما يعتمد عدد أو نوع القيم المُرجعة على شروط داخل الدالة، يكون المنطق الشرطي ضروريًا. يتم إرجاع قيم مختلفة بناءً على النتيجة.
<?php
function checkNumber($number) {
if ($number > 0) {
return "موجب";
} elseif ($number < 0) {
return "سالب";
} else {
return "صفر";
}
}
echo checkNumber(5) . "<br>"; // الإخراج: موجب
echo checkNumber(-3) . "<br>"; // الإخراج: سالب
echo checkNumber(0) . "<br>"; // الإخراج: صفر
?>
تعيد هذه الدالة سلسلة نصية ديناميكيًا بناءً على الرقم المدخل.
جمع المصفوفات والمنطق الشرطي
يوفر الجمع بين المصفوفات والمنطق الشرطي المرونة. يتغير محتوى المصفوفة المُرجعة بناءً على الشروط.
<?php
function processData($data) {
if (isset($data['name'])) {
return [
'status' => 'success',
'name' => $data['name'],
];
} else {
return [
'status' => 'error',
'message' => 'الاسم مفقود',
];
}
}
$result1 = processData(['name' => 'Jane Doe']);
$result2 = processData([]);
print_r($result1);
print_r($result2);
?>
يُرجع هذا مصفوفة تشير إلى النجاح أو الخطأ، مع بيانات إضافية بناءً على الإدخال.
استخدام المُولِّدات لقيم متعددة
بالنسبة لمجموعات البيانات الكبيرة أو العمليات التكرارية، توفر مُولِّدات PHP الكفاءة. إنها “تُنتج” قيمًا واحدة تلو الأخرى، مما يتجنب مشاكل الذاكرة المرتبطة بتخزين كل شيء مرة واحدة.
<?php
function generateNumbers($limit) {
for ($i = 0; $i < $limit; $i++) {
yield $i;
}
}
foreach (generateNumbers(5) as $number) {
echo $number . " "; // الإخراج: 0 1 2 3 4
}
?>
تستخدم generateNumbers yield لإرجاع الأرقام بشكل تسلسلي، وهو مثالي لمجموعات البيانات الكبيرة.
باختصار، على الرغم من أن PHP تفتقر إلى ميزة “القيم المُرجعة المتعددة” المباشرة، إلا أن المصفوفات، والمنطق الشرطي، والمُولِّدات توفر بدائل فعالة، مما يسمح لك باختيار أفضل نهج بناءً على احتياجاتك المحددة وتعقيد الدالة.