تعلم الدوال في PHP - شرح مبسط وشامل للمبتدئين

🚀 إتقان الدوال في PHP: اجعل كودك أنظف وأذكى!

اليوم سنتحدث عن مفهوم من أهم مفاهيم البرمجة على الإطلاق، وهو الدوال (Functions).

هل سبق لك أن كتبت مجموعة من الأسطر البرمجية ووجدت نفسك تكررها في أماكن مختلفة من مشروعك؟ هنا يأتي دور الدالة! بدلاً من كتابة نفس الكود 10 مرات، نكتبه "مرة واحدة" داخل دالة، ثم نستدعي هذه الدالة كلما احتجنا إليها. 💡

📋 ما هي الدالة (Function) ببساطة؟

الدالة هي عبارة عن "كتلة من الكود" يتم تجميعها تحت اسم معين. هذه الكتلة لا تعمل من تلقاء نفسها بمجرد كتابتها، بل تظل "نائمة" حتى تقوم أنت بـ استدعائها (Calling) بالاسم الذي اخترته لها.

تخيل الدالة كأنها "وصفة طعام":

• كتابة الدالة = كتابة طريقة عمل الطبخة في كتاب الوصفات.
• استدعاء الدالة = البدء فعلياً في طبخ الوجبة عندما تشعر بالجوع.

🛠️ كيف ننشئ دالة بسيطة في PHP؟

لإنشاء دالة، نستخدم الكلمة المحجوزة function متبوعة باسم الدالة، ثم أقواس دائرية () وعلامة {} التي تحتوي على الكود.

إليك أبسط مثال ممكن:

<?php
// تعريف الدالة (الآن الدالة نائمة)
function sayHello() {
    echo "Hello! Welcome to Codex Academy."; // هذا الكود سيتم تنفيذه عند استدعاء الدالة
}

// استدعاء الدالة (الآن الدالة تعمل)
sayHello(); 
?>

شرح الكود:

1. استخدمنا function لإخبار PHP أننا سننشئ دالة.
2. أسمينا الدالة sayHello (يجب أن يكون الاسم واضحاً ومعبراً).
3. وضعنا الكود الذي نريد تكراره بين القوسين { }.
4. في السطر الأخير، قمنا بكتابة sayHello(); وهذا ما يسمى "الاستدعاء"، وبدونه لن يظهر أي شيء على الشاشة. 🖥️

📥 تمرير البيانات للدالة (Parameters)

أحياناً، لا نريد من الدالة أن تفعل نفس الشيء بالضبط في كل مرة، بل نريدها أن تتغير بناءً على "معطيات" نعطيها لها. هنا نستخدم ما يسمى بـ المعاملات (Parameters).

المعاملات هي متغيرات نضعها داخل الأقواس عند تعريف الدالة، لتعمل كـ "مداخل" للبيانات.

مثال عملي: دالة ترحب بمستخدم حسب اسمه:

<?php
// تعريف الدالة مع معامل اسمه name
function greetUser($name) {
    echo "Hello " . $name . ", welcome back!";
}

// استدعاء الدالة بأسماء مختلفة
greetUser("Ahmed"); // سيطبع: Hello Ahmed, welcome back!
echo "<br>";
greetUser("Sara");   // سيطبع: Hello Sara, welcome back!
?>

ماذا حدث هنا؟

• الدالة greetUser أصبحت مرنة؛ فهي تستقبل أي اسم نرسله لها عبر المتغير $name وتطبعه.

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

في الأمثلة السابقة، كانت الدالة تقوم بطباعة النتيجة مباشرة باستخدام echo. لكن في الواقع، نحتاج أحياناً أن تقوم الدالة بحساب شيء ما و "تعيده" إلينا لنستخدمه في مكان آخر في البرنامج. هنا نستخدم الكلمة المفتاحية return.

مثال: دالة تقوم بجمع رقمين وإرجاع الناتج:

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

// الآن نخزن القيمة التي ستعود من الدالة في متغير
$total = sumNumbers(10, 20);

echo "The total is: " . $total; // سيطبع: The total is: 30
?>

لماذا استخدمنا return بدلاً من echo؟

• لأن return تمنحنا الحرية في التحكم في النتيجة. يمكننا تخزينها في متغير، أو جمعها مع رقم آخر، أو طباعتها لاحقاً. أما echo فهي تطبع القيمة فوراً ولا يمكنك استخدامها في عمليات حسابية لاحقاً. 🧮

💡 ملخص سريع لما تعلمناه:

1. الدالة: هي كود مجمع تحت اسم معين لتقليل التكرار.
2. التعريف: يتم باستخدام كلمة function.
3. الاستدعاء: يتم بكتابة اسم الدالة متبوعاً بـ ().
4. المعاملات (Parameters): هي القيم التي نمررها للدالة لتغيير سلوكها.
5. الإرجاع (Return): يستخدم لإرسال النتيجة النهائية من الدالة إلى المكان الذي استُدعيت منه.