萬盛學電腦網

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

Phalcon Model 插入/更新時自動驗證非空欄位解決方案

問題背景

Phalcon Model 在 save()、create()、update() 時,會根據資料庫 Schema 的 NOT NULL 約束自動產生驗證規則。若實體類別對應欄位未賦值(或為 null),會拋出驗證失敗訊息:「Field 'xxx' doesn't have a default value」或「xxx is required」,導致資料無法寫入。

方案一:關閉非空驗證(全域、最徹底)

<?php
use Phalcon\Mvc\Model;

class BaseModel extends Model {
    public function initialize() {
        // 關閉 NOT NULL 自動驗證
        $this->setup([
            'notNullValidations' => false
        ]);
    }
}

// 所有 Model 繼承 BaseModel
class Users extends BaseModel {
    // ...
}

優點:一勞永逸,不需逐欄位設定。
缺點:失去框架層面的資料完整性防護,必須在業務邏輯/前端/資料庫層完整處理非空檢查。

方案二:針對可為空欄位單獨跳過驗證(精準控制)

<?php
use Phalcon\Mvc\Model;
use Phalcon\Db\RawValue;

class Users extends Model {
    public function beforeValidation() {
        // 定義允許為空的欄位
        $nullableFields = ['tag', 'source_url', 'description', 'meta_keywords'];
        
        foreach ($nullableFields as $field) {
            // 若屬性為空(null、''、未設定),註入 RawValue 空字串
            // RawValue 告訴 Phalcon 「此值已處理,跳過型別轉換與驗證」
            if (empty($this->$field)) {
                $this->$field = new RawValue("''");
            }
        }
    }
}

關鍵點:Phalcon\Db\RawValue 讓值直接寫入 SQL 不經過 escape/quote,'' 為空字串 SQL 字面值。若資料庫欄位有 DEFAULT,也可用 new RawValue('DEFAULT')。

方案三:自定義驗證器覆蓋預設行為

<?php
use Phalcon\Mvc\Model;
use Phalcon\Validation;
use Phalcon\Validation\Validator\PresenceOf;

class Users extends Model {
    public function validation() {
        $validator = new Validation();
        
        // 僅驗證真正必填的核心欄位
        $required = ['username', 'email', 'password_hash'];
        foreach ($required as $field) {
            $validator->add($field, new PresenceOf([
                'message' => "$field 不可為空",
                'cancelOnFail' => true
            ]));
        }
        
        // 可選欄位:長度、格式驗證但允許空值
        $validator->add('email', new \Phalcon\Validation\Validator\Email([
            'message' => 'Email 格式錯誤',
            'allowEmpty' => true  // 關鍵:允許空值
        ]));
        
        return $this->validate($validator);
    }
}

方案四:資料庫層面設定 DEFAULT 值(最根本)

-- MySQL
ALTER TABLE users 
    MODIFY COLUMN tag VARCHAR(255) DEFAULT '',
    MODIFY COLUMN source_url VARCHAR(500) DEFAULT '',
    MODIFY COLUMN description TEXT DEFAULT '';

資料庫有 DEFAULT 時,Phalcon 會在生成 INSERT SQL 時略過該欄位,資料庫自動填入預設值,不觸發非空驗證。

方案比較與選型建議

方案適用場景維護成本資料完整性推薦度
關閉 notNullValidations舊專案快速遷移、欄位極多低靠業務層保證⭐⭐
beforeValidation + RawValue少數欄位可空、需精準控制中(需維護清單)框架層仍有保護⭐⭐⭐⭐
自定義 validation()複雜驗證邏輯、條件性必填高完全可控⭐⭐⭐⭐⭐
資料庫 DEFAULT新專案設計階段、DBA 管控 Schema低(一次設定)資料庫層保證⭐⭐⭐⭐⭐

進階技巧:動態判斷 nullable 欄位

<?php
class BaseModel extends Model {
    protected array $nullableFields = [];

    public function initialize() {
        // 自動讀取資料庫 Schema,找出有 DEFAULT 或可為 NULL 的欄位
        // 注意:需在模型定義後、首次使用前執行,可快取結果
        $this->loadNullableFields();
    }

    protected function loadNullableFields(): void {
        $table = $this->getSource();
        $columns = $this->getModelsManager()->getReadConnection()->describeColumns($table);
        
        foreach ($columns as $col) {
            // notNull=false 或有 default 值
            if (!$col->getNotNull() || $col->getDefault() !== null) {
                $this->nullableFields[] = $col->getName();
            }
        }
    }

    public function beforeValidation() {
        foreach ($this->nullableFields as $field) {
            if (empty($this->$field)) {
                $this->$field = new RawValue("''");
            }
        }
    }
}

常見誤區

  • 以為 allowNull => true 在模型屬性註解有用:Phalcon 不支援此註解,驗證邏輯基於資料庫 Schema
  • 直接設 $this->field = null:仍會觸發非空驗證失敗,必須用 RawValue 或確保資料庫有 DEFAULT
  • 混淆 skipValidation() 與 notNullValidations:前者跳過所有驗證(含自定義),後者僅關閉 NOT NULL 自動驗證

總結

Phalcon Model 非空驗證源於資料庫 Schema,解決路徑由粗到細:

  1. 資料庫設計階段:合理設定 DEFAULT 與 NULL/NOT NULL(最推薦)
  2. 模型層精準控制:beforeValidation() + RawValue 處理可選欄位
  3. 複雜業務邏輯:覆寫 validation() 完全自訂規則
  4. 緊急/舊專案:setup(['notNullValidations' => false]) 全關,但需自行把關

建議新專案採用「資料庫 DEFAULT + 模型 validation() 精準驗證」雙層防護,既保資料品質又保開發彈性。

copyright © 萬盛學電腦網 all rights reserved