Magiczne metody to specjalne metody (poprzedzone prefiksem __), które PHP wywoła automatycznie w odpowiedzi na określone akcje na obiekcie — takie jak dostęp do niezdefiniowanej właściwości, wywołanie niezdefiniowanej metody lub konwersja obiektu na string. Pozwalają one podłączyć się do i dostosować zachowanie obiektu.
{
{ }
{ }
}
class Container {
private array $data = [];
public function __get($name) { // called on reading an INACCESSIBLE/undefined property
return $this->data[$name] ?? null;
}
public function __set($name, $value) { // called on writing one
$this->data[$name] = $value;
}
public function __isset($name): bool { return isset($this->data[$name]); }
}
$c = new Container();
$c->foo = "bar"; // triggers __set('foo', 'bar')
echo $c->foo; // triggers __get('foo') → "bar"
__get/__set przechwytują dostęp do właściwości, które nie istnieją lub nie są dostępne — umożliwiając dynamiczne właściwości (używane przez ORMy, obiekty konfiguracyjne).
class Api {
public function __call($method, $args) { // called for UNDEFINED method calls
return $this->request($method, $args); // e.g. dynamic API methods
}
public static function __callStatic($method, $args) { /* static version */ }
}
$api->getUsers(); // no getUsers() method → __call('getUsers', [])
__call/__callStatic przechwytują wywołania niezdefiniowanych metod — używane do fluent/dynamicznych API (np. Laravel query builder, facades).
class Money {
public function __construct(private float $amount) {}
public function __toString(): string { // when the object is used as a string
return '$' . number_format($this->amount, 2);
}
}
echo new Money(9.5); // "$9.50" — __toString called automatically
class Multiplier {
public function __invoke($x) { return $x * 2; } // makes the object CALLABLE
}
$double = new Multiplier();
$double(5); // 10 — __invoke called
Magiczne metody są ważną funkcją PHP do dostosowywania zachowania obiektu, a ich zrozumienie jest wartościowe zarówno do ich odpowiedniego wykorzystania, jak i — szczególnie — do zrozumienia, jak frameworki PHP osiągają swoją "magię". Metody takie jak __get/__set (dynamiczny dostęp do właściwości), __call/__callStatic (dynamiczna obsługa metod), __toString (konwersja na string) i __invoke (obiekty callable) pozwalają obiektom inteligentnie reagować na operacje, które nie definiują jawnie.
To jest mechanizm stojący za większością wygody frameworka: Eloquent ORM Laravel używa __get/__set dla atrybutów modelu, jego query builder i facades używają __call/__callStatic dla fluent dynamicznych metod, a obiekty config/collection wykorzystują te metody na całym systemie.
Znajomość magicznych metod demistyfikuje, jak te frameworki działają i pozwala ci budować podobnie elastyczne API.
Znajomość kluczowych magicznych metod, co wyzwala każdą z nich i ich wspólne zastosowania w frameworkach to praktyczna wiedza zarówno do pisania ekspresyjnego PHP, jak i efektywnego używania/rozszerzania frameworków na nich zbudowanych. (Zastrzeżenie: magiczne metody mogą zaszkodzić jasności i wsparciu IDE — nadużywanie ich sprawia, że kod jest trudniejszy do zrozumienia, więc są najlepiej używane świadomie do genuinowego dynamicznego zachowania, a nie jako domyślne rozwiązanie.)