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