PHP 5 引入完整物件模型,核心特性之一是成員可見性,提供比 var 更精細的存取控制,是資料封裝的基石。
| 修飾符 | 存取範圍 | 使用場景 |
|---|---|---|
public (預設) | 任何位置 | 對外公開的 API、屬性 |
protected | 類內部 + 繼承子類 | 內部邏輯、允許子類擴充/覆寫的核心屬性/方法 |
private | 僅當前類內部 | 核心狀態、實現細節,防止外部甚至子類誤改 |
違反規則會拋出 Fatal Error,強制在語法層面保護資料完整性。
結合 protected(子類可擴充)與 private(核心封裝),構建可重用、安全的資料庫查詢封裝。
class DBQuery {
protected $db; // 資料庫連線引用 (子類可用)
protected $stored_procedure = false;
private $query; // 清理後的 SQL (完全封裝)
private $quote_store = []; // 字串暫存 (完全封裝)
private static $QUOTE_MATCH = '/(".*?(?db = $db;
}
// 準備預處理語句:移除字串字面值避免誤解析佔位符
public function prepare($sql) {
$this->stored_procedure = true;
$this->quote_store = [];
$this->query = preg_replace_callback(self::$QUOTE_MATCH, [$this, 'storeQuote'], $sql);
}
private function storeQuote($m) {
$this->quote_store[] = $m[0];
return '$||$' . (count($this->quote_store)-1);
}
// 編譯:替換佔位符 :1I, :2S 等,返回最終 SQL 不執行
public function compile(...$params) {
if (!$this->stored_procedure) throw new Exception('Stored procedure not initialized');
$sql = $this->query;
// 替換邏輯...
return $this->restoreQuotes($sql);
}
// 執行:同 compile 但直接執行並回傳結果集
public function execute(...$params) {
if (!$this->stored_procedure) {
$sql = array_shift($params);
return $this->db->query($sql);
}
$sql = $this->compile(...$params);
return $this->db->query($sql);
}
private function restoreQuotes($sql) {
// 將 $||$n 還原為原始字串
return str_replace(array_keys($this->quote_store), $this->quote_store, $sql);
}
}
private $query:確保 SQL 字串只能透過 prepare()/compile() 流程修改,防止外部竄改。private $quote_store + private storeQuote():字串處理細節完全內隱,子類覆寫 prepare() 也不會誤觸。protected $db:允許子類 (如 MySQLQuery, PgSQLQuery) 存取連線、覆寫執行邏輯。protected $stored_procedure:狀態標記給子類協作用。class MySQLQuery extends DBQuery {
public function execute(...$params) {
// 可在這裡加入 MySQL 專屬邏輯 (如 last_insert_id)
return parent::execute(...$params);
}
}
合理使用 private 封裝核心狀態與演算法細節,protected 開放擴充點,public 定義穩定介面,能構建健壯、可維護、安全的物件模型。這不只是語法糖,是大型專案架構的基石。