XIII. Функции за класове и обекти

Въведение

Тези функции ви позволяват да получавате информация за класове и обекти инстанции. Можете да вземете името на класа, на който принаделжи обект, също както и неговите член свойства и методи. Използвайки тези функции, вие не само можете да определите класовата принадлежност на обект, но също и неговото потекло (напр. кой клас наследява класът на обекта).

Изисквания

Не са необходими външни библиотеки, за да се пусне това разширение.

Инсталация

Не е необходимо инсталиране, за да се използват тези функции. Те са част от ядрото на PHP.

Конфигурация по време на работа

Това разширение няма дефинирани конфигурационни директиви в php.ini.

Ресурсни типове

Това разширение няма дефинирани ресурс типове.

Предефинирани константи

Това разширение няма дефинирани константи.

Примери

В този пример, ние първо дефинираме базов клас и разширение на класа. Базовият клас описва общо растение, дали е ядливо или не и какъв е цветът му. Подкласът Spinach (спанак) добавя метод за сготвянето му и друг за проверка дали е сготвен.

Пример 1. classes.inc

<?php

// базов клас с членове-променливи и методи
class Vegetable {

    var $edible;
    var $color;

    function Vegetable($edible, $color="green") 
    {
        $this->edible = $edible;
        $this->color = $color;
    }

    function is_edible() 
    {
        return $this->edible;
    }

    function what_color() 
    {
        return $this->color;
    }
    
} // край на клас Vegetable

// наследява базовия клас
class Spinach extends Vegetable {

    var $cooked = false;

    function Spinach() 
    {
        $this->Vegetable(true, "green");
    }

    function cook_it() 
    {
        $this->cooked = true;
    }

    function is_cooked() 
    {
        return $this->cooked;
    }
    
} // край на клас Spinach

?>

След това инстанциираме 2 обекта от тези класове и извеждаме информация за тях, включително тяхното класово потекло. Освен това дефинираме няколко полезни функции, главно за да имаме хубаво извеждане на променливите.

Пример 2. test_script.php

<pre>
<?php

include "classes.inc";

// помощни функции

function print_vars($obj) 
{
    foreach (get_object_vars($obj) as $prop => $val) {
        echo "\t$prop = $val\n";
    }
}

function print_methods($obj) 
{
    $arr = get_class_methods(get_class($obj));
    foreach ($arr as $method) {
        echo "\tfunction $method()\n";
    }
}

function class_parentage($obj, $class) 
{
    if (is_subclass_of($GLOBALS[$obj], $class)) {
        echo "Object $obj belongs to class " . get_class($$obj);
        echo " a subclass of $class\n";
    } else {
        echo "Object $obj does not belong to a subclass of $class\n";
    }
}

// инстанциира 2 обекта

$veggie = new Vegetable(true, "blue");
$leafy = new Spinach();

// извежда информация за обектите
echo "veggie: CLASS " . get_class($veggie) . "\n";
echo "leafy: CLASS " . get_class($leafy);
echo ", PARENT " . get_parent_class($leafy) . "\n";

// извежда свойствата на veggie
echo "\nveggie: Properties\n";
print_vars($veggie);

// и методите на leafy
echo "\nleafy: Methods\n";
print_methods($leafy);

echo "\nParentage:\n";
class_parentage("leafy", "Spinach");
class_parentage("leafy", "Vegetable");
?>
</pre>

Важно нещо за отбелязване в горния пример е, че обектът $leafy (листат) е инстанция на класа Spinach (спанак), който е подклас на Vegetable (растение), и затова последната част от горния скрипт ще изведе:

[...]
Parentage:
Object leafy does not belong to a subclass of Spinach
Object leafy belongs to class spinach a subclass of Vegetable

Съдържание
call_user_method_array --  Извиква потребителски метод, определен с масив от параметри [непрепоръчителна]
call_user_method --  Извиква потребителски метод на определен обект [непрепоръчителна]
class_exists -- Проверява дали даден клас е бил дефиниран
get_class_methods -- Връща имената на методите на клас
get_class_vars -- Връща свойствата по подразбиране на даден клас
get_class -- Връща името на класа на обект
get_declared_classes -- Връща масив с имената на дефинираните класове
get_declared_interfaces --  Връща масив с всички декларирани интерфейси
get_object_vars -- Връща свойствата на дадения обект
get_parent_class -- Връща името на родителския клас на обект или клас
interface_exists -- Проверява дали даден интерфейс е дефиниран
is_a -- Проверява дали обектът е от даден клас или даденият клас му е родителски
is_subclass_of -- Проверява дали клас е родителски за даден обект
method_exists -- Проверява дали указания метод на класа съществува
property_exists --  Проверява дали обектът или класът притежават дадено свойство