الأصناف المجهولة

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

أحياناً تحتاج إلى كائن بسيط لمرة واحدة دون عناء تعريف فئة (class) كاملة. تسمح لك الفئات المجهولة (Anonymous classes) بإنشاء كائنات بشكل فوري، في المكان الذي تحتاج إليها فيه تماماً. وهي مفيدة بشكل خاص عند دمجها مع حقن التبعية (dependency injection).

يتم تعريف الفئة المجهولة (anonymous class) باستخدام new class متبوعة بجسم الفئة:

<?php
$logger = new class {
    public function log(string $message): void {
        echo "Log: $message";
    }
};

$logger->log("Hello!");

المخرجات:

Log: Hello!

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

<?php
interface Notifier {
    public function send(string $message): string;
}

function notify(Notifier $notifier, string $msg): string {
    return $notifier->send($msg);
}

$result = notify(new class implements Notifier {
    public function send(string $message): string {
        return "Sent: $message";
    }
}, "Test message");

echo $result;

المخرجات:

Sent: Test message

يمكن للأصناف المجهولة (Anonymous classes) أيضاً توسيع أصناف أخرى، واستخدام السمات (traits)، وقبول وسائط المنشئ (constructor arguments). فهي تمتلك وصولاً كاملاً إلى ميزات البرمجة كائنية التوجه (OOP) - حيث يتم تعريفها فقط بشكل مضمن (inline) بدلاً من تعريفها في ملف منفصل. استخدمها عندما يكون تعريف صنف كامل أمراً مبالغاً فيه، ولكنك لا تزال بحاجة إلى سلوك كائني التوجه.

التحدي

سهل

لنقم ببناء نظام لتنسيق البيانات يوضح قوة الفئات المجهولة (anonymous classes). بدلاً من إنشاء ملفات فئات منفصلة لتنفيذات بسيطة تُستخدم لمرة واحدة، ستستخدم الفئات المجهولة لإنشاء تنفيذات سريعة في المكان الذي تحتاج إليها فيه تماماً.

ستقوم بتنظيم الكود الخاص بك عبر ملفين:

FormatterInterface.php — قم بتعريف واجهة (interface) تسمى FormatterInterface مع طريقة واحدة format(string $data): string. يحدد هذا العقد الذي يجب أن يتبعه أي منسق (formatter).
main.php — قم بتضمين ملف الواجهة وأنشئ فئة DataProcessor تستخدم حقن التبعية (dependency injection) لقبول أي منسق. يجب أن تقوم الفئة بـ:
- قبول FormatterInterface في المنشئ (constructor) الخاص بها
- امتلاك طريقة process(string $data) تفوض العمل للمنسق المحقون وتعيد نتيجته
ستتلقى مدخلين: نوع التنسيق ("upper" أو "reverse") وسلسلة نصية لتنسيقها.

بناءً على نوع التنسيق، قم بإنشاء فئة مجهولة (anonymous class) تنفذ FormatterInterface:
- بالنسبة لـ "upper": يجب أن تعيد الطريقة format() البيانات محولة إلى أحرف كبيرة (uppercase)
- بالنسبة لـ "reverse": يجب أن تعيد الطريقة format() البيانات معكوسة
قم بحقن فئتك المجهولة في DataProcessor، واستدعِ process() مع السلسلة النصية المدخلة، واطبع النتيجة.

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

ورقة مرجعية

تسمح لك الفئات المجهولة (Anonymous classes) بإنشاء كائنات بشكل فوري دون الحاجة إلى تعريف فئة كاملة. يتم تعريفها باستخدام new class متبوعاً بجسم الفئة:

<?php
$logger = new class {
    public function log(string $message): void {
        echo "Log: $message";
    }
};

$logger->log("Hello!");

يمكن للفئات المجهولة تنفيذ الواجهات (interfaces)، مما يجعلها مفيدة لحقن التبعية (dependency injection) والاختبار:

<?php
interface Notifier {
    public function send(string $message): string;
}

function notify(Notifier $notifier, string $msg): string {
    return $notifier->send($msg);
}

$result = notify(new class implements Notifier {
    public function send(string $message): string {
        return "Sent: $message";
    }
}, "Test message");

تدعم الفئات المجهولة جميع ميزات البرمجة كائنية التوجه (OOP): حيث يمكنها توسيع فئات أخرى، واستخدام السمات (traits)، وقبول وسائط المنشئ (constructor arguments). استخدمها عندما يكون تعريف فئة كاملة أمراً مبالغاً فيه ولكنك لا تزال بحاجة إلى سلوك كائني التوجه.

جرّب بنفسك

<?php
require_once 'FormatterInterface.php';

// TODO: إنشاء فئة DataProcessor التي:
// - تقبل FormatterInterface في منشئها (constructor)
// - تحتوي على طريقة process(string $data) التي تفوض العمل للمنسق (formatter)

// قراءة المدخلات
$formatType = trim(fgets(STDIN));
$inputString = trim(fgets(STDIN));

// TODO: بناءً على $formatType ("upper" أو "reverse")، قم بإنشاء فئة مجهولة (anonymous class)
// تقوم بتنفيذ FormatterInterface
// - بالنسبة لـ "upper": يجب أن تعيد format() نسخة الأحرف الكبيرة من البيانات
// - بالنسبة لـ "reverse": يجب أن تعيد format() نسخة معكوسة من البيانات

// TODO: قم بإنشاء DataProcessor باستخدام منسق الفئة المجهولة الخاص بك
// استدعِ process() مع سلسلة الإدخال واطبع النتيجة

?>