Comprendre les nouvelles fonctionnalités de PHP 8, Annotations d'attributs

La version Alpha de PHP8 sortira dans quelques jours. Elle contient de nombreuses nouvelles fonctionnalités. Bien sûr, je pense que la plus importante est JIT, que j'ai démarré en 2013. Après. En participant, il y a eu de nombreux revers et échecs, et finalement quelque chose a été publié.

Cependant, aujourd'hui, je ne vais pas parler de JIT après la sortie de PHP8, j'écrirai une série distincte similaire à "Compréhension approfondie de JIT en PHP8".

Hé, aujourd'hui, je veux parler des attributs. Pourquoi ? Hier, j'ai vu de nombreux groupes transmettre un article intitulé "Comprendre les attributs en PHP8". l'écriture était difficile à comprendre. Après l'avoir lu, de nombreux étudiants ont déclaré qu'ils étaient confus et n'avaient aucune idée de ce dont ils parlaient.

Alors j'ai pensé que j'utiliserais un article pour expliquer brièvement ce que c'est.

Avant de parler des annotations, parlons des annotations précédentes. On voit souvent quelque chose comme les @param et @see suivants dans les projets PHP :

/**
 * @param Foo $argument
 * @see https:/xxxxxxxx/xxxx/xxx.html
 */    
 function dummy($Foo) {}

Cela s'appelle Commentaires, pour les PHP précédents, le @param et @see dans les commentaires n'ont aucun sens et le paragraphe entier sera enregistré sous la forme d'une chaîne appelée doc_comment d'une fonction/méthode.

Si nous voulons analyser la signification de ce commentaire, nous devons concevoir une syntaxe spécifique, telle que @+name dans Lili, similaire à @param, puis analyser nous-mêmes cette chaîne pour extraire les informations correspondantes.

Par exemple, si nous voulons obtenir les informations de l'annotation See, nous devons effectuer un traitement de chaîne comme :

$ref = new ReflectionFunction("dummy");
$doc = $ref->getDocComment();
$see = substr($doc, strpos($doc, "@see") + strlen("@see "));

, ce qui est relativement gênant et sujet aux erreurs.

En ce qui concerne les attributs, il met en fait à niveau les « annotations » en « annotations » qui prennent en charge le contenu formaté

Par exemple, dans l'exemple ci-dessus :

<<Params("Foo", "argument")>>
<<See("https://xxxxxxxx/xxxx/xxx.html")>>
function dummy($argument) {}

Ne vous souciez pas du sens d'écrire de cette façon. D'un point de vue fonctionnel, vous pouvez désormais obtenir cette annotation formatée via Reflection. Par exemple, nous souhaitons maintenant obtenir l'annotation See :

$ref = new ReflectionFunction("dummy");
 
var_dump($ref->getAttributes("See")[0]->getName());
var_dump($ref->getAttributes("See")[0]->getArguments());

will. be output :

string(3) "See"
array(1) {
  [0]=>
  string(30) "https://xxxxxxxx/xxxx/xxx.html"
}

Bien sûr, il existe une utilisation légèrement plus avancée, c'est-à-dire que vous pouvez définir ce qu'on appelle une "classe d'annotation":

<?php
<<phpAttribute>>
class MyAttribute {
     public function __construct($name, $value) {
          var_dump($name);
          var_dumP($value);
     }
}

Ensuite, vous pouvez écrire quelque chose comme , faites attention à l'appel newInstance qu'il contient :

<<MyAttribute("See", "https://xxxxxxxx/xxxx/xxx.html")>>
function dummy($argument) {
}
$ref = new ReflectionFunction("dummy");
 
$ref->getAttributes("MyAttribute")[0]->newInstance();

Si vous exécutez ce code, vous verrez que la méthode __construct de MyAttribute est appelée et que les paramètres passés dans l'appel sont "See" et "https : //xxx"

Comprenez-vous ? Vous pouvez "instancier" une annotation, puis créer votre propre conception "d'annotation en tant que configuration" basée sur cette fonctionnalité. Pour résumer, Attributs est écrit sous la forme suivante :

<<Name>>
<<Name(Arguments)>>
<<Name(Argunment1, Arguments2, ArgumentN)>>
 
<<Name1(Argument), Name2(Argument), Name3(Argument)>>

Ensuite, vous pouvez utiliser les méthodes de la série Reflection de PHP pour obtenir les annotations correspondantes basées sur getAttributes (« Nom »). La méthode getName obtient le nom et la méthode getArguments obtient les arguments entre parenthèses.

De plus, si Name est une classe que vous définissez vous-même avec l'annotation phpAttriubtes, vous pouvez également appeler la méthode newInstance pour implémenter un appel similaire à "new Name (Arguments)".

Beaucoup de gens peuvent se demander, à quoi ça sert ?

Pour être honnête, je n'ai jamais été intéressé par les nouvelles fonctionnalités, mais ces attributs devraient quand même en avoir un petit peu.

Article recommandé : "PHP8.0"

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!