عرض مصدر PHP/exit

<noinclude>{{DISPLAYTITLE:البنية <code>exit()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

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

== الوصف ==
<syntaxhighlight lang="php">
void exit ([ string $status ] )
void exit ( int $status )

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

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

== المعاملات ==

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

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

== القيم المعادة ==
لا تعيد البنية <code>exit()</code>‎ قيمًا.

== أمثلة ==
المثال 1: مثال على البنية <code>exit()</code>‎<syntaxhighlight lang="php">
<?php
$filename = '/path/to/data-file';
$file = fopen($filename, 'r')
  or exit("unable to open file ($filename)");
?>
</syntaxhighlight>المثال 2: مثال على استخدام المعامل <code>status</code><syntaxhighlight lang="php">
<?php
// تغلق البرنامج بشكل طبيعي
exit;
exit();
exit(0);
// تغلق البرنامج مع حالة خروج تشير إلى خطأ
exit(1);
exit(0376); // في النظام الثماني
?>
</syntaxhighlight>المثال 3: مثال على تشغيل دوال إيقاف التشغيل والدالة الهادمة دون عائق<syntaxhighlight lang="php">
<?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.';
?>
</syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang="text">
Shutdown: shutdown()
Destruct: Foo::__destruct()
</syntaxhighlight>

== ملاحظات ==
ملاحظة: نظرًا لأن <code>exit()‎</code> بنية من بنى اللغة وليست دالةً، فلا يمكن استدعائها باستخدام [[PHP/variable functions|الدوال المتغيرة]].

ملاحظة: تكافئ البنيةُ <code>exit()</code>‎ البنيةَ <code>[[PHP/die|die()]]</code>‎.

== انظر أيضًا ==
* الدالة <code>[[PHP/register shutdown function|register_shutdown_function()‎]]</code>: تسجيل دالة للتنفيذ عند إيقاف التشغيل.

== مصادر ==
* [http://php.net/manual/en/function.exit.php صفحة البنية exit في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Miscellaneous]]