الوصف

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

مصادر

صفحة الدالة session_set_cookie_params في توثيق PHP الرسمي.