الدالة 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

حقل ملف تعريف الإرتباط، مِثل "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 الرسمي.