Magic method ialah kaedah khas (berawalan __) yang dipanggil PHP secara automatik sebagai tindak balas kepada tindakan tertentu pada objek — seperti mengakses property yang tidak ditakrifkan, memanggil kaedah yang tidak ditakrifkan, atau menukar objek kepada string. Ia membolehkan anda mengait dan menyesuaikan tingkah laku objek.
{
{ }
{ }
}
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 memintas akses kepada property yang tidak wujud atau tidak boleh diakses — membolehkan property dinamik (digunakan oleh ORM, objek config).
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 memintas panggilan kepada kaedah yang tidak ditakrifkan — digunakan untuk API fluent/dinamik (cth. query builder Laravel, facade).
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
Magic method ialah ciri PHP yang penting untuk menyesuaikan tingkah laku objek, dan memahaminya berharga untuk kedua-dua menggunakannya dengan sewajarnya dan — terutamanya — untuk memahami cara framework PHP mencapai "magic" mereka. Kaedah seperti __get/__set (akses property dinamik), __call/__callStatic (pengendalian kaedah dinamik), __toString (penukaran string), dan __invoke (objek boleh dipanggil) membolehkan objek bertindak balas secara bijak kepada operasi yang tidak ditakrifkan secara eksplisit.
Ini ialah mekanisme di sebalik banyak kemudahan framework: Eloquent ORM Laravel menggunakan __get/__set untuk attribute model, query builder dan facadenya menggunakan __call/__callStatic untuk kaedah dinamik yang fluent, dan objek config/collection menggunakan ini di seluruhnya.
Mengenali magic method menyahmistifikasi cara framework ini berfungsi dan membolehkan anda membina API yang sama fleksibel.
Mengetahui magic method utama, apa yang mencetuskan setiap satu, dan penggunaan framework biasanya ialah pengetahuan praktikal untuk kedua-dua menulis PHP yang ekspresif dan menggunakan/melanjutkan framework yang dibina di atasnya secara berkesan. (Peringatannya: magic method boleh menjejaskan kejelasan dan sokongan IDE — menggunakannya secara berlebihan menjadikan kod lebih sukar difahami, jadi ia paling baik digunakan secara sengaja untuk tingkah laku dinamik tulen, bukan sebagai lalai.)