الدالة session_id() في PHP
(PHP 4, PHP 5, PHP 7)
تُعيد الدالة session_id() أو تَضبط المعرف الحالي للجلسة.
الوصف
string session_id ([ string $id ] )
تُعيد الدالة session_id() أو تضبط المعرف الحالي للجلسة.
يُمكن استعمال المعرف الثابت للجلسة (constant SID) لاسترجاع اسم الجلسة ومعرفها في متغير نصي مناسب للإضافة على الروابط (URLs).
المعاملات
id
إذا حُدد المعامل id، سيتمّ تبديل المعرف الحالي للجلسة به، ويجب في هذه الحالة استخدام الدالة session_id() قَبل الدالة session_start(). بالنسبة للحروف المسموح بِها في التسمية فهي مِن a حتى z ومِن A حتى Z، ومِن 0 حتى 9، والفاصلة الإنجليزية ، وعلامة ناقص "-".
لاحظ أنه عند إستعمال ملفات تعريف الارتباط (cookies) للجلسة، وتحديد معرف جديد لجلسة باستخدام الدالة السابقة، فسوف يُرسل ملفات تعريف الارتباط جديدة عند استدعاء الدالة session_start() لبداية الجلسة حتى لو تطابق المعرف الجديد للجلسة مع القديم.
القيم المعادة
تُعيد الدالة session_id() المعرف الجديد للجلسة الحالية أو مُتغير نصي فارغ ("") إذا لم تتواجد جلسة حالية نشطة.
انظر أيضًا
- الدالة
session_regenerate_id(): تُحدث للجلسة بمعرف آخر مُستحدث. - الدالة
session_start(): تبدأ جلسة جديدة أو تستكمل جلسة موجودة. - الدالة
session_set_save_handler(): تُحدددوال التخزين الخاصة بالجلسة على مُستوى المُستخدم user-level. session.save_handler