Menu
CoddyTech

__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، وقدّمت نهجًا أكثر بساطة تعمل فيه مباشرةً مع مصفوفات البيانات بدلًا من أسماء الخصائص.

challenge icon

التحدي

سهل

لننشئ نظامًا للتخزين المؤقت لملفات المستخدمين يوضح كيف تمنحك __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"
// بحسب ما إذا كانت قيمة الرمز في الملف الشخصي المستعاد تطابق قيمته في الملف الأصلي

?>
quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

جميع دروس البرمجة كائنية التوجه

تدرّب بنفسك: مترجم PHP عبر الإنترنت