Creating a custom Type Guesser

The Form component can guess the type and some options of a form field by using type guessers. The component already includes a type guesser using the assertions of the Validation component, but you can also add your own custom type guessers.

フォーム コンポーネントは、型推測機能を使用して、フォーム フィールドの型といくつかのオプションを推測できます。このコンポーネントには、検証コンポーネントのアサーションを使用する型推測機能が既に含まれていますが、独自のカスタム型推測機能を追加することもできます。
ブリッジのフォーム型ゲッサー

Symfony also provides some form type guessers in the bridges:

symfony は、ブリッジでいくつかのフォーム タイプの推測も提供します。
  • DoctrineOrmTypeGuesser provided by the Doctrine bridge.
    Doctrineブリッジによって提供されるDoctrineOrmTypeGuesser。

Create a PHPDoc Type Guesser

In this section, you are going to build a guesser that reads information about fields from the PHPDoc of the properties. At first, you need to create a class which implements FormTypeGuesserInterface. This interface requires four methods:

このセクションでは、プロパティの PHPDoc からフィールドに関する情報を読み取るゲッサーを作成します。最初に、FormTypeGuesserInterface を実装するクラスを作成する必要があります。このインターフェイスには 4 つのメソッドが必要です。
guessType()
Tries to guess the type of a field;
フィールドの型を推測しようとします。
guessRequired()
Tries to guess the value of the required option;
requiredoption の値を推測しようとします。
guessMaxLength()
Tries to guess the value of the maxlength input attribute;
maxlength 入力属性の値を推測しようとします。
guessPattern()
Tries to guess the value of the pattern input attribute.
パターン入力属性の値を推測しようとします。

Start by creating the class and these methods. Next, you'll learn how to fill each in:

クラスとこれらのメソッドを作成することから始めます。次に、それぞれの入力方法を学習します。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// src/Form/TypeGuesser/PHPDocTypeGuesser.php
namespace App\Form\TypeGuesser;

use Symfony\Component\Form\FormTypeGuesserInterface;
use Symfony\Component\Form\Guess\TypeGuess;
use Symfony\Component\Form\Guess\ValueGuess;

class PHPDocTypeGuesser implements FormTypeGuesserInterface
{
    public function guessType(string $class, string $property): ?TypeGuess
    {
    }

    public function guessRequired(string $class, string $property): ?ValueGuess
    {
    }

    public function guessMaxLength(string $class, string $property): ?ValueGuess
    {
    }

    public function guessPattern(string $class, string $property): ?ValueGuess
    {
    }
}

Guessing the Type

When guessing a type, the method returns either an instance of TypeGuess or nothing, to determine that the type guesser cannot guess the type.

型を推測する場合、メソッドは TypeGuess のインスタンスを返すか、何も返さないことで、型推測機能が型を推測できないことを判断します。

The TypeGuess constructor requires three options:

TypeGuess コンストラクターには、次の 3 つのオプションが必要です。
  • The type name (one of the form types);
    タイプ名 (フォーム タイプの 1 つ)。
  • Additional options (for instance, when the type is entity, you also want to set the class option). If no types are guessed, this should be set to an empty array;
    追加のオプション (たとえば、タイプがエンティティの場合、クラス オプションも設定する必要があります)。型が推測されない場合、これは空の配列に設定する必要があります。
  • The confidence that the guessed type is correct. This can be one of the constants of the Guess class: LOW_CONFIDENCE, MEDIUM_CONFIDENCE, HIGH_CONFIDENCE, VERY_HIGH_CONFIDENCE. After all type guessers have been executed, the type with the highest confidence is used.
    推測された型が正しいという確信。これは、Guess クラスの定数の 1 つです: LOW_CONFIDENCE、MEDIUM_CONFIDENCE、HIGH_CONFIDENCE、VERY_HIGH_CONFIDENCE。すべての型ゲッサーが実行された後、信頼度が最も高い型が使用されます。

With this knowledge, you can implement the guessType() method of the PHPDocTypeGuesser:

この知識があれば、PHPDocTypeGuesser のguessType() メソッドを実装できます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
// src/Form/TypeGuesser/PHPDocTypeGuesser.php
namespace App\Form\TypeGuesser;

use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
use Symfony\Component\Form\Extension\Core\Type\IntegerType;
use Symfony\Component\Form\Extension\Core\Type\NumberType;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Guess\Guess;
use Symfony\Component\Form\Guess\TypeGuess;

