PHP 5 引入可見性控制，讓類別成員（屬性、方法）能限定存取範圍。正確使用 private、public、protected 是封裝性的核心，也是寫出可維護程式碼的關鍵。

三種可見性關鍵字

實戰範例：private vs public

<?php
$kirupa = new User();

// 嘗試存取 private 屬性（透過方法）
$kirupa->setName('Kirupa');
echo $kirupa->getName() . '<br />'; // 正常：Kirupa

// 直接存取 private 屬性 → 致命錯誤
// echo $kirupa->name . '<br />'; // Fatal error: Cannot access private property

// 直接存取 public 屬性 → 正常
$kirupa->location = 'MIT';
echo $kirupa->location . '<br />'; // MIT

class User {
    private $name;    // 僅能透過方法存取
    public $location; // 可直接存取
    
    function setName($val) {
        $this->name = $val;
    }
    
    function getName() {
        return $this->name;
    }
}
?>

為什麼偏好 private？封裝性的價值

1. 資料保護：防止外部任意修改內部狀態，導致不一致
2. 介面穩定：內部實作可變更，不影響外部呼叫端
3. 驗證控制：Setter 可加入驗證邏輯（如長度、格式、範圍檢查）
4. 除錯容易：所有資料流經已知方法，易於追蹤與記錄

<?php
class User {
    private string $email = '';
    
    public function setEmail(string $email): void {
        if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
            throw new InvalidArgumentException("無效 Email 格式");
        }
        $this->email = $email;
    }
    
    public function getEmail(): string {
        return $this->email;
    }
}
?>

方法的可見性

方法同樣支援三種可見性，預設為 public：

<?php
class Service {
    public function execute(): void {        // 公開 API
        $this->validateInput();
        $this->process();
        $this->logResult();
    }
    
    private function validateInput(): void { // 內部驗證
        // ...
    }
    
    private function process(): void {       // 核心邏輯
        // ...
    }
    
    protected function logResult(): void {   // 允許子類別覆寫記錄方式
        // ...
    }
}
?>

建構子與可見性

<?php
class User {
    private string $job;
    
    // PHP 5+ 魔術方法建構子
    public function __construct() {
        $this->job = 'Engineer'; // 初始化預設值
    }
    
    // PHP 4 風格建構子（已淘汰）
    // function User() { ... }
    
    public function getJob(): string {
        return $this->job;
    }
}

$kirupa = new User();
echo $kirupa->getJob(); // Engineer（建構子自動執行）
?>

PHP 4 vs PHP 5 差異對照