الفرق بين المراجعتين لصفحة: «PHP/session set cookie params»

من موسوعة حسوب
< PHP
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة session_set_cookie_params()‎ في PHP }}</noinclude>'
 
لا ملخص تعديل
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة session_set_cookie_params()‎ في PHP
<noinclude>{{DISPLAYTITLE:الدالة <code>session_set_cookie_params()</code>‎ في PHP}}</noinclude>
}}</noinclude>
(PHP 4, PHP 5, PHP 7)
 
تضبط الدالة <code>session_set_cookie_params()‎</code> معاملات ملفات تعريف الارتباط للجلسة.
 
== الوصف ==
<syntaxhighlight lang="php">
bool session_set_cookie_params ( int $lifetime [, string $path [, string $domain [, bool $secure = FALSE [, bool $httponly = FALSE ]]]] )
</syntaxhighlight>تعرّف الدالة <code>session_set_cookie_params()</code>‎ في الملف php.ini. يدوم تأثير هذه الدالة مدة تشغيل الشيفرة (البرنامج) فقط. لذلك يجب استدعاء الدالة <code>session_set_cookie_params()</code>‎ عند كلّ طلب وقبل استدعاء الدالة <code>[[PHP/session start|session_start()]]</code>‎.
 
تُحدث الدالة قيم <code>ini</code> لوقت التنفيذ  الحالي لمفاتيح التوثيق لملف PHP ini والتي يمكن  استرجاعها باستخدام الدالة <code>[[PHP/ini get|ini_get()]]</code>‎.
 
== المعاملات ==
 
=== <code>lifetime</code> ===
فترة تشغيل ملفات الارتباط للدالة، تُعرف بالثواني.
 
=== <code>path</code> ===
المسار في النطاق (<code>domain</code>) الذي سيعمل فيه ملف تعريف الإرتباط. استعمل شرطة مائلة مُفردة  ('<code>/</code>') لكل المسارات في الحقل.
 
=== <code>domain</code> ===
نطاق تعريف ملف تعريف الإرتباط، مِثل "<code>wiki.hsoub.com</code>" ولإظهار ملف تعريف الإرتباط على جميع النطاقات الفرعية (subdomains) يجب أن تسبق النطاق بنُقطة مِثل '<code>‎.hsoub.com</code>'.
 
=== <code>secure</code> ===
إذا أُعطيّ القيمة <code>TRUE</code>، فإن ملف تعريف الإرتباط سيُرسل عبر اتصال آمن.
 
=== <code>httponly</code> ===
إذا أُعطيّ القيمة <code>TRUE</code>، فسترسل PHP الراية <code>httponly</code> عند ضبط ملف تعريف الارتباط للجلسة.
 
== القيم المعادة ==
تُعيد الدالة <code>session_set_cookie_params()</code>‎ القيمة <code>TRUE</code> في حالة نجاحها والقيمة <code>FALSE</code> عدا ذلك.
 
== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|7.2.0
|تُعيد الدالة القيمة <code>TRUE</code> في حالة نجاحها والقيمة <code>FALSE</code> عند فشلها، إذ لم تكن تعيد أيّ قيمة فيما سبق (void).
|-
|5.2.0
|أُضيف المعامل <code>httponly</code>.
|}
 
== انظر أيضًا ==
* الدالة <code>[[PHP/session get cookie params|session_get_cookie_params()]]</code>‎: تعيد معاملات ملفات تعريف الارتباط للجلسة.
 
= مصادر =
* [http://php.net/manual/en/function.session-set-cookie-params.php صفحة الدالة session_set_cookie_params في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Session]]

المراجعة الحالية بتاريخ 07:42، 19 أغسطس 2018

(PHP 4, PHP 5, PHP 7)

تضبط الدالة session_set_cookie_params()‎ معاملات ملفات تعريف الارتباط للجلسة.

الوصف

bool session_set_cookie_params ( int $lifetime [, string $path [, string $domain [, bool $secure = FALSE [, bool $httponly = FALSE ]]]] )

تعرّف الدالة session_set_cookie_params()‎ في الملف php.ini. يدوم تأثير هذه الدالة مدة تشغيل الشيفرة (البرنامج) فقط. لذلك يجب استدعاء الدالة session_set_cookie_params()‎ عند كلّ طلب وقبل استدعاء الدالة session_start()‎.

تُحدث الدالة قيم ini لوقت التنفيذ  الحالي لمفاتيح التوثيق لملف PHP ini والتي يمكن  استرجاعها باستخدام الدالة ini_get()‎.

المعاملات

lifetime

فترة تشغيل ملفات الارتباط للدالة، تُعرف بالثواني.

path

المسار في النطاق (domain) الذي سيعمل فيه ملف تعريف الإرتباط. استعمل شرطة مائلة مُفردة  ('/') لكل المسارات في الحقل.

domain

نطاق تعريف ملف تعريف الإرتباط، مِثل "wiki.hsoub.com" ولإظهار ملف تعريف الإرتباط على جميع النطاقات الفرعية (subdomains) يجب أن تسبق النطاق بنُقطة مِثل '‎.hsoub.com'.

secure

إذا أُعطيّ القيمة TRUE، فإن ملف تعريف الإرتباط سيُرسل عبر اتصال آمن.

httponly

إذا أُعطيّ القيمة TRUE، فسترسل PHP الراية httponly عند ضبط ملف تعريف الارتباط للجلسة.

القيم المعادة

تُعيد الدالة session_set_cookie_params()‎ القيمة TRUE في حالة نجاحها والقيمة FALSE عدا ذلك.

سجل التغييرات

الإصدار الوصف
7.2.0 تُعيد الدالة القيمة TRUE في حالة نجاحها والقيمة FALSE عند فشلها، إذ لم تكن تعيد أيّ قيمة فيما سبق (void).
5.2.0 أُضيف المعامل httponly.

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=PHP/session_set_cookie_params&oldid=15191»