الدالة function_exists()‎ في PHP

(PHP 4, PHP 5, PHP 7)

تُعيد الدالة function_exists()‎ القيمة TRUE إذا كانت الدالّة المُعطاة مُعرّفة.

الوصف

bool function_exists ( string $function_name )

تتحقق الدالّة function_exists()‎ من وجود الدالة function_name في قائمة الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم.

المعاملات

function_name

سلسلة نصية تُمثِّل اسم الدالة التي نريد التحقق إن كانت موجودةً أم لا.

القيم المعادة

تُعيد الدالة function_exists()‎ القيمة TRUE إذا كانت الدالّة function_name موجودةً، وتُعيد القيمة FALSE في ما عدا ذلك.

ملاحظة: ستُعيد الدالة function_exists()‎ القيمة FALSE من أجل البنى الموجودة في لغة PHP مثل include_once و echo.

أمثلة

المثال 1: مثال عن استخدام الدالة function_exists()‎

<?php
if (function_exists('imap_open')) {
    echo "IMAP functions are available.<br />\n";
} else {
    echo "IMAP functions are not available.<br />\n";
}
?>

ملاحظات

قد يكون اسم الدالة موجودًا حتى ولو كانت الدالة نفسها غير قابلة للاستخدام بسبب خيارات الضبط وبناء لغة PHP (مثل دوال التعامل مع الصور).

انظر أيضًا

• الدالة method_exists()‎: التحقق من وجود الدالة التابعة للصنف.
• الدالة is_callable()‎: التأكد من أن محتوى المتغير يمكن أن يستدعى كدالة.
• الدالة get_defined_functions()‎: إعادة مصفوفة تحتوي على كل الدوال المعرّفة.
• الدالة class_exists()‎: التحقق إذا كان صنفٌ ما معرَّفًا.
• الدالةextension_loaded() ‎: معرفة فيما إذا حُمِّل أحد الامتدادات.

مصادر

• صفحة الدالة function_exists في توثيق PHP الرسمي.