封裝是物件導向三大特性之首,核心目的是隱藏內部實作細節、控制資料存取方式、確保物件狀態一致性。PHP 提供三層可視性(public/protected/private)與四個屬性存取魔術方法(__get/__set/__isset/__unset),本文將深入剖析封裝實作技巧與常見陷阱。
| 關鍵字 | 類別內部 | 子類別 | 外部程式碼 | 典型用途 |
|---|---|---|---|---|
public | ✓ | ✓ | ✓ | 公開介面、API 端點 |
protected | ✓ | ✓ | ✗ | 內部邏輯、子類別擴充點 |
private | ✓ | ✓* | ✗ | 核心資料、實作細節 |
* 子類別無法直接存取 private 成員,但可透過父類別的 public/protected 方法間接操作。
<?php
// ❌ 未封裝:外部可任意修改,資料不安全
class PersonBad {
public $name, $age, $sex;
public function run() { echo "跑步中\n"; }
}
$p = new PersonBad();
$p->age = -50; // 不合理數值卻被允許
// ✅ 封裝後:受控存取,驗證邏輯集中管理
class PersonGood {
private $name, $age, $sex;
public function __construct($name, $age, $sex) {
$this->setName($name);
$this->setAge($age);
$this->setSex($sex);
}
// Getter / Setter 集中驗證
public function getAge() { return $this->age; }
public function setAge($age) {
if ($age < 0 || $age > 150) throw new InvalidArgumentException('年齡範圍 0-150');
$this->age = $age;
}
// name、sex 同理...
}
?>
| 魔術方法 | 觸發情境 | 參數 | 回傳值 |
|---|---|---|---|
__get($name) | 讀取 不可見 屬性(private/protected/不存在) | $name: 屬性名 | 屬性值 |
__set($name, $value) | 寫入 不可見 屬性 | $name, $value | 無 |
__isset($name) | 對不可見屬性呼叫 isset()/empty() | $name | bool |
__unset($name) | 對不可見屬性呼叫 unset() | $name | 無 |
<?php
class Person {
private $name, $age, $sex;
public function __construct($name, $age, $sex) {
$this->name = $name;
$this->age = $age;
$this->sex = $sex;
}
// 讀取攔截:年齡敏感資訊保護
public function __get($prop) {
if ($prop === 'age') {
// 業務規則:40 歲以上只顯示 -10 歲
return $this->age > 40 ? $this->age - 10 : $this->age;
}
return $this->$prop ?? null;
}
// 寫入攔截:嚴格驗證
public function __set($prop, $value) {
if ($prop === 'age') {
if ($value < 0 || $value > 120) {
throw new DomainException("年齡必須 0-120 之間");
}
$this->age = $value;
return;
}
$this->$prop = $value; // 其他屬性直接寫入
}
// isset() 支援
public function __isset($prop) {
return isset($this->$prop);
}
// unset() 支援
public function __unset($prop) {
unset($this->$prop);
}
// 封裝方法
private function run() { echo "私有跑步方法\n"; }
public function say() {
echo "我是 {$this->name},{$this->age} 歲,{$this->sex}\n";
$this->run(); // 內部可呼叫私有方法
}
}
// 使用示範
$p = new Person('李四', 45, '女');
echo $p->age; // 35(觸發 __get,45>40 顯示 35)
$p->age = 30; // 觸發 __set,驗證通過
// $p->age = 200; // 拋出 DomainException
isset($p->name); // true(觸發 __isset)
unset($p->name); // 觸發 __unset
?>
public。private 或 protected。private。public,穩定契約。<?php
class OrderService {
// 公開 API(5 個)
public function createOrder(array $data) { /* ... */ }
public function payOrder(string $orderNo) { /* ... */ }
public function cancelOrder(string $orderNo) { /* ... */ }
public function queryOrder(string $orderNo) { /* ... */ }
public function refundOrder(string $orderNo) { /* ... */ }
// 內部輔助方法(95 個,private/protected)
private function validateOrderData(array $data) { /* ... */ }
private function calculateTotal(array $items) { /* ... */ }
private function generateOrderNo() { /* ... */ }
protected function notifyUser(string $msg) { /* ... */ }
// ...
}
?>
private,按需暴露 protected 給子類別。public 方法,而非直接暴露屬性。封裝不只是「加上 private」,而是建立**清晰邊界**、**集中驗證邏輯**、**保護不變條件**的系統性工程。善用可視性關鍵字與魔術方法,能讓 PHP 物件模型更健壯、更易重構、更安全。