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

جزء من قسم Object Oriented Programming في رحلة PHP على Coddy — الدرس 19 من 91.

قدم إصدار PHP 8.1 خصائص readonly، والتي يمكن تعيينها مرة واحدة فقط ولا يمكن تعديلها بعد ذلك. وعلى عكس الثوابت، يتم تعيين خصائص 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

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

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

<?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

نقطة رئيسية: توفر الخصائص المخصصة للقراءة فقط (Readonly properties) ميزة عدم القابلية للتغيير على مستوى الخاصية. فهي مثالية للبيانات التي تحدد هوية الكائن أو التي لا ينبغي أن تتغير بعد إنشائه، حيث تجمع بين مرونة التهيئة عند التشغيل (runtime initialization) وأمان منع التعديلات غير المقصودة.

التحدي

سهل

لنقم ببناء نظام تكوين (configuration) غير قابل للتغيير يستخدم خصائص للقراءة فقط (readonly properties) لضمان عدم إمكانية تغيير الإعدادات الهامة عن طريق الخطأ بعد التهيئة.

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

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

تضمن خصائص readonly أنه بمجرد إنشاء التكوين، يتم قفل قيمه في مكانها — وهو أمر مثالي للإعدادات التي يجب أن تظل ثابتة طوال فترة تشغيل تطبيقك. لاحظ كيف أن ترقية المنشئ (constructor promotion) مدمجة مع readonly تخلق طريقة موجزة للغاية لتعريف كائنات قيم غير قابلة للتغيير.

يجب أن يعرض مخرجك سلسلة المعلومات المنسقة متبوعة بكل قيمة خاصية فردية، مما يوضح أن خصائص readonly لا يزال من الممكن قراءتها من خارج الفئة.

جرّب بنفسك

<?php

require_once 'Config.php';

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

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

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

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

?>