class PHPDocTypeGuesser implements FormTypeGuesserInterface
{
    public function guessType(string $class, string $property): ?TypeGuess
    {
        $annotations = $this->readPhpDocAnnotations($class, $property);

        if (!isset($annotations['var'])) {
            return null; // guess nothing if the @var annotation is not available
        }

        // otherwise, base the type on the @var annotation
        return match($annotations['var']) {
            // there is a high confidence that the type is text when
            // @var string is used
            'string' => new TypeGuess(TextType::class, [], Guess::HIGH_CONFIDENCE),

            // integers can also be the id of an entity or a checkbox (0 or 1)
            'int', 'integer' => new TypeGuess(IntegerType::class, [], Guess::MEDIUM_CONFIDENCE),

            'float', 'double', 'real' => new TypeGuess(NumberType::class, [], Guess::MEDIUM_CONFIDENCE),

            'boolean', 'bool' => new TypeGuess(CheckboxType::class, [], Guess::HIGH_CONFIDENCE),

            // there is a very low confidence that this one is correct
            default => new TypeGuess(TextType::class, [], Guess::LOW_CONFIDENCE)
        };
    }

    protected function readPhpDocAnnotations(string $class, string $property): array
    {
        $reflectionProperty = new \ReflectionProperty($class, $property);
        $phpdoc = $reflectionProperty->getDocComment();

        // parse the $phpdoc into an array like:
        // ['var' => 'string', 'since' => '1.0']
        $phpdocTags = ...;

        return $phpdocTags;
    }

    // ...
}

This type guesser can now guess the field type for a property if it has PHPDoc!

この型推測機能は、PHPDoc が含まれている場合に、プロパティのフィールド型を推測できるようになりました。

Guessing Field Options

The other three methods (guessMaxLength(), guessRequired() and guessPattern()) return a ValueGuess instance with the value of the option. This constructor has 2 arguments:

他の 3 つのメソッド (guessMaxLength()、guessRequired()、guessPattern()) は、オプションの値を持つ ValueGuessinstance を返します。このコンストラクターには 2 つの引数があります。
  • The value of the option;
    オプションの値。
  • The confidence that the guessed value is correct (using the constants of the Guess class).
    推測値が正しいという信頼度 (Guess クラスの定数を使用)。

null is guessed when you believe the value of the option should not be set.

オプションの値が設定されるべきではないと思われる場合、 null が推測されます。

Caution

注意

You should be very careful using the guessPattern() method. When the type is a float, you cannot use it to determine a min or max value of the float (e.g. you want a float to be greater than 5, 4.512313 is not valid but length(4.512314) > length(5) is, so the pattern will succeed). In this case, the value should be set to null with a MEDIUM_CONFIDENCE.

guessPattern() メソッドの使用には細心の注意を払う必要があります。タイプがフロートの場合、それを使用してフロートの最小値または最大値を決定することはできません (たとえば、フロートを 5 より大きくしたい場合、4.512313 は有効ではありませんが、長さ (4.512314) > 長さ (5) であるため、パターンは成功した)。この場合、値は MEDIUM_CONFIDENCE で null に設定する必要があります。

Registering a Type Guesser

If you're using autowire and autoconfigure, you're done! Symfony already knows and is using your form type guesser.

autowire と autoconfigure を使用している場合は、これで完了です。 symfony はすでにあなたのフォームタイプゲッサーを知っていて、それを使用しています。

If you're not using autowire and autoconfigure, register your service manually and tag it with form.type_guesser:

autowire と autoconfigure を使用していない場合は、サービスを手動で登録し、form.type_guesser でタグ付けします。
  • YAML
    YAML
  • XML
    XML
  • PHP
    PHP
1
2
3
4
5
6
# config/services.yaml
services:
    # ...

    App\Form\TypeGuesser\PHPDocTypeGuesser:
        tags: [form.type_guesser]
コンポーネントに型ゲッサーを登録する

If you're using the Form component standalone in your PHP project, use addTypeGuesser() or addTypeGuessers() of the FormFactoryBuilder to register new type guessers:

PHP プロジェクトでスタンドアロンの Form コンポーネントを使用している場合は、FormFactoryBuilder の addTypeGuesser() または addTypeGuessers() を使用して、新しい型ゲッサーを登録します。
1
2
3
4
5
6
7
8
9
use App\Form\TypeGuesser\PHPDocTypeGuesser;
use Symfony\Component\Form\Forms;

$formFactory = Forms::createFormFactoryBuilder()
    // ...
    ->addTypeGuesser(new PHPDocTypeGuesser())
    ->getFormFactory();

// ...

Tip

ヒント

Run the following command to verify that the form type guesser was successfully registered in the application:

次のコマンドを実行して、フォーム タイプ ゲッサーがアプリケーションに正常に登録されたことを確認します。
1
$ php bin/console debug:form