廢話
忍不住先吐槽一下,且不說TP的功能怎么樣,文檔寫得是真的潦草,很多復雜的情況都沒有舉例說明。奈何網上的資料又很少,每次只能一點點去啃源碼,難受的呀,常常想換個框架或者換個語言得了,但又以沒時間為由懶得行動,真是自作自受呢 ≧ ﹏ ≦。
最近在工作的時候用到TP6驗證器的場景里的 only、remove、append 三個方法,沒想到用起來好多小問題,非常不順手,無奈只能一個個去找具體的隱藏規則了。
正文
先附上源碼路徑:\vendor\topthink\framwork\src\think\Validate.php
然后說一下源碼里大致的程序邏輯:
1. 先把 only+append 所有的驗證規則 rule 找出來,合成一個數組。
2. 然后去 remove 里面找,如果在 remove 里面,則跳過驗證。
3. 開始驗證,即only+append-remove 的所有規則。
根據這個邏輯,only、remove、append 是無所謂先后順序的。(第一個小發現)
接下來是這次試出來的幾個規則,時間有限,內容還比較少,后面會在使用的過程中再慢慢補充。
1. remove 和 append 使用的前提得是需要 only 聲明:
第一點雖然文檔里沒有明說,但是稍微試一下還是能很容易得出結論的。
//文檔里的例子
public function sceneEdit()
{
? return $this->only(['name','age'])
? ? ? ->append('name', 'min:5')
? ? ? ->remove('age', 'between')
? ? ? ->append('age', 'require|max:100');
}
稍微看一下源碼,確實寫的就是如果only里面沒有就直接跳過。
2. remove 和 append 的用法稍有不同。append需要指定具體的規則內容,如 append('date', 'dateFormat:Y-m-d');而 remove 則只能指定規則名,如 remove('date', 'dateFormat')。
這一點雖然也能在文檔給出的唯一一個例子中發現,但是藏得確實有點深,正常人可能就直接復制粘貼,結果搞了半天還是沒用。(就比如說我)
具體的邏輯在源碼的 checkItem 方法中能找到。大致的意思是,通過 getValidateType 這個方法,將我們傳進去的規則轉換成 type類型、rule具體規則、info規則,然后再去 remove 里面匹配。
//比如我原來定義了一個
protected $rule = [
'date' => 'dateFormat:Y-m-d',
]
//此時通過getValidateType返回的值是["dateFormat","Y-m-d","dateFormat"]
remove('arrival_time', 'date|dateFormat:Y-m-d') //這么使用的話就是in_array("dateFormat",["date","dateFormat:Y-m-d"]),自然就不能remove成功了
remove('arrival_time', 'date|dateFormat') //根據代碼邏輯,只能這么使用
3. 在看源碼的時候發現 remove 的第二個參數可以傳 true,來移除該字段的所有規則。但是按照上文的說法,同一個字段是不能先 remove 再 append 的。(稍微有點可惜)