Download the PHP package jackai/symfony-validator without Composer

Jackai Symfony Validator

Validate request on symfony controller annotation.

Installation

1.Open a command console, enter your project directory and execute the following command to download the latest version of this bundle:

2.Open config/services.yaml and add this config:

Useage

驗證器參數說明

• throwOnMissingValidate: 當帶入的參數不存在驗證列表時，是否拋出例外，預設為 false
• throwOnValidateFail: 當驗證失敗時，是否拋出例外，預設為 true
• emptyStringIsUndefined: 帶入的參數為空字串時，是否當作未帶入參數處理，預設為 true
• requireQuery: 在query中必填的欄位
• requireForm: 在form中必填的欄位
• requireQueryCode: 當query中必填未填寫時，要拋出的錯誤代碼，預設為 null
• requireFormCode: 當form中必填未填寫時，要拋出的錯誤代碼，預設為 null
• query: 在query中欄位驗證規則
• form: 在form中欄位驗證規則

query及form驗證規則說明

在query跟form參數中的驗證規則如下：

• name: 欄位名稱，可以用 . 來串接欄位名稱，例如參數為 config[abc] 就可寫為 config.abc
• dataType: 轉換欄位型態
• rule: 驗證規則，目前有三種能用
  • Assert\*: 為symfony的驗證器，可參考官方網站的列表: (https://symfony.com/doc/current/validation.html#constraints)
  • 自製的symfony的驗證器: 在參數中寫入Class位置即可，例如： App\Validator\Constraints\ContainsAlphanumeric，詳細說明可參考symfony官方網站 (https://symfony.com/doc/current/validation/custom_constraint.html)
  • require: 特殊規則的必填欄位
• ruleOption: 驗證規則的參數設置
• code: 條件驗證失敗時回傳的錯誤代碼，預設為 null
• msg: 條件驗證失敗時回傳的錯誤訊息，預設為 驗證規則提供的錯誤訊息
• require: 是否為必填欄位，預設值為 false
• default: 當欄位未填寫時，預設傳入 controller 的值

特殊規則的必填欄位

當 "rule" = "require" 時，為驗證特殊必填狀況，特殊必填情況符合時 name 欄位為必填。

特殊必填有以下幾個模式：

• 指定的欄位值等於其中一個數值: "mode" = "if", "values" = {"指定欄位", "數值1", "數值2",,, "數值N"}
• 其中一個指定欄位有值: "mode" = "with", "values" = {"指定欄位A", "指定欄位B",,, "指定欄位N"}
• 全部指定欄位都有值: "mode" = "withAll", "values" = {"指定欄位A", "指定欄位B",,, "指定欄位N"}
• 指定的欄位其中一個沒有值: "mode" = "without", "values" = {"指定欄位A", "指定欄位B",,, "指定欄位N"}
• 指定的欄位全部沒有值: "mode" = "withoutAll", "values" = {"指定欄位A", "指定欄位B",,, "指定欄位N"}

使用範例

Create custom validation

After creating a validator using the example on the official Symfony website (https://symfony.com/doc/current/validation/custom_constraint.html), add the following line in the annotation.

Create advanced custom validation

1. Use Jackai\Validator\Constraint
2. You can get rawValues and doctrine in constraint
3. Don't forget to add alias: "My": "App\\Validator"
4. And you can use "rule" = "My\DataUnique"

src\Validator\DataUnique.php

src\Validator\DataUniqueValidator.php

config/service.yaml

src/Controller/TestController.php