الدالة session_create_id()‎ في PHP

(PHP 7, PHP 7.1.0)

تنتج الدالة session_create_id()‎ معرّفا جديدًا للجلسة.

الوصف

string session_create_id ([ string $prefix ])

تُستخدم الدالة ()session_create_id لإنشاء  قيمة جديدة للمعرف الفريد للجلسة الحالية، بحيث تعيد معرفًا جديدًا لا يتضارب مع غيره من المعرفات.

لن تتحقق الدالة ()session_create_id من وجود تضارب بين المعرفات إذا لم تكن الجلسة نشطةً.

المعرف الفريد للجلسة يتم إنتاجه طِبقًا لإعدادات php.ini.

من المهم أن يكون سكربت حذف الملفات المؤقتة مشغلًا من نفس حساب مستخدم خادم الويب، وإلا فقد تواجه مشاكل مع الأذونات خصوصًا إذا كانت الجلسات تُحفَظ كملفات.

المعاملات

prefix

إذا ضبط المعامل prefix، فسيُسبَق مُعرِّف الجلسة الجديد به.

بالنسبة للحروف المسموح بِها في التسمية فهي من a حتى z ومن A حتى Z، ومن 0 حتى 9، والفاصلة الإنجليزية ";"، وعلامة ناقص "-".

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

تُعيد الدالة ()session_create_id المعرّف الجديد للجلسة الحالية مع ضمان عدم وجود تضارب بين المعرفات ، لن تتحقق الدالة من وجود تضارب إذا لم تكن الجلسة نشطةً.

أمثلة

مثال 1: استخدام الدالة session_create_id()‎ مع الدالة session_regenerate_id()‎

<?php

function my_session_start() {

    session_start();
    
 // لا يُسمح باستعمال المعرف الفريد القديم للدالة

    if (!empty($_SESSION['deleted_time']) && $_SESSION['deleted_time'] < time() - 180) {

        session_destroy();

        session_start();
    }
}

function my_session_regenerate_id() {

    // التحقق من عدم وجود تضارب بين المعرفات   
 if (session_status() != PHP_SESSION_ACTIVE) {

        session_start();

    }

   // تحذير: لا تستمع متغيرات نصية سرية كبادئة للرقم التعريفي

    $newid = session_create_id('myprefix-');

   // حدد فترة زمنية للحذف، حيث لا ينصح بحذف بيانات الجلسة فوريًا لعدة أسباب

    $_SESSION['deleted_time'] = time();

    // إنهاء الجلسة

    session_commit();

   // تأكد مِن قبول الرقم التعريفي للجلسة المُعرف بواسطة المُستخدم

   // يجب تفعيل use_strict_mode للعمليات الطبيعية

    ini_set('session.use_strict_mode', 0);

   // حدد معرفا فريدا للجلسة

    session_id($newid);

    //  إبدأ الجلسة بالمعرف الفريدا الجديد

    session_start();

}

//  تأكد من تمكين use_strict_mode حيث أنه ضروري لأسباب أمنية

ini_set('session.use_strict_mode', 1);

my_session_start();

// الرقم التعريفي سيتم إعادة إنتاج المعرف الفريد  كُلما: يسجل المُستخدم الدخول أو الخروج وعند مرور مُدة زمنية معينة //

my_session_regenerate_id();

?>

انظر أيضًا

• الدالة session_regenerate_id()‎: تُحدث  المعرّف الفريد للجلسة بآخر جديد مُستحدث.
• الدالة session_start()‎: تبدأ جلسة جديدة أو تستكمل جلسة موجودة.
• session.use_strict_mode
• الدالة session_handler::create_sid()‎: تُعيد معرّفًا جديدًا.

مصادر

• صفحة الدالة session create id‎ في توثيق PHP الرسمي.