خصائص للقراءة فقط (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) على إعلان نوع (type declaration) ولا يمكن تهيئتها إلا مرة واحدة فقط، إما في المنشئ (constructor) أو عند نقطة الإعلان (declaration). وهي تعمل مع أي معدل رؤية (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 ميزة عدم القابلية للتغيير على مستوى الخاصية. إنها مثالية للبيانات التي تحدد كائناً أو التي لا ينبغي أن تتغير بعد الإنشاء، حيث تجمع بين مرونة التهيئة في وقت التشغيل (runtime initialization) وأمان منع التعديلات العرضية.

التحدي

سهل

لنقم ببناء نظام تكوين (configuration) غير قابل للتغيير (immutable) يستخدم الخصائص للقراءة فقط (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 properties) أنه بمجرد إنشاء التكوين، يتم قفل قيمه في مكانها — وهو أمر مثالي للإعدادات التي يجب أن تظل ثابتة طوال فترة تشغيل تطبيقك. لاحظ كيف أن الترقية في المنشئ مع خاصية readonly تخلق طريقة موجزة للغاية لتعريف كائنات قيم غير قابلة للتغيير.

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

ورقة مرجعية

قدم PHP 8.1 خصائص 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; // U001

يجب أن تحتوي خصائص Readonly على إعلان نوع (type declaration) ويمكن تهيئتها مرة واحدة فقط. وهي تعمل مع أي معدل رؤية (visibility modifier) ويمكن دمجها مع ترقية المنشئ (constructor promotion):

<?php
class Product {
    public function __construct(
        public readonly string $sku,
        private readonly float $cost
    ) {}
}

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

تُعد خصائص Readonly مثالية للقيم التي يجب أن تظل ثابتة طوال دورة حياة الكائن، مثل المعرفات (IDs)، أو الطوابع الزمنية (timestamps)، أو إعدادات التكوين (configuration settings).

جرّب بنفسك

<?php

require_once 'Config.php';

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

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

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

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

?>