Annotations PHP

PHPz
Libérer: 2024-08-29 13:02:09
original
528 Les gens l'ont consulté

Les annotations PHP sont essentiellement des métadonnées qui peuvent être incluses dans le code source ainsi qu'entre les classes, fonctions, propriétés et méthodes. Ils doivent commencer par le préfixe @ partout où ils sont déclarés et indiquent quelque chose de spécifique. Ces informations qu'ils fournissent sont très utiles aux codeurs, utiles à des fins de documentation et un IDE peut également les utiliser pour afficher certains types d'indices contextuels. La même annotation peut également être utilisée à d'autres fins que la validation, par exemple pour déterminer le type d'entrée à fournir dans un formulaire et également à des fins d'automatisation. Il existe différents types d'annotations comme les types @var et @int qui peuvent être utilisées pour des usages spécifiques comme leur nom lui-même l'indique.

PUBLICITÉ Cours populaire dans cette catégorie DEVELOPPEUR PHP - Spécialisation | Série de 8 cours | 3 tests simulés

Commencez votre cours de développement de logiciels libres

Développement Web, langages de programmation, tests de logiciels et autres

Syntaxe

Les annotations PHP sont utilisées en donnant le préfixe @ et sa syntaxe est la suivante :

class Example { // @var integer public $new; }
Copier après la connexion

L'annotation est @var ici et chaque fois qu'elle est rencontrée juste avant le morceau de code (public $new ici par exemple), elle indique que le $new doit avoir une valeur de type entier comme indiqué par l'annotation.

class Example { // @var integer // @range(0, 51) // @label('Count of shops') public $shop; }
Copier après la connexion

Les annotations peuvent également être utilisées pour spécifier la plage dans laquelle elles affiche les valeurs maximales et minimales qui doivent être acceptées comme valeurs entières pour la fonction et l'étiquette donne le but de cette fonction.

Types d'annotations PHP

Vous trouverez ci-dessous les types :

1. Annotations intégrées

Il existe 2 fonctions intégrées dans les annotations qui sont les suivantes :

a. Compilé :Cette annotation indique si la méthode/fonction doit être compilée JIT ou non. Il s'agit également d'un type d'annotation de portée de fonction.

b. SuppressWarnings :Il s'agit d'une autre annotation intégrée qui signifie que tous les avertissements émis dans le cadre de l'exécution du code suivant en dessous doivent être supprimés.

2. Méta-annotations

Ce sont ces types d'annotations qui peuvent être utilisées pour postuler à d'autres annotations. Ils sont utilisés pour la configuration des annotations.

a. @Annotations

Il existe une sorte de classes d'annotation qui contiendront @annotation.

Code :

[@Annotation] class MyAnnoExample { // piece of code }
Copier après la connexion

b. @Cible

Comme son nom l'indique, cette annotation indique les types d'éléments de classe ou une méthode sur lesquels l'annotation sera applicable.

Sur cela nous pouvons décrire une ou plusieurs cibles :

  • L'annotation de propriété se trouve juste avant la déclaration de la classe de propriété.
  • Classe autorisée avant la déclaration de classe.
  • La fonction est déclarée avant la déclaration de la fonction.
  • L'annotation de méthode permet de procéder à la déclaration de la méthode.
  • L'annotation est autorisée pour procéder à la déclaration de la classe d'annotation.

c. @Répétable

Cette annotation signifie qu'elle peut être répétée autant de fois qu'elle est utilisée.

d. @Hérité

Ceci peut également être utilisé sur les autres classes d'annotations définies par l'utilisateur en tant que méta-annotation. Ces annotations héritées sont automatiquement héritées des sous-classes respectives lorsqu'elles sont utilisées sur une superclasse.

3. Annotations personnalisées

Celles-ci sont très similaires aux déclarations de la classe normale. Chaque élément du type annotation est défini par chacune des déclarations de propriété.

Exemples d'annotations PHP

Vous trouverez ci-dessous les exemples mentionnés :

Exemple n°1

Code :

// namespace declaration here [@Annotation] [@Target("class")] class MyAnnoEx { [@Required] public string $prop; public array $arrayProp = []; public embedAnno $embed; } [@Annotation] // code for embedded annotation goes here [@Target(["class", "annotation"])] class embedAnno { } [@Annotation] // example for target annotation [@Target("property")] class propAnno { } @Annotation // code for method annotation goes here @Target("method") class methodAnno { public string $val; public function __construct(string $val) { $this->val = $val; } }
Copier après la connexion

Ceci n'est qu'un exemple de base montrant l'utilisation de tous les différents types d'annotations présentés ci-dessus. Tous ceux de l'exemple comme l'annotation intégrée, l'annotation de propriété, l'annotation de méthode sont des annotations personnalisées.

Exemple n°2

Code :

     
Copier après la connexion

Sortie:

Annotations PHP

Dans cet exemple, nous nommons l'annotation replace puisque le code ci-dessous représente l'utilisation de la fonction de remplacement de chaîne qui est str_replace, une fonction intégrée de PHP. Grâce à cette fonction, le premier paramètre passé dans la fonction est remplacé par le second.

Exemple #3

Code :

   Simple Form Processing 

Form Processing using PHP

First_Name: *

Last_Name: *

Stay location: *

EmailID: *

Password: *

Gender: Male Female

DETAILS RECEIVED
"; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo ""; echo "
ArgumentValue
First Name".$First_Name."
Last_Name".$last_name."
Stay location".$location."
Email Stay location" .$emailID."
Password".$password."
Gender".$gender."
"; } } ?>
Copier après la connexion

Sortie :

Annotations PHP

Dans cet exemple, nous affichons les annotations en combinaison avec la validation du formulaire en PHP. À l'aide d'annotations, nous étiquetons tous les paramètres requis comme paramètres d'entrée du formulaire, tels que le prénom et le nom, l'e-mail, l'emplacement et le mot de passe.

Conclusion

Avec les exemples ci-dessus, nous avons remarqué à quel point les annotations sont un outil puissant pour utiliser et exprimer des métadonnées sur nos méthodes, classes ou propriétés. Nous avons également vu comment combiner différents types d'annotations pour déclarer les travailleurs qui effectueront certaines tâches en écrivant des métadonnées à leur sujet. Cela les rend faciles à trouver et donne des informations réelles indiquant s'ils peuvent ou non être utilisés.

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!

Étiquettes associées:
php
source:php
Déclaration de ce site Web
Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn
Derniers téléchargements
Plus>
effets Web
Code source du site Web
Matériel du site Web
Modèle frontal
À propos de nous Clause de non-responsabilité Sitemap
Site Web PHP chinois:Formation PHP en ligne sur le bien-être public,Aidez les apprenants PHP à grandir rapidement!