الفرق بين المراجعتين لصفحة: «PHP/session id»
رؤيا-بنعطية (نقاش | مساهمات) أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة session_id() في PHP }}</noinclude>' |
لا ملخص تعديل |
||
| (4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة session_id() في PHP | <noinclude>{{DISPLAYTITLE:الدالة <code>session_id()</code> في PHP}}</noinclude> | ||
}}</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>. بالنسبة للحروف المسموح بِها في التسمية فهي مِن <code>a</code> حتى <code>z</code> ومِن <code>A</code> حتى <code>Z</code>، ومِن <code>0</code> حتى <code>9</code>، والفاصلة الإنجليزية <code>،</code> وعلامة ناقص "<code>-</code>". | |||
لاحظ أنه عند إستعمال ملفات تعريف الارتباط (cookies) للجلسة، وتحديد معرف جديد لجلسة باستخدام الدالة السابقة، فسوف يُرسل ملفات تعريف الارتباط جديدة عند استدعاء الدالة <code>[[PHP/session start|session_start()]]</code> لبداية الجلسة حتى لو تطابق المعرف الجديد للجلسة مع المُعرِّف القديم. | |||
== القيم المعادة == | |||
تُعيد الدالة <code>session_id()</code> المعرف الجديد للجلسة الحالية أو سلسلة نصية فارغة (<code>""</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. | |||
== مصادر == | |||
* [http://php.net/manual/en/function.session-id.php صفحة الدالة session_id في توثيق PHP الرسمي.] | |||
[[تصنيف:PHP]] | |||
[[تصنيف:PHP Function]] | |||
[[تصنيف: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.