萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 封裝性核心機制:可視性控制、魔術方法與資料保護實戰

前言

封裝是物件導向三大特性之首,核心目的是隱藏內部實作細節、控制資料存取方式、確保物件狀態一致性。PHP 提供三層可視性(public/protected/private)與四個屬性存取魔術方法(__get/__set/__isset/__unset),本文將深入剖析封裝實作技巧與常見陷阱。

一、可視性控制:封裝的第一道防線

1.1 三層可視性對照

關鍵字類別內部子類別外部程式碼典型用途
public✓✓✓公開介面、API 端點
protected✓✓✗內部邏輯、子類別擴充點
private✓✓*✗核心資料、實作細節

* 子類別無法直接存取 private 成員,但可透過父類別的 public/protected 方法間接操作。

1.2 封裝前後對比

<?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 同理...
}
?>

二、魔術方法:攔截不可見屬性存取

2.1 四大屬性魔術方法簽名與觸發時機

魔術方法觸發情境參數回傳值
__get($name)讀取 不可見 屬性(private/protected/不存在)$name: 屬性名屬性值
__set($name, $value)寫入 不可見 屬性$name, $value無
__isset($name)對不可見屬性呼叫 isset()/empty()$namebool
__unset($name)對不可見屬性呼叫 unset()$name無

2.2 完整實作範例:智慧型年齡存取控制

<?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
?>

2.3 魔術方法效能提醒

  • 每次不可見屬性存取都會觸發魔術方法,**效能較直接存取低**;高頻存取路徑建議改用明確 Getter/Setter。
  • 魔術方法不可為 static,且必須宣告為 public。

三、方法封裝:隱藏內部實作細節

3.1 何時封裝方法

  • 輔助方法:僅供本類別/子類別內部呼叫 → private 或 protected。
  • 內部演算法步驟:防止外部依賴具體實作 → private。
  • 介面公開方法:public,穩定契約。

3.2 實戰:100 方法類別,僅 5 個公開 API

<?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) { /* ... */ }
    // ...
}
?>

四、封裝設計原則總結

  1. 資料私有化:所有屬性預設 private,按需暴露 protected 給子類別。
  2. 行為公開化:對外提供語意清晰的 public 方法,而非直接暴露屬性。
  3. 驗證集中化:所有資料驗證邏輯集中在 Setter/魔術方法,避免分散在呼叫端。
  4. 最小權限原則:方法/屬性預設最嚴格可視性,逐步放寬而非收緊。
  5. 不可變物件:僅提供 Getter、建構子注入,移除 Setter,提升執行緒安全與可預測性。

結語

封裝不只是「加上 private」,而是建立**清晰邊界**、**集中驗證邏輯**、**保護不變條件**的系統性工程。善用可視性關鍵字與魔術方法,能讓 PHP 物件模型更健壯、更易重構、更安全。

copyright © 萬盛學電腦網 all rights reserved