Перегрузка в PHP предоставляет средства для динамического создания свойств и методов. Эти динамические объекты обрабатываются с помощью магических методов, которые можно установить в классе для различных типов действий.

Методы перегрузки вызываются при взаимодействии со свойствами или методами, которые не были объявлены или не видны в текущей области. В оставшейся части этого раздела термины недоступные свойства и недоступные методы будут использоваться для обозначения этой комбинации объявления и видимости.

Все методы перегрузки должны быть определены как public.

Перегрузка свойств

public __set(string $name, mixed $value): void
public __get(string $name): mixed
public __isset(string $name): bool
public __unset(string $name): void

__set() запускается при записи данных в недоступные (защищенные или частные) или несуществующие свойства.

__get() используется для чтения данных из недоступных (защищенных или частных) или несуществующих свойств.

__isset() запускается вызовом isset() или empty() для недоступных (защищенных или частных) или несуществующих свойств.

__unset() вызывается, когда unset() используется для недоступных (защищенных или частных) или несуществующих свойств.

Аргумент $name — это имя свойства, с которым осуществляется взаимодействие. Аргумент $value метода __set() указывает значение, на которое должно быть установлено свойство $name 'ed.

Перегрузка свойств работает только в контексте объекта. Эти магические методы не будут запускаться в статическом контексте. Поэтому эти методы не следует объявлять статическими . Предупреждение выдается, если объявлен один из магических методов перегрузки static.

Пример #1 Перегрузка свойств с помощью методов __get() , __set() , __isset() и __unset()

<?php
class PropertyTest
{
    /**  Location for overloaded data.  */
    private $data = array();

    /**  Overloading not used on declared properties.  */
    public $declared = 1;

    /**  Overloading only used on this when accessed outside the class.  */
    private $hidden = 2;

    public function __set($name, $value)
    {
        echo "Setting '$name' to '$value'\n";
        $this->data[$name] = $value;
    }

    public function __get($name)
    {
        echo "Getting '$name'\n";
        if (array_key_exists($name, $this->data)) {
            return $this->data[$name];
        }

        $trace = debug_backtrace();
        trigger_error(
            'Undefined property via __get(): ' . $name .
            ' in ' . $trace[0]['file'] .
            ' on line ' . $trace[0]['line'],
            E_USER_NOTICE);
        return null;
    }

    public function __isset($name)
    {
        echo "Is '$name' set?\n";
        return isset($this->data[$name]);
    }

    public function __unset($name)
    {
        echo "Unsetting '$name'\n";
        unset($this->data[$name]);
    }

    /**  Not a magic method, just here for example.  */
    public function getHidden()
    {
        return $this->hidden;
    }
}


echo "<pre>\n";

$obj = new PropertyTest;

$obj->a = 1;
echo $obj->a . "\n\n";

var_dump(isset($obj->a));
unset($obj->a);
var_dump(isset($obj->a));
echo "\n";

echo $obj->declared . "\n\n";

echo "Let's experiment with the private property named 'hidden':\n";
echo "Privates are visible inside the class, so __get() not used...\n";
echo $obj->getHidden() . "\n";
echo "Privates not visible outside of class, so __get() is used...\n";
echo $obj->hidden . "\n";
?>

Перегрузка метода

public __call(string $name, array $arguments): mixed
public static __callStatic(string $name, array $arguments): mixed

__call() срабатывает при вызове недоступных методов в контексте объекта.

__callStatic() срабатывает при вызове недоступных методов в статическом контексте.

Аргумент $name — это имя вызываемого метода. Аргумент $arguments — это пронумерованный массив, содержащий параметры, переданные методу $name .

Пример #2 Перегрузка методов через методы __call() и __callStatic()

<?php
class MethodTest
{
    public function __call($name, $arguments)
    {
        // Note: value of $name is case sensitive.
        echo "Calling object method '$name' "
             . implode(', ', $arguments). "\n";
    }

    public static function __callStatic($name, $arguments)
    {
        // Note: value of $name is case sensitive.
        echo "Calling static method '$name' "
             . implode(', ', $arguments). "\n";
    }
}

$obj = new MethodTest;
$obj->runTest('in object context');

MethodTest::runTest('in static context');
?>