الفرق بين المراجعتين لصفحة: «PHP/session name»
رؤيا-بنعطية (نقاش | مساهمات) لا ملخص تعديل |
رؤيا-بنعطية (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 47: | سطر 47: | ||
= مصادر = | = مصادر = | ||
* [http://php.net/manual/en/function.session-name.php صفحة الدالة session_name في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.session-name.php صفحة الدالة session_name في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | |||
[[تصنيف:PHP Session]] | |||
مراجعة 21:07، 26 يوليو 2018
(PHP 4, PHP 5, PHP 7)
تعيد الدالة session_name() أو تضبط إسم الجلسة الحالية.
الوصف
string session_name ([ string $name ] )
تعيد هذه الدالة اسم الجلسة الحالية، وإذا أُعطيت قيمة للمعامل name سوف تُحدث الدالة اسم الجلسة بهذه القيمة وتعيد اسم الجلسة القديم.
عند استعمال اسم جديد للجلسة، فإن دالة session_name() تُعدل ملف تعريف الارتباط الخاص ببروتوكول (http cookie) HTTP، لذلك يجب استعمال الدالة session_name() قبل الدالة session_start() لكي تعمل بطريقة صحيحة بدون أخطاء.
المعاملات
name
هذا المعامل مسؤول عن اسم الجلسة المستعمل في ملفات تعريف الارتباط والروابط (URLs). ويجب أن يتكوّن من أرقام وحروف فقط، ويُستحسن أن تكون قصيرة وواصفة (مِثل المُستخدمين السامحين لإنذارات ملفات الارتباط).
تحذير: يجب أن يحتوي اسم الجلسة على حرف واحد على الأقل، حيث إذا استخدمت حروف فقط سيتم تعيين معرف جديد للجلسة.
القيم المعادة
تعيد الدالة ()session_nameاسم الجلسة الحالي، وفي حالة تعيين اسم جديد للجلسة فإنها تُعيد الاسم القديم للجلسة.
أمثلة
مثال 1: استخدام دالة session_name()
<?php
/* WebsiteID ضبط اسم الجلسة بالقيمة*/
$previous_name = session_name("WebsiteID");
echo "The previous session name was $previous_name<br />";
?>
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 7.2.0 | في هذا الإصدار تقوم الدالة بالتأكد مِن حالة الجلسة، بينما سابقًا كانت تتأكد الدالة مِن حالة ملف تعريف الارتباط. لذلك الإصدار القديم من الدالة كان يسمح باستدعائها بعد دالة session_start() والذي قد يسبب انهيار PHP وينشأ عنه أخطاء.
|