Quels sont les attributs (annotations) dans PHP 8?

Les attributs PHP 8 ajoutent des métadonnées aux éléments de code de manière structurée. 1. Ils sont attachés au-dessus des classes, des méthodes, etc. en utilisant la syntaxe # [], telle que # [Route ('/ home')] pour définir les itinéraires; 2. Il est plus sûr que PHPDOC, avec la vérification de type et la vérification du temps de compilation; 3. Les attributs personnalisés doivent définir des classes et s'appliquer, tels que l'utilisation de ReflectionAttribute pour créer des attributs de journal LOGEXECUTION; 4. Couramment utilisé dans les cadres pour gérer le routage, la vérification, la cartographie ORM et d'autres tâches, l'amélioration de la lisibilité du code et la séparation des configurations logiques; 5. Il est accessible par réflexion, mais une utilisation excessive doit être évitée pour éviter d'affecter la clarté du code.

PHP 8 a introduit une nouvelle fonctionnalité puissante appelée Attributs (également appelée annotations dans d'autres langues comme Java ou Python). Ils fournissent un moyen structuré et réutilisable d'ajouter des métadonnées aux classes, méthodes, propriétés, fonctions, etc. - toutes directement dans le code à l'aide d'une syntaxe propre.

En bref, les attributs vous permettent de "joindre" des informations supplémentaires à vos éléments de code sans affecter leur logique. Cela peut être utilisé pour des choses comme le routage dans les cadres, les règles de validation, les mappages ORM, etc.

À quoi ressemblent les attributs?

Les attributs sont écrits à l'aide de la syntaxe #[AttributeName] placée au-dessus de l'élément qu'ils annotent. Voici un exemple de base:

 # [Route ('/ home')]
fonction home () {
    Echo «Bienvenue!»;
}

Dans ce cas, #[Route('/home')] est un attribut qui indique une partie de l'application (comme un routeur) comment gérer la fonction home() .

Vous pouvez également utiliser plusieurs attributs:

 # [Cacheable]
# [Méthode ('get')]
fonction getData () {
    return fetchData ();
}

Chaque attribut peut avoir des arguments qui lui sont transmis, tout comme les appels de fonction. La signification exacte de ces arguments dépend de ce que fait l'attribut.

En quoi les attributs sont-ils différents de PHPDOC?

Avant les attributs, les développeurs ont souvent utilisé des commentaires PHPDOC pour atteindre des objectifs similaires:

 / **
 * @Route ("/ home")
 * @Method ("Get")
 * /
fonction home () {
    // ...
}

Alors que PHPDOC fonctionne, il a des limites:

• Ce n'est pas un type de type - tout est une chaîne.
• Il n'y a aucune application de l'utilisation correcte.
• Vous devez analyser les commentaires manuellement ou avec des outils.

Les attributs résolvent ces problèmes en faisant partie de la syntaxe linguistique. Ils sont validés au moment de la compilation, prennent en charge le typage approprié et sont plus faciles à traiter par programme.

Comment définir et utiliser des attributs personnalisés

La création de votre propre attribut implique deux étapes: définir la classe d'attribut et l'appliquer quelque part.

Étape 1: Définissez la classe d'attribut

Utilisez la classe Attribute fournie par PHP (à partir de l'API ReflectionAttribute ):

 Utiliser l'attribut;

#[Attribut]
classe LOGEXECUTION {
    fonction publique __construct (
        public string $ message = 'fonction exécutée'
    ) {}
}

Cela définit un attribut qui peut être attaché à n'importe quel élément.

Étape 2: Appliquez l'attribut

Appliquez-le maintenant à une fonction:

 # [LOGEXECUTION (Message: «Fonction de connexion utilisateur»)]
Fonction LoginUser (String $ username) {
    Echo "Connexion à $ nom d'utilisateur \ n";
}

Ensuite, en utilisant la réflexion, vous pouvez lire l'attribut et faire quelque chose d'utile - comme enregistrer le message après l'exécution de la fonction.

Où sont les attributs couramment utilisés?

Les frameworks et les bibliothèques utilisent fortement les attributs car ils permettent une séparation propre entre la logique métier et la configuration.

Voici quelques cas d'utilisation courants:

• Routage - cartographie des URL vers les méthodes du contrôleur
• Validation - Spécification des contraintes de données pour les formulaires ou les API
• Sérialisation / désérialisation - Contrôlant comment les objets sont convertis en JSON ou XML
• Injection de dépendance - Services de marquage ou points d'injection
• ORMS - Tableaux et colonnes de base de données de cartographie vers les classes et les propriétés

Par exemple, dans Symfony ou Laravel, vous pourriez voir quelque chose comme:

 # [Route ('/ Users / {id}', méthodes: ['get'])]
Fonction publique Show (int $ id) {
    Utilisateur de retour :: find ($ id);
}

Cela indique au framework comment acheminer les demandes HTTP entrantes à cette méthode.

Quelques choses à garder à l'esprit

• Les attributs peuvent cibler des éléments de code spécifiques à l'aide de drapeaux lors de leur définition. Par exemple, pour permettre une utilisation sur les fonctions:

   # [Attribut (attribut :: cible_function)]

• Vous pouvez accéder aux attributs via la réflexion ( ReflectionClass , ReflectionMethod , etc.) pour lire et agir sur eux.

• Bien que les attributs soient très flexibles, les exagérer peut rendre votre code plus difficile à suivre s'il n'est pas bien organisé.

• Tous les projets n'ont pas besoin d'attributs personnalisés - mais ils sont super pratiques dans des applications ou des cadres plus importants.

---

Alors oui, les attributs de PHP 8 nous donnent une façon moderne, propre et puissante de travailler avec des métadonnées dans notre code. Ils ne sont pas difficiles à comprendre une fois que vous voyez comment ils s'intègrent dans des exemples du monde réel - et ils ont définitivement battu les commentaires d'analyse à la main.

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!