الفرق بين المراجعتين ل"PHP/session set cookie params"
رؤيا-بنعطية (نقاش | مساهمات) (أنشأ الصفحة ب'<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 .
|
انظر أيضًا
- الدالة
session_get_cookie_params()
: تعيد معاملات ملفات تعريف الارتباط للجلسة.