عرض مصدر PHP/session name

<noinclude>{{DISPLAYTITLE:الدالة <code>session_name()</code>‎ في 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 الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Session]]