Методы объекта в PHP: от простого к сложному

Расширенные примеры методов объектов

Пример 1: Цепочка методов (fluent interface)

Методы могут возвращать $this, чтобы обеспечить цепочечные вызовы. Это часто используется в построителях запросов.

class QueryBuilder {
    private array $select = ['*'];
    private string $table = '';
    private array $where = [];

    public function select(array $columns): self {
        $this->select = $columns;
        return $this;
    }

    public function from(string $table): self {
        $this->table = $table;
        return $this;
    }

    public function where(string $column, string $operator, mixed $value): self {
        $this->where[] = "$column $operator " . (is_string($value) ? "'$value'" : $value);
        return $this;
    }

    public function get(): string {
        $sql = "SELECT " . implode(', ', $this->select) . " FROM " . $this->table;
        if (!empty($this->where)) {
            $sql .= " WHERE " . implode(' AND ', $this->where);
        }
        return $sql;
    }
}

$query = (new QueryBuilder())
    ->select(['id', 'name'])
    ->from('users')
    ->where('age', '>', 18)
    ->get();
echo $query;

SELECT id, name FROM users WHERE age > 18

Пример 2: Метод с использованием self и parent в сложной иерархии

Покажем разницу между self и static для позднего статического связывания.

class Base {
    public static function who(): string {
        return __CLASS__;
    }

    public static function testSelf(): string {
        return self::who();
    }

    public static function testStatic(): string {
        return static::who();
    }
}

class Child extends Base {
    public static function who(): string {
        return __CLASS__;
    }
}

echo Child::testSelf();   // Base - используется класс, где объявлен self
echo "\n";
echo Child::testStatic(); // Child - благодаря позднему связыванию

Base
Child

Пример 3: Магические методы __call и __callStatic

Они перехватывают вызовы несуществующих методов, позволяя реализовать прокси или делегирование.

class DynamicInvoker {
    public function __call(string $name, array $arguments): mixed {
        echo "Вызван метод '$name' с аргументами: " . implode(', ', $arguments) . "\n";
        return "Результат для $name";
    }

    public static function __callStatic(string $name, array $arguments): mixed {
        echo "Статический вызов '$name' с аргументами: " . implode(', ', $arguments) . "\n";
        return "Статический результат для $name";
    }
}

$obj = new DynamicInvoker();
echo $obj->foo(1, 2, 3) . "\n";
echo DynamicInvoker::bar(4, 5) . "\n";

Вызван метод 'foo' с аргументами: 1, 2, 3
Результат для foo
Статический вызов 'bar' с аргументами: 4, 5
Статический результат для bar

Пример 4: Использование named arguments с типизированными параметрами

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

class Rectangle {
    public function __construct(
        private float $width = 0.0,
        private float $height = 0.0,
        private string $color = 'black'
    ) {}

    public function area(): float {
        return $this->width * $this->height;
    }

    public function describe(): string {
        return "Прямоугольник {$this->color} ({$this->width}x{$this->height})";
    }
}

$r1 = new Rectangle(width: 10, height: 5); // цвет по умолчанию
echo $r1->describe() . ", площадь: " . $r1->area() . "\n";

$r2 = new Rectangle(color: 'red', width: 7, height: 3);
echo $r2->describe() . ", площадь: " . $r2->area() . "\n";

Прямоугольник black (10x5), площадь: 50
Прямоугольник red (7x3), площадь: 21

Пример 5: Метод с возвращаемым типом и обработкой ошибок

Используем объединение типов (PHP 8+) и выбрасываем исключение при некорректных данных.

class Division {
    public function divide(int $a, int $b): int|float {
        if ($b === 0) {
            throw new InvalidArgumentException("Деление на ноль запрещено");
        }
        return $a / $b;
    }
}

try {
    $d = new Division();
    echo $d->divide(10, 3) . "\n";
    echo $d->divide(10, 0) . "\n";
} catch (InvalidArgumentException $e) {
    echo "Ошибка: " . $e->getMessage() . "\n";
}

3.3333333333333
Ошибка: Деление на ноль запрещено