PHP/session start

(PHP 4, PHP 5, PHP 7)

تنشئ  الدالة session_start()‎ جلسة جديدة أو تستكمل جلسة موجودة بالفعل.

الوصف

bool session_start ([ array $options = array() ] )

تنشئ  الدالة session_start()‎ جلسة جديدة أو تستكمل الجلسة الحالية بناء على مُعرف الجلسة المُمرر بواسطة أوامر GET و POST أو عبر ملفات تعريف الارتباط.

عند استدعاء الدالة session_start()‎ أو عندما تبدأ الجلسة تلقائيًا، ستستدعي  PHP دوال بدء وقراءة معلومات الجلسة. هذه الدوال ستكون إما دالة داخلية built-in تلقائية، أو بواسطة إضافات PHP (مِثل SQLite أو Memcached); أو يُمكن أن تكون مُخصصة مِثل المُعرف بواسطة الدالة session_set_save_handler()‎. ستستعيد دالة رد النداء read()‎ أي بيانات موجودة للجلسة (المُخزنة بتنسيق مُتسلسل) وسيقوم بفك ذلك التشفير واستعمالها في المُتغير ‎$_SESSION.

 لاستدعاء جلسة مُسماة، يجب أن تستدعي الدالة session_name()‎ قبل استدعاء الدالة session_start()‎.

 عند تفعيل session.use_trans_sid، ستسجل الدالة مُعامل مُخرجات داخلي لإعادة كتابة الروابط URL.

 إذا كان المُستخدم يستعمل ob_gzhandler أو شبيهًا لها مِثل الدالة ob_start()‎. ترتيب الدالة يصبح مُهما جدًا لإعادة المُخرجات بطريقة صحيحة.على سبيل المِثال، الدالة ob_gzhandler يجب أن يُسجل قبل بداية الجلسة.

المعاملات

options

عند توفير هذا المعامل، ستحل مصفوفة من الاختيارات محل مسارات توثيق الجلسة الحالية. مفاتيح هذا المعامل يجب ألّا تحتوي على الحروف الأولية prefix للجلسة.

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

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

أمثلة:

المثال 1: فتح جلسة أساسية  لفتح الصفحة page1.php

<?php

// page1.php

session_start();

echo 'Welcome to page #1';

$_SESSION['favcolor'] = 'green';

$_SESSION['animal']   = 'cat';

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

// يعمل في حالة قبول ملفات تعريف الإرتباط للجلسة

echo '<br /><a href="page2.php">page 2</a>';

// أو يُمكن تمرير الرقم التعريفي للجلسة في جالة الحاجة لذلك

echo '<br /><a href="page2.php?' . SID . '">page 2</a>';

?>

بعد الإطلاع على الصفحة page1.php الصفحة الثانية page2.php سوف تحتوي بيانات الجلسة. إقرأ المزيد عن مراجع الجلسة لتعرف عن الأرقام التعريفية للجلسة، على سبيل المثال، شرح ما هو معرف الجلسة الثابت constant SID.

المِثال 2: فتح جلسة أساسية  لفتح الصفحة page2.php

<?php

// page2.php

session_start();

echo 'Welcome to page #2<br />';

echo $_SESSION['favcolor']; // green

echo $_SESSION['animal'];   // cat

echo date('Y m d H:i:s', $_SESSION['time']);

// يُمكن أن تستعمل معرف  للجلسة هُنا كما فعلنا في المِثال الأول

echo '<br /><a href="page1.php">page 1</a>';

?>

تقديم المعامل options في الدالة session_start()

المِثال 3: تعديل فترة حياة ملفات الارتباط <?php

// هذا يُرسل  ملفات الارتباط  تستمر لأسبوع

session_start([

    'cookie_lifetime' => 86400,

]);

?>

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

الإصدار	الوصف
7.1.0	تعيد الدالة القيمة FALSE ولا تعطي قيمة أولية للمُتغير $_SESSION عند فشل بدء الجلسة.
7.0.0	أضيف المعامل options
5.3.0	عند فشل الدالة سوف تُعيد القيمة FALSE قبل ذلك كانت تُعيد TRUE
4.3.3	في ذلك الإصدار وما قبل، إذا استدعيت الدالة بعد بدء الجلسة،  سيظهر خطأ من نوع  E_NOTICE، وستُهمل الدالة الثانية لبدء الجلسة.

ملاحظات

لاحظ أنه لغرض استعمالك للجلسات المبنية على ملفات تعريف الارتباط، فإن الدالة session_start()‎ يجب أن تُستدعى قبل إخراج أي شيء للمتصفح.

يُنصح باستخدام zlib.output_compression بدلًا مِن ob_gzhandler()‎.

تُرسل الدالة session_start()‎ العديد من الملفات الترويسية (HTTP header files) التي تعتمد على التوثيق. شاهد شرح الدالة session_cache_limiter()‎ لتخصيص هذه الملفات.  

انظر أيضا

• ‎$_SESSION
• الدالة session_id()‎: تحصل على أو تضبط المعرف  الخاص بالجلسة.

مصادر

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