الوصف

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

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

secure

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

httponly

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

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

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

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

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

انظر أيضا

session.cookie_lifetime
session.cookie_path
session.cookie_domain
session.cookie_secure
session.cookie_httponly
الدالة session_get_cookie_params()‎: تعيد معاملات ملفات تعريف الارتباط للجلسة.

مصادر

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