مرحباً بكم في الدرس السادس من دورة PHP للمبتدئين!

أهلاً بك أيها المبرمج البارع. حتى الآن، تعلمنا كيف نخزن البيانات في المتغيرات وكيف نتحكم في مسار تنفيذ الكود باستخدام الشروط والحلقات التكرارية. في هذا الدرس، سنتناول مفهوماً محورياً وعميقاً في البرمجة: الدوال (Functions).

الدوال هي باختصار "أدوات" أو "وحدات بناء" تساعدنا على كتابة كود منظم، قابل لإعادة الاستخدام، وخالٍ من التكرار. لنفترض أن لديك جملة معينة تريد طباعتها بشروط محددة عدة مرات في ملفك، بدلاً من إعادة كتابة نفس الكود، تقوم بإنشاء دالة واحدة واستدعائها متى شئت.

ما هي الدالة (Function) وكيف يتم تعريفها؟

الدالة هي كتلة برمجية (Code Block) تؤدي مهمة محددة. في لغة PHP، هناك نوعان رئيسيان من الدوال: دالة جاهزة مدمجة في اللغة (مثل echo و strlen)، ودوال مخصصة يقوم المبرمج بإنشائها بنفسه.

لتعريف دالة جديدة، نستخدم الكلمة المفتاحية function تليها تسمية الدالة، ثم أقواس ()، وأخيراً الأقواس المعقوفة {} التي تحوي الكود الذي ستنفذه الدالة.

<?php
// تعريف دالة بسيطة تقوم بطباعة مرحباً
function sayHello() {
    echo "مرحباً بك في عالم الدوال البرمجية!";
}

// استدعاء الدالة لتنفيذ الكود الذي بداخلها
sayHello();
?>

استخدام المعاملات (Parameters) والقيم المدخلة

لكي تصبح الدوال أكثر مرونة، يمكننا تمرير بيانات إليها تُسمى المعاملات (Parameters). هذه المعاملات تشبه المتغيرات، ولكن قيمتها تُحدد عند استدعاء الدالة.

<?php
// دالة تستقبل معامل واحد وهو الاسم
function greetUser($name) {
    echo "أهلاً بك يا " . $name . "<br>";
}

// استدعاء الدالة مع تمرير قيم مختلفة
greetUser("أحمد");
greetUser("سارة");
greetUser("محمد");
?>

إرجاع القيم باستخدام (return)

في كثير من الأحيان، لا نريد من الدالة أن تطبع النتيجة مباشرة على الشاشة، بل نريد منها أن تُجري عملية حسابية أو معالجة ثم تُرجع (Return) النتيجة لكي نستიدمها في مكان آخر من البرنامج.

<?php
// دالة تقوم بجمع رقمين وترجع النتيجة
function calculateSum($num1, $num2) {
    $sum = $num1 + $num2;
    return $sum; // إرجاع الناتج
}

// تخزين النتيجة المرتجعة في متغير وطباعتها
$result = calculateSum(10, 15);
echo "مجموع الرقمين هو: " . $result; // النتيجة ستكون 25
?>

للمزيد من التفاصيل والاطلاع على الدوال المتقدمة والمدمجة في اللغة، يمكنك زيارة التوثيق الرسمي للغة PHP.

خلاصة الدرس

تعلمنا اليوم كيف نكتب دوال خاصة بنا لتفادي تكرار الكود، وكيف نمرر لها معاملات لزيادة مرونتها، وكيف نستخدم الكلمة return للحصول على النتائج ومعالجتها. في الدرس القادم سنستمر في التعمق أكثر. بالتوفيق!