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

في لغة PHP، تتم البرمجة الوصفية بشكل شائع باستخدام:

1. Reflection API: يسمح بفحص الفئات والأساليب والخصائص والمزيد في وقت التشغيل.
2. الطرق السحرية: طرق خاصة مثل __get، __set، __call، وما إلى ذلك، التي تعترض وتدير الوصول إلى خصائص الفصل أو الأساليب ديناميكيًا.
3. وظيفة التقييم: تقوم بتقييم التعليمات البرمجية ديناميكيًا (على الرغم من عدم تشجيعها بشكل عام لأسباب أمنية).
4. الوظائف والإغلاقات المجهولة: يمكن استخدامها لإنشاء وظائف ديناميكيًا.
5. إنشاء الفئات والأساليب الديناميكية: استخدام الفئات لإنشاء أساليب أو خصائص جديدة بسرعة.

مثال على برمجة PHP Metaprogramming

دعونا نعرض البرمجة الوصفية في PHP باستخدام Reflection API والطرق السحرية.

مثال: أداة Getter/Setter الديناميكية باستخدام الطرق السحرية

هنا، سنقوم بإنشاء فصل يستخدم الأساليب السحرية (__get و __set) للتعامل مع الخصائص غير الموجودة ديناميكيًا.

data[$name] = $value;
    }

    // Magic method to handle dynamic property getting
    public function __get($name) {
        if (array_key_exists($name, $this->data)) {
            echo "Getting '$name'.\n";
            return $this->data[$name];
        }

        echo "Property '$name' not set.\n";
        return null;
    }

    // Magic method to handle dynamic method calls
    public function __call($name, $arguments) {
        echo "Calling method '$name' with arguments: " . implode(', ', $arguments) . "\n";
        return null;
    }
}

// Usage example
$obj = new DynamicClass();

// Setting properties dynamically
$obj->name = "Metaprogramming";
$obj->type = "PHP";

// Getting properties dynamically
echo $obj->name . "\n";  // Outputs: Metaprogramming
echo $obj->type . "\n";  // Outputs: PHP

// Calling a dynamic method
$obj->dynamicMethod("arg1", "arg2");

الإخراج:

Setting 'name' to 'Metaprogramming'.
Setting 'type' to 'PHP'.
Getting 'name'.
Metaprogramming
Getting 'type'.
PHP
Calling method 'dynamicMethod' with arguments: arg1, arg2

مثال: استخدام انعكاس PHP

تسمح واجهة برمجة تطبيقات Reflection API الخاصة بـ PHP بفحص الفئات والأساليب والخصائص ومعالجتها في وقت التشغيل.

name = $name;
        $this->type = $type;
    }

    public function sayHello() {
        echo "Hello from $this->name, a $this->type example!\n";
    }
}

function reflectOnClass($className) {
    // Reflecting on the class
    $reflector = new ReflectionClass($className);

    echo "Class: " . $reflector->getName() . "\n";

    // Reflecting on the class properties
    echo "Properties: \n";
    foreach ($reflector->getProperties() as $property) {
        echo "- " . $property->getName() . "\n";
    }

    // Reflecting on the class methods
    echo "Methods: \n";
    foreach ($reflector->getMethods() as $method) {
        echo "- " . $method->getName() . "\n";
    }
}

// Usage example
$example = new ExampleClass("Metaprogramming", "PHP");
$example->sayHello();  // Outputs: Hello from Metaprogramming, a PHP example!

// Reflecting on the ExampleClass
reflectOnClass('ExampleClass');

الإخراج:

Hello from Metaprogramming, a PHP example!
Class: ExampleClass
Properties: 
- name
- type
Methods: 
- __construct
- sayHello

مثال عملي: استدعاء الطريقة الديناميكية

الآن دعونا نبني مثالاً للبرمجة الوصفية حيث نقوم باستدعاء الأساليب ديناميكيًا على كائن باستخدام فئة ReflectionMethod.

invokeArgs($object, $args);
    } catch (ReflectionException $e) {
        echo "Method not found: " . $e->getMessage() . "\n";
    }
}

// Example usage
$calc = new Calculator();

// Dynamically invoke 'add' method
$result1 = dynamicInvoke($calc, 'add', [2, 3]);
echo "Addition Result: " . $result1 . "\n";  // Outputs: 5

// Dynamically invoke 'multiply' method
$result2 = dynamicInvoke($calc, 'multiply', [3, 4]);
echo "Multiplication Result: " . $result2 . "\n";  // Outputs: 12

// Attempt to invoke a non-existent method
dynamicInvoke($calc, 'subtract', [5, 2]);

الإخراج:

Addition Result: 5
Multiplication Result: 12
Method not found: Method Calculator::subtract() does not exist

المفاهيم الأساسية في PHP Metaprogramming

1. Reflection API: يسمح بفحص الفئات والأساليب والخصائص وقت التشغيل.
2. الطرق السحرية: طرق خاصة في PHP يتم استدعاؤها عند التفاعل مع خصائص وأساليب الفصل ديناميكيًا.
   • __get()، __set()، __call()، __callStatic()، __invoc()، __toString()، إلخ.
3. استدعاء الطريقة الديناميكية: استخدام الانعكاس لاستدعاء الأساليب ديناميكيًا في وقت التشغيل بناءً على الإدخال.

خاتمة

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