XII. Функции работы с Классами/Объектами

Введение

Нижеописанные функции позволят вам получить информацию о классах и экземплярах объектов. Вы можете получить имя класса из экземпляра объекта равно как и все его свойства и методы. Используя эти функции, вы сможете установить не только принадлежность объекта к конкретному классу, но и определить наследование (к примеру какой класс наследует класс данного объекта).

Требования

Эти функции всегда доступны.

Установка

Для использования этих функций не требуется проведение установки, поскольку они являются частью ядра 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. test_script.php

<pre>
<?php

include "classes.inc";

// функции-утилиты

function print_vars($obj)
{
    
$arr = get_object_vars($obj);
    while (list(
$prop, $val) = each($arr))
        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";
    }
}

// создание экземпляров объектов

$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";

// показать свойства объекта класса Spinach
echo "\nveggie: Properties\n";
print_vars($veggie);

// и методы объекта базового класса Vegetable
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 -- Checks if the interface has been defined
is_a --  Возвращает TRUE если объект принадлежит классу или является одним из его наследователей.
is_subclass_of --  Возвращает TRUE если объект является экземпляром класса, наследующего данный.
method_exists -- Проверяет существует ли метод в данном классе
property_exists --  Checks if the object or class has a property