Isbn

This constraint validates that an International Standard Book Number (ISBN) is either a valid ISBN-10 or a valid ISBN-13.

この制約は、国際標準図書番号 (ISBN) が有効な ISBN-10 または有効な ISBN-13 であることを検証します。
Applies to property or method
Class Isbn
Validator IsbnValidator

Basic Usage

To use the Isbn validator, apply it to a property or method on an object that will contain an ISBN.

Isbn バリデータを使用するには、ISBN を含むオブジェクトのプロパティまたはメソッドに適用します。
  • Attributes
    属性
  • YAML
    YAML
  • XML
    XML
  • PHP
    PHP
1
2
3
4
5
6
7
8
9
10
11
12
13
 
// src/Entity/Book.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class Book
{
    #[Assert\Isbn(
        type: Assert\Isbn::ISBN_10,
        message: 'This value is not valid.',
    )]
    protected $isbn;
}

Note

ノート

As with most of the other constraints, null and empty strings are considered valid values. This is to allow them to be optional values. If the value is mandatory, a common solution is to combine this constraint with NotBlank.

他のほとんどの制約と同様に、null および空の文字列は有効な値と見なされます。これは、それらをオプションの値にできるようにするためです。値が必須の場合、一般的な解決策は、この制約と NotBlank を組み合わせることです。

Available Options

bothIsbnMessage

type: string default: This value is neither a valid ISBN-10 nor a valid ISBN-13.

タイプ: 文字列 デフォルト: この値は、有効な ISBN-10 でも有効な ISBN-13 でもありません。

The message that will be shown if the type option is null and the given value does not pass any of the ISBN checks.

type オプションが null で、指定された値が ISBN チェックのいずれにも合格しない場合に表示されるメッセージ。

You can use the following parameters in this message:

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

groups

type: array | string

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

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

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

isbn10Message

type: string default: This value is not a valid ISBN-10.

タイプ: 文字列 デフォルト: この値は有効な ISBN-10 ではありません。

The message that will be shown if the type option is isbn10 and the given value does not pass the ISBN-10 check.

type オプションが isbn10 で、指定された値が ISBN-10 チェックに合格しない場合に表示されるメッセージ。

You can use the following parameters in this message:

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

isbn13Message

type: string default: This value is not a valid ISBN-13.

タイプ: 文字列 デフォルト: この値は有効な ISBN-13 ではありません。

The message that will be shown if the type option is isbn13 and the given value does not pass the ISBN-13 check.

type オプションが isbn13 で、指定された値が ISBN-13 チェックに合格しない場合に表示されるメッセージ。

You can use the following parameters in this message:

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

message

type: string default: null

タイプ: 文字列 デフォルト: null

The message that will be shown if the value is not valid. If not null, this message has priority over all the other messages.

値が無効な場合に表示されるメッセージ。 null でない場合、このメッセージは他のすべてのメッセージよりも優先されます。

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.

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

type

type: string default: null

タイプ: 文字列 デフォルト: null

The type of ISBN to validate against. Valid values are isbn10, isbn13 and null to accept any kind of ISBN.

検証する ISBN のタイプ。有効な値は isbn10、isbn13、および null で、あらゆる種類の ISBN を受け入れます。