跳到內容

Issn

編輯此頁

驗證數值是否為有效的國際標準期刊號 (ISSN)

適用於 屬性或方法
類別 Issn
驗證器 IssnValidator

基本用法

1
2
3
4
5
6
7
8
9
10
// src/Entity/Journal.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class Journal
{
    #[Assert\Issn]
    protected string $issn;
}

注意

如同大多數其他的約束條件,null 和空字串會被視為有效值。這是為了允許它們成為選填值。如果該值為必填,常見的解決方案是將此約束條件與 NotBlank 結合使用。

選項

caseSensitive

類型boolean 預設值:false

驗證器預設會允許 ISSN 值以小寫 'x' 結尾。當切換為 true 時,驗證器會要求使用大寫 'X'。

groups

類型array | string 預設值null

定義此約束條件的驗證群組。閱讀更多關於驗證群組的資訊。

message

類型string 預設值:This value is not a valid ISSN.

當給定的值不是有效的 ISSN 時顯示的訊息。

您可以在此訊息中使用以下參數

參數 描述
{{ value }} 目前的(無效)值
{{ label }} 對應的表單欄位標籤

payload

類型mixed 預設值null

此選項可用於將任意的領域特定資料附加到約束條件。Validator 元件不會使用已設定的 payload,但其處理完全取決於您。

例如,您可能會想要使用多個錯誤層級,以便根據錯誤的嚴重性,在前端以不同方式呈現失敗的約束條件。

requireHyphen

類型boolean 預設值:false

驗證器預設會允許非連字號的 ISSN 值。當切換為 true 時,驗證器會要求使用連字號的 ISSN 值。

本作品,包含程式碼範例,以 Creative Commons BY-SA 3.0 授權條款授權。
目錄
    版本