الدالة session_set_cookie_params() في PHP
(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(): تعيد معاملات ملفات تعريف الارتباط للجلسة.