PHP/exit

(PHP 4, PHP 5, PHP 7)

تُخرج البنية exit()‎ رسالةً وتنهي البرنامج الحالي.

الوصف

void exit ([ string $status ] )

void exit ( int $status )

توقف البنية exit()‎ تنفيذ البرنامج. أما دوال إيقاف التشغيل والدالة الهادمة فستُنفَّذ دومًا حتى في حالة استدعاء البنية exit()‎.

البنية exit()‎ بنية من بنى اللغة (language construct)، ويمكن استدعاؤها بدون أقواس إذا لم يُمَرر إليها المعامل status.

المعاملات

status

إذا كانت قيمة المعامل status سلسلةً نصيةً، فستطبع البنية اللغوية exit()‎ المعامل status قبل إنهاء تنفيذ السكربت.

إذا كان المعامل status عددًا صحيحًا، فستستخدم هذه القيمة كحالة خروج ولن تُطبع. يجب أن تكون حالات الخروج في المدى من 0 إلى 254، وحالة الخروج 255 محجوزة بواسطة PHP ولا يجوز استخدامها، وتستخدم الحالة 0 لإنهاء البرنامج بنجاح.

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

لا تعيد البنية exit()‎ قيمًا.

أمثلة

المثال 1: مثال على البنية exit()‎

<?php

$filename = '/path/to/data-file';

$file = fopen($filename, 'r')

   or exit("unable to open file ($filename)");

?>

المثال 2: مثال على استخدام المعامل status

<?php

// تغلق البرنامج بشكل طبيعي

exit;

exit();

exit(0);

// تغلق البرنامج مع حالة خروج تشير إلى خطأ

exit(1);

exit(0376); // في النظام الثماني

?>

المثال 3: مثال على تشغيل دوال إيقاف التشغيل والدالة الهادمة دون عائق

<?php

class Foo

{

   public function __destruct()

   {

       echo 'Destruct: ' . __METHOD__ . '()' . PHP_EOL;

   }

}

function shutdown()

{

   echo 'Shutdown: ' . __FUNCTION__ . '()' . PHP_EOL;

}

$foo = new Foo();

register_shutdown_function('shutdown');

exit();

echo 'This will not be output.';

?>

ناتج المثال السابق:

Shutdown: shutdown()

Destruct: Foo::__destruct()

ملاحظات

ملاحظة: نظرًا لأن exit()‎ بنية من بنى اللغة وليست دالةً، فلا يمكن استدعائها باستخدام الدوال المتغيرة.

ملاحظة: تكافئ البنيةُ exit()‎ البنيةَ die()‎.

انظر أيضًا

• الدالة register_shutdown_function()‎: تسجيل دالة للتنفيذ عند إيقاف التشغيل.

مصادر

• صفحة البنية exit في توثيق PHP الرسمي.