Apprendre les annotations PHP

La fonction d'annotation est très puissante

La soi-disant annotation peut être expliquée en chinois par : annotation. Plus précis.
Parce que le code est en anglais et qu'il est très long, les gens l'oublieront après longtemps.
Nous ajouterons donc une annotation.

L'annotation a de nombreuses fonctions :

1. Marquez les points clés

2. Il est facile d'oublier de se rappeler rapidement après une longue période, ce qui facilite la recherche

3. Laissez les autres comprendre rapidement lorsqu'ils le lisent

4. Vous pouvez également générer des documents une fois le code écrit, les documents pertinents sont terminés, améliorant ainsi l'efficacité du travail

. 5. Commentaires, lignes vides et retours chariot Le code suivant sera plus beau

6. Les commentaires peuvent être utilisés pour le dépannage. Si vous n'êtes pas sûr de quelle partie du code est fausse, vous pouvez commenter une grande section pour déterminer la plage d'erreur

7. Commentez le contenu au milieu, l'ordinateur ne l'exécutera pas

Laissez-moi vous le donner d'abord. Jetez un œil au code que nous pensons beau, soigné, standardisé, clairement expliqué et facile à comprendre en un coup d'œil. (Vous n'avez pas besoin de comprendre le sens du code) :

Regardez le code qu'on trouve moche, sans parler de l'alignement et de la laideur, et là n'est pas une description fonctionnelle (vous n'avez pas besoin de comprendre la signification du code) ) :

Nous comprenons les avantages des commentaires. Parlons ensuite des commentaires PHP. Les commentaires sont :

• Commentaires sur une seule ligne (commentaires sur une seule ligne)

• Multi-lignes commentaires (commentaires sur plusieurs lignes)

• Commentaires sur une seule ligne

//   表示单行注释
#    #号也表示单行注释，用的比较少

• Commentaires sur plusieurs lignes

/* 
多行注释 这里是注释区域代码
 */

Exemple de commentaires sur une seule ligne :

<?php

//声明一部iphone6手机的价格变量
$iphone6_price = 6088;

//显示输出手机价格
echo $iphone6_price;
?>

Remarque : à partir de l'exemple ci-dessus, nous savons que les commentaires sont généralement écrits au-dessus du code.

Exemple de commentaires multilignes :

<?php
/*
作者：PHP中文网
时间：2048.12.23
功能：这是一个假的多行注释的例子
*/

/*
  声明一个爱情变量
  $love 是指爱情
  爱情是一个变量，因为人的爱总是在发生变化
  所以，爱情变量的值为250
*/
$love = 250;

?>

Remarque : Grâce à l'exemple ci-dessus, nous avons constaté que lorsque nous devons écrire beaucoup de commentaires, utilisez des commentaires multilignes.

Remarque : je n'expliquerai pas comment générer des commentaires via des outils spéciaux pour l'instant