English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
إرسال الكعكة بواسطة وظيفة setcookie()
bool setcookie ( string $name [, string $value= "" [, int $expire= 0 [, string $path= "" [, string $domain= "" [, bool $secure= false [, bool $httponly= false ]]]]]]] )
يستخدم لضبط الكعك.
بمجرد تعريف الكعكة، سيتم إرسالها إلى العميل مع الرؤوس HTTP المتبقية. مثل الرؤوس HTTP الأخرى، يجب إرسال الكعكة قبل إنتاج أي مخرجات من قبل البرنامج (بسبب قيود البروتوكول). يرجى استدعاء هذه الوظيفة قبل إنتاج أي مخرجات (بما في ذلك <html> و<head> أو مسافات).
بمجرد تعيين الكعكة، يمكنك استخدام $_COOKIE لقراءتها عند فتح الصفحة التالية. كما أن قيم الكعكة موجودة أيضًا في $_REQUEST.
إذا تم إنتاج مخرجات قبل استدعاء هذه الوظيفة، فإن setcookie() سيفشل في الإصدار وسيقوم بإرجاع FALSE. إذا تم تشغيل setcookie() بنجاح، سيقوم بإرجاع TRUE. بالطبع، فإن هذا لا يعني ما إذا كان المستخدم قد قبل الكعكة أم لا.
| الترقيم | المعلمات والشرح |
|---|---|
| 1 | name اسم الكوكي. |
| 2 | value قيمة الكوكي. يتم تخزين هذه القيمة على جهاز المستخدم، لا تخزن معلومات حساسة. على سبيل المثال، إذا كان الاسم 'cookiename'، يمكنك الحصول على قيمته من $_COOKIE['cookiename']. |
| 3 | errno يحتوي على معلومات حول إدخال الكوكي. |
| 4 | expire وقت انتهاء صلاحية الكوكي. هذا هو علامة التوقيت Unix، وهي عدد الثواني منذ بداية عصر Unix (1 يناير 1970 في التوقيت العالمي للزمن الشتوي). مما يعني أنك يمكنك استخدام نتيجة time() بالإضافة إلى عدد الثواني التي تريد أن تستمر الكوكي. يمكنك أيضًا استخدام mktime(). time()+60*60*24*30 هو تعيين الكوكي لانتهاء صلاحيته بعد 30 يومًا. إذا تم تعيينه إلى صفر أو تمرلوه، فإن الكوكي ينتهي صلاحيته عند انتهاء الجلسة (أي عند إغلاق المتصفح). |
| 5 | path المسار الذي يكون فيه الكوكي صالحًا. إذا تم تعيينه ك"/"، فإن الكوكي يكون صالحًا للنطاق الكامل "domain". إذا تم تعيينه ك"/foo/"، فإن الكوكي يكون صالحًا فقط للمجلد "foo" في "domain" ولمجلداته الفرعية (مثل /foo/bar/). القيمة الافتراضية هي الدليل الحالي عند تعيين الكوكي. |
| 6 | domain مجال/مجالات صلاحية الكوكي. إذا تم تعيينه كاسم مجال فرعي (مثل 'www.example.com')، فإن الكوكي يكون صالحًا لهذا المجال الفرعي ولمجالات المستوى الثالث (مثل w2.www.example.com). إذا كنت ترغب في جعل الكوكي صالحًا للنطاق الكامل (بما في ذلك جميع مجالات الفرعية)، يمكنك تعيينه كاسم النطاق فقط (في هذا المثال هو 'example.com'). |
تجربة الأمثلة التالية
<?php
$input = 'يحتوي على اسم الكوكي';
setcookie("TestCookie", $input);
setcookie("TestCookie", $input, time()+3600);
setcookie("TestCookie", $input, time()+3600, "/~rasmus/", "oldtoolbag.com", 1);
?>