مراجعة 19:53، 26 يوليو 2018

(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

مصادر

صفحة الدالة session_id في توثيق PHP الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:الدالة session_id()‎ في PHP
 }}</noinclude>
+(PHP 4, PHP 5, PHP 7)
+تُعيد الدالة <code>session_id()‎</code> أو تَضبط المعرف الحالي للجلسة.
+= الوصف =
+<syntaxhighlight lang="php">
+string session_id ([ string $id ] )
+</syntaxhighlight>تُعيد الدالة <code>session_id()</code>‎ أو تضبط المعرف الحالي للجلسة.
+يُمكن استعمال المعرف الثابت للجلسة (constant SID)  لاسترجاع اسم الجلسة ومعرفها  في متغير نصي مناسب للإضافة على الروابط (URLs).
+== المعاملات  ==
+<code>id</code>
+إذا حُدد المعامل  id، سيتمّ تبديل  المعرف  الحالي للجلسة به، ويجب في هذه الحالة استخدام الدالة <code>session_id()‎</code> قَبل الدالة  <code>[[php/session start|session_start()‎]]</code>. بالنسبة للحروف المسموح بِها في التسمية فهي مِن a حتى z ومِن A حتى Z، ومِن 0 حتى 9، والفاصلة الإنجليزية ، وعلامة ناقص "-".
+لاحظ أنه عند إستعمال ملفات تعريف الارتباط (cookies) للجلسة، وتحديد معرف  جديد لجلسة باستخدام الدالة السابقة، فسوف يُرسل ملفات تعريف الارتباط  جديدة عند استدعاء الدالة <code>[[php/session start|session_start()]]</code>‎ لبداية الجلسة حتى لو تطابق المعرف  الجديد للجلسة مع القديم.
+== القيم المعادة ==
+تُعيد الدالة <code>session_id()</code>‎ المعرف  الجديد للجلسة الحالية أو مُتغير نصي فارغ ("") إذا لم تتواجد جلسة حالية نشطة.
+== انظر أيضًا ==
+* الدالة <code>[[php/session regenerate id|session_regenerate_id()]]</code>‎: تُحدث  للجلسة بمعرف آخر  مُستحدث.
+* الدالة <code>[[php/session start|session_start()‎]]</code>: تبدأ جلسة جديدة أو تستكمل جلسة موجودة.
+* الدالة <code>[[php/session set save handler|session_set_save_handler()]]</code>‎: تُحدددوال التخزين الخاصة بالجلسة على مُستوى المُستخدم user-level.
+* <code>[[php/session save handler|session.save_handler]]</code>
+== مصادر ==
+* [http://php.net/manual/en/function.session-id.php صفحة الدالة session_id في توثيق PHP الرسمي.]