الدالة 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.