عرض مصدر PHP/user defined functions

<noinclude>{{DISPLAYTITLE:الدوال المعرّفة من طرف المستخدم في PHP}}</noinclude>
يمكن تعريف الدالة باستخدام الصيغة التالية:

المثال 1: صيغة التعريف عن الدوال
<syntaxhighlight lang="php">

<?php
function foo($arg_1, $arg_2, /* ..., */ $arg_n)
{
echo "Example function.\n";
return $retval;
}
?>
</syntaxhighlight>
يمكن إضافة أي نوع من الشيفرة داخل الدالة، بل ويمكن إضافة دوالّ أخرى أو تعريف أصناف داخل الدالة.

تتبع أسماء الدوالّ نفس القواعد المتبّعة في اللغة للتسمية. يبدأ الاسم الصحيح للدالة بحرف أو شرطة سفلية، متبوعًا بأيّ عددٍ من الحروف أو الأرقام أو الشرطات السفلية. ويمكن التعبير عن هذه الصيغة باستخدام التعابير النمطية بالصورة التالية: <code>‎[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*‎</code>.

نصيحة: راجع [[PHP/Userland Naming|دليل تسمية Userland.]]

لا حاجة إلى تعريف الدوالّ قبل الإشارة إليها، باستثناء الحالة التي تُعرّف فيها الدوّال شرطيًا كما هو موضّح في المثالين أدناه.

عندما يكون تعريف الدالة مشروطًا، يجب أن تُعرّف الدالة قبل استدعائها.

لاحظ في المثال التالي أنّه لا يمكن استدعاء الدالة <code>foo()</code>‎ في البداية لأنّها غير موجودة بعد، ولكن يمكن استدعاء الدالة <code>bar()‎</code>، ولكن بعد إضافة الجملة الشرطية يصبح بالإمكان استدعاء الدالة <code>foo()‎</code> لأن نتيجة العبارة الشرطية هي <code>true</code>.

المثال 2: الدوال الشرطية

<syntaxhighlight lang="php">


<?php

$makefoo = true;

/* لا يمكن استدعاء الدالة هنا لأنّها لا تزال غير معرّفة */

bar();

if ($makefoo) {
  function foo()
  {
    echo "I don't exist until program execution reaches me.\n";
  }

}

/* يمكن استدعاء الدالة هنا لتحقّق العبارة الشرطية */

if ($makefoo) foo();

function bar()
{
  echo "I exist immediately upon program start.\n";
}

?>
</syntaxhighlight>

في المثال التالي لا يمكن استدعاء الدالة <code>bar()‎</code> في البداية لأنّها لا تزال غير معرّفة، ولكن بعد معالجة الدالة <code>foo()</code>‎ تصبح الدالة <code>bar()‎</code> متاحة للاستدعاء.

المثال 3: استخدام الدوال داخل الدوال
<syntaxhighlight lang="php">

<?php
function foo()
{
  function bar() 
  {
    echo "I don't exist until foo() is called.\n";
  }

}

/* لا يمكن استدعاء الدالة هنا لأنّها غير موجودة */

foo();

/* أصبحت الدالة متاحة للاستدعاء */

bar();

?>
</syntaxhighlight>

تمتلك جميع الدوالّ والأصناف في PHP نطاقًا عامًّا global scope، بمعنى أنّه يمكن استدعاؤها من خارج الدالة حتى لو كانت معرّفة داخل دالّة أخرى والعكس صحيح أيضًا.

لا تدعم PHP خاصية زيادة التحميل (overloading) بالنسبة للدوال، ولا يمكن أيضًا إلغاء تعريف دالة أو إعادة تعريف دالة معرّفة مسبقًا.

ملاحظة: أسماء الدوالّ غير حسّاسة لحالة الأحرف، ولكن يفضّل استدعاء الدوال بنفس الحروف المستخدمة لتعريفها.

تدعم الدوال في PHP عددًا [[PHP/variable functions|متغيرًا من المعاملات]] [[PHP/function arguments|والمعاملات الافتراضية]]. وللمزيد من المعلومات راجع التوثيقات الخاصّة بالدوال <code>[[PHP/func_num_args|func_num_args()‎‎]]</code> و <code>[[PHP/func_get_arg|func_get_arg()‎‎]]</code> و <code>[[PHP/func_get_args|func_get_args()]]</code>‎‎.

يمكن استدعاء الدوال التعاودية (recursive functions) في PHP.

المثال 4: الدوال التعاودية

<syntaxhighlight lang="php">

<?php
function recursion($a)
{
    if ($a < 20) {
        echo "$a\n";
        recursion($a + 1);
    }

}
?>
</syntaxhighlight>

ملاحظة: يمكن للدوالّ أو التوابع التكرارية التي تصل مستويات التكرار فيها 100 أو 200 مرحلة أن تتسبّب في تحطيم مكدس الاستدعاء stack وإيقاف عمل الشيفرة. أما المستويات اللانهائية من التكرار فتعدّ خطأً برمجيًا.

== مصادر ==
* [http://php.net/manual/en/functions.user-defined.php صفحة User-defined Functions في توثيق PHP الرسمي.]
[[تصنيف:PHP|{{SUBPAGENAME}}]]
[[تصنيف:PHP Functions|{{SUBPAGENAME}}]]