الفرق بين المراجعتين ل"PHP/session id"
رؤيا-بنعطية (نقاش | مساهمات) |
|||
| سطر 15: | سطر 15: | ||
<code>id</code> | <code>id</code> | ||
| − | إذا حُدد المعامل id، | + | إذا حُدد المعامل id، سيُبدَّل المعرف الحالي للجلسة إليه، ويجب في هذه الحالة استخدام الدالة <code>session_id()</code> قَبل الدالة <code>[[PHP/session start|session_start()]]</code>. بالنسبة للحروف المسموح بِها في التسمية فهي مِن <code>a</code> حتى <code>z</code> ومِن <code>A</code> حتى <code>Z</code>، ومِن <code>0</code> حتى <code>9</code>، والفاصلة الإنجليزية <code>،</code> وعلامة ناقص "<code>-</code>". |
| − | لاحظ أنه عند إستعمال ملفات تعريف الارتباط (cookies) للجلسة، وتحديد معرف جديد لجلسة باستخدام الدالة السابقة، فسوف يُرسل ملفات تعريف | + | لاحظ أنه عند إستعمال ملفات تعريف الارتباط (cookies) للجلسة، وتحديد معرف جديد لجلسة باستخدام الدالة السابقة، فسوف يُرسل ملفات تعريف الارتباط جديدة عند استدعاء الدالة <code>[[PHP/session start|session_start()]]</code> لبداية الجلسة حتى لو تطابق المعرف الجديد للجلسة مع المُعرِّف القديم. |
== القيم المعادة == | == القيم المعادة == | ||
| − | تُعيد الدالة <code>session_id()</code> المعرف الجديد للجلسة الحالية أو | + | تُعيد الدالة <code>session_id()</code> المعرف الجديد للجلسة الحالية أو سلسلة نصية فارغة (<code>""</code>) إذا لم تكن هنالك جلسة حالية نشطة. |
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة <code>[[ | + | * الدالة <code>[[PHP/session regenerate id|session_regenerate_id()]]</code>: تُحدث مُعرِّف الجلسة بمعرف آخر مُستحدث. |
| − | * الدالة <code>[[ | + | * الدالة <code>[[PHP/session start|session_start()]]</code>: تبدأ جلسة جديدة أو تستكمل جلسة موجودة. |
| − | * الدالة <code>[[ | + | * الدالة <code>[[PHP/session set save handler|session_set_save_handler()]]</code>: تُحدد دوال التخزين الخاصة بالجلسة على مُستوى المُستخدم user-level. |
| − | |||
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.session-id.php صفحة الدالة session_id في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.session-id.php صفحة الدالة session_id في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | [[تصنيف:PHP]] | ||
| + | [[تصنيف:PHP Function]] | ||
[[تصنيف:PHP Session]] | [[تصنيف:PHP Session]] | ||
مراجعة 11:53، 18 أغسطس 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.