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);
}
}
-- 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 | 低(一次設定) | 資料庫層保證 | ⭐⭐⭐⭐⭐ |
<?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 或確保資料庫有 DEFAULTskipValidation() 與 notNullValidations:前者跳過所有驗證(含自定義),後者僅關閉 NOT NULL 自動驗證Phalcon Model 非空驗證源於資料庫 Schema,解決路徑由粗到細:
DEFAULT 與 NULL/NOT NULL(最推薦)beforeValidation() + RawValue 處理可選欄位validation() 完全自訂規則setup(['notNullValidations' => false]) 全關,但需自行把關建議新專案採用「資料庫 DEFAULT + 模型 validation() 精準驗證」雙層防護,既保資料品質又保開發彈性。