PHP 利用反射機制實現模型自動插入資料庫

前言

在開發資料存取層時，若能根據模型物件自動產生 INSERT 語句，將大幅減少重複代碼。本文展示如何使用 PHP 反射（Reflection）讀取模型屬性，動態組裝 SQL 並執行插入，同時支援選擇性回傳自增 ID。

核心代碼實現

/**
 * 利用反射自動插入模型資料
 * @param object $model 繼承 BaseModel 的模型實例
 * @param bool $is_returnLastInsertId 是否回傳新增的自增 ID
 * @return int|bool 成功筆數或最後插入 ID
 */
public function insertModel($model, $is_returnLastInsertId = FALSE) {
    try {
        require_once dirname(dirname(__FILE__)) . '\Models\BaseModel.php';
        if (!is_subclass_of($model, "BaseModel")) {
            exit($this->getError(__FUNCTION__, __LINE__));
        }

        $className = get_class($model);
        $tName     = $this->formatTabName($className);
        $reflectionClass = new ReflectionClass($className);
        $properties = $reflectionClass->getProperties();
        unset($properties[0]); // 假設第一個屬性為主鍵，略過

        $fields = "";
        $vals   = "";
        foreach ($properties as $property) {
            $pName = $property->getName();
            $fields .= $pName . ",";
            $vals   .= "'" . $model->$pName . "',";
        }
        $fields = rtrim($fields, ',');
        $vals   = rtrim($vals, ',');

        $this->sql = "INSERT INTO {$tName} ({$fields}) VALUES ({$vals})";

        if ($is_returnLastInsertId) {
            $this->conn->exec($this->sql);
            $lastId = (int)$this->conn->lastInsertId();
            return $lastId;
        } else {
            $row = $this->conn->exec($this->sql);
            return $row;
        }
    } catch (Exception $exc) {
        echo $exc->getMessage();
    }
}

關鍵點解析

1. 反射類別：ReflectionClass 可在執行時檢視類別結構，取得所有屬性（getProperties()）。
2. 屬性過濾：範例中 unset($properties[0]) 跳過第一個屬性（通常為主鍵 ID），避免手動指定自增欄位。
3. 動態 SQL 組裝：遍歷屬性拼湊欄位名與值，值直接嵌入 SQL 字串（注意：實務上建議使用參數綁定防止 SQL 注入）。
4. 彈性回傳：透過參數決定回傳影響行數或 lastInsertId()，符合不同業務需求。

效能與安全提醒

• 反射有一定效能開銷，高頻寫入場景建議改用預處理語句或 ORM。
• 範例直接拼接變數至 SQL，存在注入風險；生產環境務必改用 PDO::prepare() + 參數綁定。
• 屬性順序依賴反射回傳順序，若模型繼承關係複雜，需額外排序或標註。