在 PHP 5 的物件導向程式設計中,封裝性是核心概念之一。為了保護類別內部資料,我們通常將屬性宣告為 private。但這帶來一個問題:外部程式碼無法直接存取這些私有屬性。PHP 5 提供了四個魔術方法——__set()、__get()、__isset() 和 __unset()——讓我們能在維持封裝性的同時,靈活地處理屬性的讀寫、檢查與刪除操作。
傳統做法是為每個私有屬性撰寫 setName()、getName() 等存取器方法,但這會導致程式碼冗長。魔術方法提供了一種統一的攔截機制:當外部嘗試直接存取不可見屬性時,PHP 會自動呼叫對應的魔術方法,開發者只需在類別中定義一次邏輯即可。
這兩個方法是最常用的魔術方法組合。當程式碼嘗試讀取不可存取(如 private 或不存在)的屬性時,__get($name) 會被自動觸發;同理,寫入操作會觸發 __set($name, $value)。
class Person {
private $name;
private $sex;
private $age;
public function __get($property_name) {
if (isset($this->$property_name)) {
return $this->$property_name;
}
return null;
}
public function __set($property_name, $value) {
$this->$property_name = $value;
}
}
$p1 = new Person();
$p1->name = '張三'; // 自動呼叫 __set()
$p1->sex = '男';
$p1->age = 20;
echo '姓名:' . $p1->name . '
'; // 自動呼叫 __get()
echo '性別:' . $p1->sex . '
';
echo '年齡:' . $p1->age . '
';
執行結果將正常輸出屬性值。若未定義這兩個方法,直接存取 private 屬性會拋出致命錯誤。
__set() 非常適合在寫入前進行資料驗證:
public function __set($property_name, $value) {
if ($property_name === 'age') {
if (!is_int($value) || $value < 0 || $value > 150) {
throw new InvalidArgumentException('年齡必須為 0-150 之間的整數');
}
}
$this->$property_name = $value;
}
當外部程式碼對物件的私有屬性呼叫 isset() 時,PHP 會自動觸發 __isset($name)。這讓我們能控制「存在」的定義邏輯。
public function __isset($name) {
echo "檢查私有屬性 '$name' 是否存在
";
return isset($this->$name);
}
使用範例:
$p1 = new Person();
$p1->name = '李四';
var_dump(isset($p1->name)); // 輸出 true 並觸發 __isset()
var_dump(isset($p1->email)); // 輸出 false
同理,當外部對私有屬性呼叫 unset() 時,__unset($name) 會被自動呼叫:
public function __unset($name) {
echo "刪除私有屬性 '$name'
";
unset($this->$name);
}
使用範例:
unset($p1->name); // 觸發 __unset(),name 屬性被移除
echo $p1->name; // 輸出 null(觸發 __get() 回傳 null)
class Person {
private $name;
private $sex;
private $age;
public function __get($property_name) {
if (isset($this->$property_name)) {
return $this->$property_name;
}
return null;
}
public function __set($property_name, $value) {
$this->$property_name = $value;
}
public function __isset($name) {
return isset($this->$name);
}
public function __unset($name) {
unset($this->$name);
}
}
$p1 = new Person();
$p1->name = '王五';
$p1->age = 25;
echo isset($p1->name) ? 'name 存在' : 'name 不存在'; // name 存在
echo '
';
unset($p1->name);
echo isset($p1->name) ? 'name 存在' : 'name 不存在'; // name 不存在
__set() 中拋出例外或直接忽略寫入。#[\AllowDynamicProperties] 或明確宣告屬性。__sleep() 和 __wakeup()。__set()、__get()、__isset()、__unset() 四個魔術方法為 PHP 物件導向提供了強大的屬性存取攔截能力。它們讓封裝性與靈活性得以兼得,是建構現代化 PHP 應用(如 Active Record、Data Mapper 模式)的基石。善用這些方法,能讓程式碼更簡潔、更具擴充性。