عرض مصدر PHP/session destroy

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

تدمر الدالة <code>session_destroy()</code>‎  جميع البيانات المُسجلة في الجلسة.

== الوصف ==
<syntaxhighlight lang="php">
bool session_destroy ( void )
</syntaxhighlight>

تُدمر الدالة جميع البيانات المُصاحبة للجلسة الحالية. ولا تقوم بمسح أيًا مِن المُتغيرات العامة (global variables) أو ملفات تعريف الارتباط للدالة. ولاستخدام المُتغيرات مُجددًا، يجب استخدام الدالة <code>[[PHP/session start|()session_start]]</code>.

ملاحظة:  لست مضطرًا لاستدعاء الدالة <code>[[PHP/session destroy|session_destroy()‎]]</code> في الكود العادي. نظف المصفوفة ‎<code>$_SESSION</code> بدلًا مِن تدمير بيانات الجلسة.

لتدمير الجلسة كلها يجب مسح معرّف الجلسة وإذا كان محفوظًا في ملف تعريف الارتباط، يجب مسحه كذلك، ويُمكن استعمال الدالة <code>[[PHP/setcookie|setcookie()‎]]</code> لذلك.

عند تفعيل <code>session.use.strict_mode</code>، لا يلزم مسح ملف تعريف الارتباط الخاص بمعرّف الجلسة لأن وحدة الجلسة بطبعها لا تقبل ملف تعريف الارتباط الخاص بمعرّف الجلسة وستضبط معرّفًا جديدًا.

تفعيل <code>session.use_strict_mode</code> مُحبذ لكُل المواقع.

تحذير: على الرغم من أن وحدة الجلسة الحالية لا تقبل ملف تعريف ارتباط فارغ للجلسة ، إلا أن الحذف الفوري للجلسة قد يؤدي إلى ملف تعريف ارتباط فارغ بسبب حالة السباق الجانبية (side race condition) للعميل (المتصفح). سيؤدي ذلك إلى أن العميل سينشئ أكثر من معرف للجلسة دون داع. ولتجنب ذلك يجب ضبط المُدة الزمنية للمسح في المُتغير ‎<code>$_SESSION</code> ورفض أي دخول لاحق. أو تأكد أن البرنامج لا يحتوي على أي طلبات متزامنة للمعرّف، وهذا ينطبق على الدالة <code>[[PHP/session regenerate id|session_regenerate_id()‎]]</code> أيضًا.  

== القيم المعادة ==
تُعيد الدالة <code>session_destroy()‎</code> القيمة <code>TRUE</code> في حالة نجاحها، والقيمة <code>FALSE</code> عدا ذلك.

== أمثلة ==
المثال 1: تدمير الدالة بواسطة المُتغير <code>‎$_SESSION</code><syntaxhighlight lang="php">
<?php
// session_name(“anyName”) بدء الجلسة – لا تنس إذا كُنت أعطيت الجلسة اسمًا
session_start();

// فك ضبط جميع مُتغيرات الدالة
$_SESSION = array();

// إذا كُنت تريد تدمير الجلسة وجب تدمير ملفات الارتباط
// لاحظ أن الدالة سوف تمسح الجلسة كاملةً وليس مُجرد البيانات
if (ini_get("session.use_cookies")) {
    $params = session_get_cookie_params();
    setcookie(session_name(), '', time() - 42000,
        $params["path"], $params["domain"],
        $params["secure"], $params["httponly"]
    );
}

// تدمير الجلسة بالنهاية
session_destroy();

?>

</syntaxhighlight>لاحظ أن الدالة <code>[[PHP/session unset|session_unset()]]</code>‎ تُستعمل في الأكواد القديمة التي لا تستخدم ‎<code>$_SESSION</code>.

== انظر أيضًا ==
* الدالة <code>[[PHP/session reset|session_reset()]]</code>‎: تُعيد بدء الدالة بقيمها الأصلية.
* الدالة <code>[[PHP/session regenerate id|session_regenerate_id()]]</code>‎: تحدث المعرف الفريد الحالي للجلسة باستخدام رقم مُستحدث.
* الدالة <code>[[PHP/unset|unset()‎]]</code>: تزيل ضبط مُتغير مُعطى بالفعل.
* الدالة <code>[[PHP/setcookie|setcookie()‎]]</code>: تُرسل ملفات تعريف الارتباط .

== مصادر ==
* [http://php.net/manual/en/function.session-destroy.php صفحة الدالة session_destroy في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Session]]