إنشاء واستدعاء الدوال

تخيّل أنك تكتب نفس كود الترحيب في كل صفحة: الصفحة الرئيسية، صفحة الحساب، وصفحة لوحة التحكم. بعد أسبوع، تريد تغيير الجملة... فتضطر تعدّلها في 10 أماكن. هنا تظهر قيمة الدالة: تكتب الكود مرة واحدة فقط وتستدعيه أينما تريد.

كيف تنشئ دالة في PHP؟

الكود العام:

function functionName() {
    // code
}

شرح الكود: نكتب الكلمة function، ثم اسم الدالة، ثم جسم الدالة داخل الأقواس المعقوفة. هذا التعريف وحده لا يعني التنفيذ.

قواعد تسمية الدوال في PHP

• اسم الدالة يبدأ بحرف أو شرطة سفلية، وليس رقماً.
• اختَر اسماً يصف المهمة بوضوح.
• التزم بنمط تسمية موحد داخل المشروع (مثل camelCase).

مثال 1: تعريف دالة واستدعاؤها في PHP

الكود:

<?php
function sayHello() {
    echo "مرحباً بك في عالم PHP! <br>";
}

sayHello();
sayHello();
?>

ما يظهر في المتصفح:

مرحباً بك في عالم PHP!
مرحباً بك في عالم PHP!

شرح الكود: الدالة sayHello تحتوي سطر طباعة واحد. عند استدعائها أول مرة طُبع السطر مرة، وعند استدعائها ثانية تكرر السطر. هذا هو جوهر إعادة الاستخدام.

مثال 2: ماذا يحدث إذا عرّفت الدالة ولم تستدعها في PHP؟

الكود:

<?php
function printMessage() {
    echo "لن ترى هذا النص إلا عند الاستدعاء";
}
?>

ما يظهر في المتصفح:

(لا شيء)

شرح الكود: PHP حفظت تعريف الدالة فقط، لكنها لم تنفذها لأنك لم تكتب printMessage();.

مثال 3: دالة لمهمة واقعية في PHP (عنوان قسم)

الكود:

<?php
function printSectionTitle() {
    echo "<h3>أحدث المقالات</h3>";
}

printSectionTitle();
echo "<p>المقال الأول...</p>";
printSectionTitle();
echo "<p>المقال الثاني...</p>";
?>

ما يظهر في المتصفح:

أحدث المقالات
المقال الأول...
أحدث المقالات
المقال الثاني...

شرح الكود: استخدمنا الدالة كقالب صغير يعيد طباعة نفس عنوان القسم كل مرة. هذا يقلل التكرار ويجعل التنسيق موحّداً.

أخطاء شائعة عند إنشاء الدوال في PHP

• تعريف الدالة ونسيان استدعائها.
• اسم دالة غامض لا يوضح وظيفتها.
• حشر مهام كثيرة جداً داخل دالة واحدة.
• نسخ نفس المنطق بدل تحويله لدالة قابلة لإعادة الاستخدام.

نصيحة عملية

تمرين سريع على إنشاء الدوال في PHP

1. أنشئ دالة باسم showWelcome تطبع "أهلاً بك".
2. استدعها 3 مرات في الصفحة.
3. غيّر نص الترحيب داخل الدالة فقط ولاحظ أن كل الاستدعاءات تتأثر.

الأسئلة الشائعة — FAQ

كيف أنشئ دالة في PHP؟

اكتب function ثم اسم الدالة ثم جسمها، وبعد ذلك استدعها باسمها.

هل تعريف الدالة يعني أنها تعمل مباشرة؟

لا، يجب استدعاؤها صراحة.

هل يمكن استدعاء نفس الدالة أكثر من مرة؟

نعم، وهذا الهدف الأساسي منها.

كيف أختار اسم دالة جيد؟

اسم يصف الفعل بوضوح مثل printInvoice أو sendEmail.