Sihirli metotlar, PHP'nin bir nesne üzerinde belirli eylemler meydana geldiğinde otomatik olarak çağırdığı özel metotlardır (başına __ ile eklenmişlerdir) — tanımsız bir özelliğe erişim, tanımsız bir metot çağırma veya bir nesneyi string'e dönüştürme gibi. Nesne davranışını özelleştirmek ve kustomize etmek için bu işlevlere sahip olmanızı sağlarlar.
{
{ }
{ }
}
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 mevcut olmayan veya erişilebilir olmayan özelliklere erişimi yakalar — dinamik özellikleri etkinleştirir (ORM'ler, config nesneleri tarafından kullanılır).
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 tanımsız metotlara yapılan çağrıları yakalar — fluent/dinamik API'ler için kullanılır (örneğin Laravel'in query builder'ı, facade'ları).
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
Sihirli metotlar nesne davranışını özelleştirmek için önemli bir PHP özelliğidir ve bunları anlamak hem uygun şekilde kullanmaları hem de — özellikle — PHP framework'lerinin "sihirlerini" nasıl gerçekleştirdiklerini anlamak için değerlidir. __get/__set (dinamik özellik erişimi), __call/__callStatic (dinamik metot işleme), __toString (string dönüşümü) ve __invoke (çağrılabilir nesneler) gibi metotlar nesnelerin açıkça tanımlamadıkları işlemlere akıllıca yanıt vermesini sağlar.
Bu, çoğu framework kolaylığının mekanizmasıdır: Laravel'in Eloquent ORM'si model özellikleri için __get/__set kullanır, query builder'ı ve facade'ları fluent dinamik metotlar için __call/__callStatic kullanır ve config/collection nesneleri bunları her yerde kullanır.
Sihirli metotları tanımak bu framework'lerin nasıl çalıştığını açıklar ve benzer şekilde esnek API'ler oluşturmanıza olanak tanır.
Temel sihirli metotları, her birini neyin tetiklediğini ve yaygın framework kullanımlarını bilmek, hem ifadeli PHP yazmak hem de bu framework'leri etkili bir şekilde kullanmak/genişletmek için pratik bilgidir. (Uyarı: sihirli metotlar netliği ve IDE desteğini zedeleyebilir — aşırı kullanılması kodu anlamayı zorlaştırır, bu nedenle bunlar en iyi şekilde gerçek dinamik davranış için kasıtlı olarak kullanılmalı, varsayılan olarak değil.)