Blank

Validates that a value is blank - meaning equal to an empty string or null:

値が空白であることを検証します。つまり、空の文字列または null と等しいことを意味します。
1
2
3
 
if ('' !== $value && null !== $value) {
    // validation will fail
}

To force that a value strictly be equal to null, see the IsNull constraint.

値が厳密に null に等しいことを強制するには、IsNull 制約を参照してください。

To force that a value is not blank, see NotBlank. But be careful as NotBlank is not strictly the opposite of Blank.

値を空白にしないように強制するには、NotBlank を参照してください。ただし、NotBlank は厳密には Blank の反対ではないので注意してください。
Applies to property or method
Class Blank
Validator BlankValidator

Basic Usage

If, for some reason, you wanted to ensure that the firstName property of an Author class were blank, you could do the following:

何らかの理由で、Author クラスの firstName プロパティを空白にしたい場合は、次のようにします。
  • Attributes
    属性
  • YAML
    YAML
  • XML
    XML
  • PHP
    PHP
1
2
3
4
5
6
7
8
9
10
 
// src/Entity/Author.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class Author
{
    #[Assert\Blank]
    protected $firstName;
}

Options

groups

type: array | string

タイプ: 配列 |ストリング

It defines the validation group or groups of this constraint. Read more about validation groups.

この制約の検証グループを定義します。検証グループの詳細を参照してください。

message

type: string default: This value should be blank.

タイプ: 文字列 デフォルト: この値は空白にする必要があります。

This is the message that will be shown if the value is not blank.

これは、値が空白でない場合に表示されるメッセージです。

You can use the following parameters in this message:

このメッセージでは、次のパラメーターを使用できます。
Parameter Description
{{ value }} The current (invalid) value
{{ label }} Corresponding form field label

payload

type: mixed default: null

タイプ: 混合 デフォルト: null

This option can be used to attach arbitrary domain-specific data to a constraint. The configured payload is not used by the Validator component, but its processing is completely up to you.

このオプションは、任意のドメイン固有のデータを制約に添付するために使用できます。構成されたペイロードは Validator コンポーネントによって使用されませんが、その処理は完全にユーザー次第です。

For example, you may want to use several error levels to present failed constraints differently in the front-end depending on the severity of the error.

たとえば、いくつかのエラー レベルを使用して、エラーの重大度に応じて、失敗した制約をフロントエンドで異なる方法で提示することができます。