Comment puis-je spécifier des indications de type pour les tableaux d'objets dans PHPDoc ?

Spécification des indications de type pour les tableaux d'objets dans PHPDoc

Pour déclarer une balise PHPDoc pour un tableau d'objets, utilisez la syntaxe suivante :

@var array<\Fully\Qualified\Class\Name>

Par exemple :

  /** @var SomeObj[] */
  private $someObjInstances;

Cette syntaxe informe le IDE selon lequel la variable $someObjInstances est un tableau d'objets SomeObj. L'IDE fournira ensuite des informations de code appropriées et une vérification de type lorsque vous travaillerez avec cette variable.

Prise en charge de l'IDE

Notez que tous les IDE ne prennent pas en charge cette syntaxe pour les tableaux d'objets. Par exemple, PHPEd peut ne pas le reconnaître. Cependant, les IDE populaires comme PhpStorm et Visual Studio Code le prennent en charge immédiatement.

Syntaxe alternative

Dans PHP 8.1, une syntaxe alternative a été introduite pour spécifier le type d'éléments dans un tableau :

@var array{key: type, key: type, ...}

Pour exemple :

  /** @var array{object: SomeObj, string: string} */
  private $someObjsArray;

Cette syntaxe vous permet de spécifier les types de clés spécifiques au sein du tableau. C'est particulièrement utile lorsqu'il s'agit de tableaux associatifs.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!