__serialize و __unserialize
جزء من قسم البرمجة كائنية التوجه في رحلة PHP على Coddy. الدرس 49 من 91.
عندما تحتاج إلى تحويل كائن إلى سلسلة نصية لتخزينه أو نقله، يستخدم PHP التسلسل. تمنحك الطريقتان السحريتان __serialize() و__unserialize() التحكم في البيانات التي تُحفَظ وكيفية استعادتها.
تُرجع الطريقة __serialize() مصفوفةً من البيانات لتسلسلها، بينما تستقبل الطريقة __unserialize() تلك المصفوفة وتعيد إنشاء الكائن:
<?php
class Session {
public function __construct(
private string $userId,
private array $data,
private int $createdAt
) {}
public function __serialize(): array {
return [
'userId' => $this->userId,
'data' => $this->data
];
}
public function __unserialize(array $data): void {
$this->userId = $data['userId'];
$this->data = $data['data'];
$this->createdAt = time();
}
public function getCreatedAt(): int {
return $this->createdAt;
}
}
$session = new Session("user123", ["theme" => "dark"], time());
$serialized = serialize($session);
$restored = unserialize($serialized);
echo "Created at: " . $restored->getCreatedAt();
لاحظ كيف يُستثنى createdAt من التسلسل ويحصل على طابع زمني جديد عند إلغاء التسلسل. يفيد هذا في استبعاد البيانات الحساسة أو القيم المؤقتة أو الموارد التي لا يمكن تسلسلها، مثل اتصالات قواعد البيانات.
حلّت هذه الطرق محل الطريقتين الأقدم __sleep() و__wakeup() في PHP 7.4، وقدّمت نهجًا أكثر بساطة تعمل فيه مباشرةً مع مصفوفات البيانات بدلًا من أسماء الخصائص.
التحدي
سهللننشئ نظامًا للتخزين المؤقت لملفات المستخدمين يوضح كيف تمنحك __serialize() و__unserialize() التحكم في البيانات التي تُحفَظ وكيفية استعادتها.
ستوزّع شيفرتك على ملفين:
UserProfile.php: أنشئ صنفًا باسمUserProfileيمثّل ملف المستخدم الشخصي مع إمكانات التخزين المؤقت. استخدم ترقية المُنشئ لتعريف خصائص خاصة لكل من$userId(سلسلة نصية) و$username(سلسلة نصية) و$email(سلسلة نصية) و$accessToken(سلسلة نصية). أضف خاصية خاصة باسم$cachedAtتخزّن وقت تخزين الملف الشخصي مؤقتًا (واجعل قيمتها"not cached"مبدئيًا في المُنشئ). يحتاج صنفك إلى ما يلي:__serialize(): تُعيد مصفوفة تحتوي فقط علىuserIdوusernameوemail. إنaccessTokenمعلومة حساسة، لذا يجب ألا تُسلسَل أبدًا. سيُعاد إنشاء الطابع الزمنيcachedAtعند الاستعادة.__unserialize(): تستعيدuserIdوusernameوemailمن مصفوفة البيانات. وتعيّنaccessTokenإلى"expired"(لأن الرموز يجب ألا تستمر).getInfo(): تُعيد سلسلة نصية بالتنسيق التالي:"[username] ([email]) - Token: [accessToken]"
main.php: ضمّن ملف UserProfile. ستتلقى أربع مُدخلات: معرّف مستخدم واسم مستخدم وبريدًا إلكترونيًا ورمز وصول. أنشئ نسخة منUserProfileبهذه القيم. اطبع ثلاثة أسطر:- معلومات الملف الشخصي الأصلي (قبل التسلسل)
- سلسِل الملف الشخصي باستخدام
serialize()، ثم ألغِ تسلسله باستخدامunserialize()لإنشاء ملف شخصي مستعاد. اطبع معلومات الملف الشخصي المستعاد. - اطبع
"Token preserved: yes"أو"Token preserved: no"بحسب ما إذا كان رمز الملف الشخصي المستعاد يطابق الرمز الأصلي (تلميح: يجب ألا يتطابق، لأن الرموز تنتهي صلاحيتها عند الاستعادة)
هذا النمط ضروري لتخزين بيانات المستخدمين مؤقتًا بأمان. تريد تخزين معلومات الملف الشخصي، لكن من دون حفظ بيانات الاعتماد الحساسة مثل رموز الوصول أبدًا. عند استعادة الملف الشخصي من التخزين المؤقت، يُحدَّد الرمز على أنه منتهي الصلاحية، ما يجبر التطبيق على الحصول على رمز جديد.
جرّب بنفسك
<?php
require_once 'UserProfile.php';
// اقرأ المدخلات
$userId = trim(fgets(STDIN));
$username = trim(fgets(STDIN));
$email = trim(fgets(STDIN));
$accessToken = trim(fgets(STDIN));
// TODO: أنشئ كائنًا من UserProfile باستخدام قيم المدخلات
// TODO: اطبع معلومات الملف الشخصي الأصلي (قبل التسلسل)
// TODO: سلسِل الملف الشخصي، ثم ألغِ تسلسله لإنشاء ملف شخصي مستعاد
// TODO: اطبع معلومات الملف الشخصي المستعاد
// TODO: اطبع "Token preserved: yes" أو "Token preserved: no"
// بحسب ما إذا كانت قيمة الرمز في الملف الشخصي المستعاد تطابق قيمته في الملف الأصلي
?>يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس البرمجة كائنية التوجه
1أساسيات OOP
الملفات الخارجيةمقدمة في OOPClasses مقابل Objectsالكلمة المفتاحية $thisالـ Methodsالـ Propertiesالمنشئ (__construct)الهادم (__destruct)مراجعة - آلة حاسبة بسيطة4الوراثة
الوراثة الأساسيةالكلمة المفتاحية parent::إعادة تعريف الدوال (Method Overriding)الكلمة المفتاحية finalالأصناف المجردة (Abstract Classes)مراجعة - هيكلية الموظفين7التغليف (Encapsulation)
العام، المحمي، الخاص (Public, Protected, Private)نظرة متعمقة على معدلات الوصولدوال Getters و Settersإخفاء المعلوماتميزة Constructor Promotion (8.0)مراجعة - نظام سجلات الطلاب10مفاهيم البرمجة كائنية التوجه المتقدمة
التركيب مقابل الوراثةحقن التبعيةالأصناف المجهولةالتعدادات (PHP 8.1)الألياف (PHP 8.1)تعمق في استنساخ الكائناتالمولدات والمكررات13أنماط التصميم - الجزء الثاني
نمط الأمرنمط المحولنمط المزيننمط طريقة القالبنمط الحالةنمط التركيبنمط المستودع2مساحات الأسماء والتحميل التلقائي
مقدمة إلى مساحات الأسماءالكلمة المفتاحية useمعيار التحميل التلقائي PSR-4أداة التحميل التلقائي Composerملخص - مشروع منظم5الواجهات والعقود
مقدمة إلى الواجهاتتنفيذ الواجهاتتنفيذ واجهات متعددةالواجهة مقابل الـ Abstract Classالـ Type Hinting مع الواجهاتملخص - حاسبة الأشكال8الميثودات السحرية (Magic Methods)
مقدمة في الميثودات السحرية__toString و __debugInfo__get, __set, __isset, __unset__call و __callStatic__clone واستنساخ الكائنات__serialize و __unserializeمراجعة - Custom Collection3خصائص الكلاس
خصائص الـ Instance مقابل الخصائص الساكنة (Static)الثوابت في الكلاساتالدوال والخصائص الساكنة (Static)الخصائص الخاصة (Private) والمحمية (Protected)خصائص للقراءة فقط (Readonly) في PHP 8.1مراجعة - مدير الحساب البنكي6تعدد الأشكال (Polymorphism)
مراجعة إعادة تعريف الدوال (Method Overriding)تعدد الأشكال عبر الـ Interfacesتلميح النوع (Type Hinting) وأنواع الاتحاد (Union Types)الربط الاستاتيكي المتأخر (Late Static Binding)ملخص - معالج الدفع (Payment Processor)تدرّب بنفسك: مترجم PHP عبر الإنترنت