تقوم الدالة المشغل_خطأ () بإنشاء رسالة خطأ معرفة من قبل المستخدم.
يتم استخدام الدالة المشغل_خطأ () لتشغيل رسالة خطأ في ظل الظروف المحددة من قبل المستخدم. يمكن استخدامه مع معالج الأخطاء المضمن، أو مع وظيفة محددة بواسطة المستخدم بواسطة وظيفة set_error_handler(). تكون هذه الوظيفة مفيدة عندما تحتاج إلى تخصيص رسالة خطأ ضمن شرط محدد عند تشغيل برنامج نصي.
إذا تم تحديد نوع خطأ غير قانوني، فسترجع هذه الدالة FALSE، وإلا فإنها ترجع TRUE.
مشغل_خطأ (رسالة_خطأ، أنواع_خطأ)
| المعلمة | يصف |
|---|---|
| error_message | مطلوب. يحدد رسالة الخطأ. الحد الأقصى للطول هو 1024 حرفًا. |
| error_types | خياري. يحدد نوع الخطأ لرسالة الخطأ. أنواع الأخطاء المحتملة: E_USER_ERROR - خطأ فادح في وقت التشغيل أنشأه المستخدم. خطأ غير قابل للاسترداد. توقف عن تنفيذ البرنامج النصي. E_USER_WARNING - تحذير غير فادح من إنشاء المستخدم في وقت التشغيل. البرنامج النصي لم يتوقف عن التنفيذ. E_USER_NOTICE - افتراضي. إشعارات وقت التشغيل التي ينشئها المستخدم. يمكن أن يكون اكتشاف البرنامج النصي خطأ، ولكن يمكن أن يحدث أيضًا عندما يعمل البرنامج النصي بشكل طبيعي. |
<?php$test=2;if ($test>1){trigger_error("تم تشغيل خطأ مخصص");}?>يبدو إخراج الكود أعلاه كما يلي:
ملاحظة : حدث خطأ مخصص في C:webfoldertest.php في السطر 6