خصائص للقراءة فقط (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نقطة أساسية: توفّر الخصائص للقراءة فقط عدم القابلية للتغيير على مستوى الخاصية. وهي مثالية للبيانات التي تحدد كائنًا أو التي ينبغي ألا تتغير بعد إنشائه، إذ تجمع بين مرونة التهيئة وقت التشغيل وأمان منع التعديلات غير المقصودة.
التحدي
سهللننشئ نظام إعدادات غير قابل للتغيير يستخدم خصائص للقراءة فقط لضمان عدم تغيير الإعدادات المهمة عن طريق الخطأ بعد التهيئة.
ستنشئ ملفين يعملان معًا لإدارة إعدادات التطبيق:
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 في سطر مستقل:
// - اسم التطبيق
// - الإصدار
// - الحد الأقصى للاتصالات
?>يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس البرمجة كائنية التوجه
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 عبر الإنترنت