Menu
CoddyTech

خصائص للقراءة فقط (Readonly) في PHP 8.1

جزء من قسم البرمجة كائنية التوجه في رحلة PHP على Coddy. الدرس 19 من 91.

قدّم PHP 8.1 الخصائص readonly، التي لا يمكن إسناد قيمة إليها إلا مرة واحدة ولا يمكن تعديلها بعد ذلك. وعلى خلاف الثوابت، تُضبط الخصائص للقراءة فقط أثناء تهيئة الكائن، لا عند تعريف الصنف.

تُعرّف خاصية للقراءة فقط بإضافة الكلمة المفتاحية readonly قبل تعريف النوع:

<?php
class User {
    public readonly string $id;
    public readonly string $name;
    
    public function __construct(string $id, string $name) {
        $this->id = $id;
        $this->name = $name;
    }
}

$user = new User("U001", "Alice");
echo $user->id . "\n";
echo $user->name;

المخرجات:

U001
Alice

بمجرد إسناد قيمة إلى خاصية للقراءة فقط، ستؤدي محاولة تغييرها إلى حدوث خطأ. وهذا يجعلها مثالية للقيم التي ينبغي أن تظل ثابتة طوال فترة حياة الكائن، مثل المعرّفات أو الطوابع الزمنية للإنشاء.

يجب أن يكون للخصائص للقراءة فقط تصريح نوع، ولا يمكن إسناد قيمة إليها إلا مرة واحدة، من داخل الصنف الذي يصرّح بها (عادةً في المُنشئ). وعلى خلاف الخصائص العادية، لا يمكن إعطاؤها قيمة افتراضية عند التصريح بها. وهي تعمل مع أي مُعدِّل لإمكانية الوصول:

<?php
class Product {
    public function __construct(
        public readonly string $sku,
        private readonly float $cost
    ) {}
    
    public function getCost(): float {
        return $this->cost;
    }
}

$product = new Product("ABC123", 29.99);
echo $product->sku;

الناتج:

ABC123

نقطة أساسية: توفّر الخصائص للقراءة فقط عدم القابلية للتغيير على مستوى الخاصية. وهي مثالية للبيانات التي تحدد كائنًا أو التي ينبغي ألا تتغير بعد إنشائه، إذ تجمع بين مرونة التهيئة وقت التشغيل وأمان منع التعديلات غير المقصودة.

challenge icon

التحدي

سهل

لننشئ نظام إعدادات غير قابل للتغيير يستخدم خصائص للقراءة فقط لضمان عدم تغيير الإعدادات المهمة عن طريق الخطأ بعد التهيئة.

ستنشئ ملفين يعملان معًا لإدارة إعدادات التطبيق:

  • Config.php: عرّف فئة Config تمثّل إعدادات التطبيق بخصائص غير قابلة للتغيير. يجب أن تحتوي الفئة على ثلاث خصائص عامة للقراءة فقط: string $appName وstring $version وint $maxConnections. استخدم ترقية المُنشئ للتصريح عن الخصائص الثلاث جميعها للقراءة فقط وتهيئتها ضمن تعريف واحد واضح للمُنشئ. أضف طريقة getInfo() تُعيد سلسلة نصية بالتنسيق "[appName] v[version] (max: [maxConnections] connections)".
  • main.php: أدرج ملف فئة Config. ستتلقى ثلاث قيم إدخال: اسم التطبيق والإصدار والحد الأقصى للاتصالات (على هيئة سلسلة نصية يجب تحويلها إلى عدد صحيح). أنشئ كائنًا من Config باستخدام هذه القيم. اطبع نتيجة getInfo() في السطر الأول. ثم اطبع كل خاصية للقراءة فقط في سطر منفصل، من خلال الوصول إليها مباشرةً: اسم التطبيق، والإصدار، والحد الأقصى للاتصالات.

تضمن الخصائص للقراءة فقط أنه بعد إنشاء الإعدادات، تظل قيمها ثابتة، وهذا مثالي للإعدادات التي ينبغي أن تبقى ثابتة طوال مدة تشغيل تطبيقك. لاحظ كيف أن الجمع بين ترقية المُنشئ والخصائص للقراءة فقط يتيح طريقة موجزة جدًا لتعريف كائنات قيم غير قابلة للتغيير.

ينبغي أن يعرض الناتج سلسلة المعلومات المنسّقة، تليها قيمة كل خاصية على حدة، موضحًا أن الخصائص للقراءة فقط تظل قابلة للقراءة من خارج الفئة.

جرّب بنفسك

<?php

require_once 'Config.php';

// اقرأ المدخلات
$appName = trim(fgets(STDIN));
$version = trim(fgets(STDIN));
$maxConnections = intval(trim(fgets(STDIN)));

// TODO: أنشئ كائنًا من Config باستخدام قيم المدخلات

// TODO: اطبع ناتج getInfo()

// TODO: اطبع كل خاصية readonly في سطر مستقل:
// - اسم التطبيق
// - الإصدار
// - الحد الأقصى للاتصالات

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

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

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

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