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

من موسوعة حسوب
< PHP
→ التعديل السابق
مرئينص الويكي
لا ملخص تعديل
لا ملخص تعديل
 
(3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 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)
(PHP 4, PHP 5, PHP 7)


سطر 8: سطر 7:
<syntaxhighlight lang="php">
<syntaxhighlight lang="php">
bool session_set_cookie_params ( int $lifetime [, string $path [, string $domain [, bool $secure = FALSE [, bool $httponly = FALSE ]]]] )
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>‎ عند كلّ  طلب وقبل استدعاء الدالة session_start()‎.
</syntaxhighlight>تعرّف الدالة <code>session_set_cookie_params()</code>‎ في الملف php.ini. يدوم تأثير هذه الدالة مدة تشغيل الشيفرة (البرنامج) فقط. لذلك يجب استدعاء الدالة <code>session_set_cookie_params()</code>‎ عند كلّ طلب وقبل استدعاء الدالة <code>[[PHP/session start|session_start()]]</code>‎.


تُحدث الدالة قيم ini لوقت التنفيذ  الحالي لمفاتيح التوثيق لملف PHP ini والتي يمكن  استرجاعها باستخدام الدالة ini_get()‎.
تُحدث الدالة قيم <code>ini</code> لوقت التنفيذ  الحالي لمفاتيح التوثيق لملف PHP ini والتي يمكن  استرجاعها باستخدام الدالة <code>[[PHP/ini get|ini_get()]]</code>‎.


== المعاملات ==
== المعاملات ==
<code>lifetime</code>


=== <code>lifetime</code> ===
فترة تشغيل ملفات الارتباط للدالة، تُعرف بالثواني.
فترة تشغيل ملفات الارتباط للدالة، تُعرف بالثواني.


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


مسار الحقل الذي سيعمل فيه ملف تعريف الإرتباط. استعمل شرطة مائلة مُفردة  ('/') لكل المسارات في الحقل.
=== <code>domain</code> ===
نطاق تعريف ملف تعريف الإرتباط، مِثل "<code>wiki.hsoub.com</code>" ولإظهار ملف تعريف الإرتباط على جميع النطاقات الفرعية (subdomains) يجب أن تسبق النطاق بنُقطة مِثل '<code>‎.hsoub.com</code>'.


<code>domain</code>
=== <code>secure</code> ===
إذا أُعطيّ القيمة <code>TRUE</code>، فإن ملف تعريف الإرتباط سيُرسل عبر اتصال آمن.


حقل ملف تعريف الإرتباط، مِثل "www.php.com" ولإظهار ملف تعريف الإرتباط على جميع الحقول الفرعية (subdomains) يجب أن تسبق الحقل بنُقطة مِثل '.php.net'.
=== <code>httponly</code> ===
 
إذا أُعطيّ القيمة <code>TRUE</code>، فسترسل PHP الراية <code>httponly</code> عند ضبط ملف تعريف الارتباط للجلسة.
<code>secure</code>
 
إذا أُعطيّ القيمة <code>TRUE</code>، فإن ملف تعريف الإرتباط سيُرسل عبر إتصال آمن.
 
<code>httponly</code>
 
إذا أُعطيّ القيمة <code>TRUE</code> ، فإن php سوف ترسل علامة httponly عند ضبط ملف تعريف الارتباط للجلسة.


== القيم المعادة ==
== القيم المعادة ==
سطر 42: سطر 37:
|-
|-
|7.2.0
|7.2.0
|تُعيد الدالة القيمة <code>TRUE</code> في حالة نجاحها والقيمة <code>FALSE</code> عند فشلها، سابقًا كانت تُعيد void.
|تُعيد الدالة القيمة <code>TRUE</code> في حالة نجاحها والقيمة <code>FALSE</code> عند فشلها، إذ لم تكن تعيد أيّ قيمة فيما سبق (void).
|-
|-
|5.2.0
|5.2.0
|أُضيف المعامل httponly
|أُضيف المعامل <code>httponly</code>.
|}
|}


== انظر أيضا ==
== انظر أيضًا ==
* <code>session.cookie_lifetime</code>
* <code>session.cookie_path</code>
* <code>session.cookie_domain</code>
* <code>session.cookie_secure</code>
* <code>session.cookie_httponly</code>
* الدالة <code>[[PHP/session get cookie params|session_get_cookie_params()]]</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 الرسمي.]
* [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»