Maison php教程 php手册 Spécifications de la syntaxe des commentaires PHP et conventions de dénomination

Spécifications de la syntaxe des commentaires PHP et conventions de dénomination

May 16, 2016 am 09:00 AM
php注释

Les commentaires sont très importants dans le processus d'écriture de code. De bons commentaires peuvent rendre votre code plus facile à lire. Lors de l'écriture de code, vous devez faire attention aux spécifications des commentaires. Ici, l'éditeur de Script House le triera pour vous. Les amis dans le besoin peuvent s'y référer.

Spécification des commentaires HP

Les commentaires sont très importants dans le processus d'écriture de code. De bons commentaires peuvent rendre votre code plus facile à lire lors de l'écriture. code, veillez à faire attention à la spécification des commentaires.

« PHP est un langage extrêmement simple avec lequel débuter. Un novice qui vient de commencer pourra peut-être utiliser echo pour imprimer un bonjour tout le monde en moins de quelques minutes ! Comment faire ? Qu'en est-il de la définition d'un programmeur ? Si vous voulez vraiment devenir un programmeur, vous devez suivre un ensemble de normes d'écriture de programmes "

Nous écrivons souvent certaines fonctions, mais ces fonctions peuvent seulement être comprises. par nous-mêmes, et même Cela fait un moment que je n'ai pas reconnu ce que j'ai écrit, alors que dois-je faire ? Le meilleur moyen est bien sûr d’ajouter des commentaires à votre code.

Nous connaissons peut-être de nombreuses façons d'écrire des commentaires, des commentaires C pear PHP, etc., mais les principales que nous utilisons sont # et /**/.

# est une méthode de commentaire court. Peut-être que vous l'utiliserez pour annoter une variable ou appeler une méthode. /**/. Nous pouvons toujours l'utiliser pour commenter. une grande section de code, mais comment l'utiliser pour annoter une fonction de manière standard ?

/**
* @name 名字
* @abstract 申明变量/类/方法
* @access 指明这个变量、类、函数/方法的存取权限
* @author 函数作者的名字和邮箱地址
* @category 组织packages
* @copyright 指明版权信息
* @const 指明常量
* @deprecate 指明不推荐或者是废弃的信息
* @example 示例
* @exclude 指明当前的注释将不进行分析,不出现在文挡中
* @final 指明这是一个最终的类、方法、属性,禁止派生、修改。
* @global 指明在此函数中引用的全局变量
* @include 指明包含的文件的信息
* @link 定义在线连接
* @module 定义归属的模块信息
* @modulegroup 定义归属的模块组
* @package 定义归属的包的信息
* @param 定义函数或者方法的参数信息
* @return 定义函数或者方法的返回信息
* @see 定义需要参考的函数、变量,并加入相应的超级连接。
* @since 指明该api函数或者方法是从哪个版本开始引入的
* @static 指明变量、类、函数是静态的。
* @throws 指明此函数可能抛出的错误异常,极其发生的情况
* @todo 指明应该改进或没有实现的地方
* @var 定义说明变量/属性。
* @version 定义版本信息
*/
Copier après la connexion

Les informations contenues dans les annotations sont très complètes. Il peut y avoir beaucoup d'informations que nous n'utilisons pas. Les parties rouges sont celles que nous utilisons souvent.

Exemple : Plusieurs méthodes de commentaires courantes en php :

1. Commentaires sur le fichier, introduisant le nom du fichier, la fonction, le numéro de version de l'auteur et d'autres informations

/**
* 文件名简单介绍
* 
* 文件功能
* @author 作者
* @version 版本号
* @date 2020-02-02
*/
Copier après la connexion

Modèle d'en-tête de fichier

/** 
*这是一个什么文件 
* 
*此文件程序用来做什么的(详细说明,可选。)。 
* @author   richard<e421083458@163.com> 
* @version   $Id$ 
* @since    1.0 
*/
Copier après la connexion

2. Commentaires de classe, nom de classe et introduction

/**
* 类的介绍
* 
* 类的详细介绍(可选)
* @author 作者
* @version 版本号
* @date 2020-02-02
*/
Copier après la connexion
/** 
* 类的介绍 
* 
* 类的详细介绍(可选。)。 
* @author     richard<e421083458@163.com> 
* @since     1.0 
*/ 
class Test  
{ 
}
Copier après la connexion

3. Commentaires de fonction, fonction, introduction de paramètre et type de retour

/**
* 函数的含义说明
* 
* @access public 
* @author 作者
* @param mixed $arg1 参数一的说明 
* @param mixed $arg2 参数二的说明
* @return array 返回类型
* @date 2020-02-02
*/
Copier après la connexion

Commentaires d'en-tête de fonction

/** 
* some_func 
* 函数的含义说明 
* 
* @access public 
* @param mixed $arg1 参数一的说明 
* @param mixed $arg2 参数二的说明 
* @param mixed $mixed 这是一个混合类型 
* @since 1.0 
* @return array 
*/ 
public function thisIsFunction($string, $integer, $mixed) {return array();}
Copier après la connexion

Commentaires sur le code du programme

1 Le principe des commentaires est de poser le problème Expliquez. il est clair que plus n’est pas toujours mieux.

2. Plusieurs instructions sont utilisées comme bloc de code logique, et les commentaires de ce bloc peuvent être /* */.

3. Pour les commentaires spécifiques à une certaine déclaration, vous pouvez utiliser des commentaires de fin de ligne : //.

/* 生成配置文件、数据文件。*/ 
 
$this->setConfig(); 
$this->createConfigFile(); //创建配置文件 
$this->clearCache();     // 清除缓存文件 
$this->createDataFiles();  // 生成数据文件 
$this->prepareProxys(); 
$this->restart();
Copier après la connexion

Convention de dénomination PHP

1. Répertoires et fichiers

Utiliser des lettres minuscules. pour les répertoires + soulignement
Bibliothèque de classes, les fichiers de fonctions sont uniformément suffixés par .php
Les noms de fichiers de classe sont définis dans les espaces de noms, et le chemin de l'espace de noms est cohérent avec le chemin du fichier de bibliothèque de classes
Fichiers de classe sont nommés en majuscule (la première lettre est en majuscule), les autres fichiers sont nommés en minuscules + souligné
Le nom de la classe et le nom du fichier de classe sont cohérents et la méthode de la casse en chameau est uniformément utilisée (la première lettre est en majuscule)

2. Fonctions et classes, dénomination des attributs

Les classes sont nommées en utilisant la casse camel (la première lettre est en majuscule), comme User, UserType Par défaut, aucun suffixe n'est requis. Par exemple, UserController doit être directement nommé User
Les fonctions sont nommées en utilisant des lettres minuscules et des traits de soulignement (commençant par une lettre minuscule). Par exemple, le nom de la méthode get_client_ip
utilise la casse camel (la première lettre est en minuscule), comme getUserName (si la méthode a une valeur de retour, il est actuellement d'usage d'utiliser la première lettre en minuscule pour le type d'attribut, comme s(string), i(int ), f (float), b (boolean), a (tableau), etc.)
La dénomination des attributs utilise la casse chameau (la première lettre est minuscule), comme tableName, instance (il est actuellement d'usage d'utiliser des minuscules pour la première lettre des types d'attributs, comme s (string), i (int), f (float), b (boolean), a (array), etc.)
Les fonctions ou méthodes commençant par un double trait de soulignement "__" sont utilisées comme méthodes magiques, telles que __call et _ _autoload

3. Constantes et configurations

Les constantes sont nommées avec des lettres majuscules et des traits de soulignement, tels que APP_PATH et THINK_PATH
Les paramètres de configuration sont nommés avec des lettres minuscules et des traits de soulignement, tels que url_route_on et url_convert

4. Champs de la zone de table de données

Les tables et champs de données sont nommés en minuscules et soulignés, et veillez à ne pas commencer le nom du champ par un trait de soulignement, comme think_user table et user_name field. . Il n'est pas recommandé d'utiliser la casse camel et le chinois pour la dénomination des champs.

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

Outils d'IA chauds

Undresser.AI Undress

Undresser.AI Undress

Application basée sur l'IA pour créer des photos de nu réalistes

AI Clothes Remover

AI Clothes Remover

Outil d'IA en ligne pour supprimer les vêtements des photos.

Undress AI Tool

Undress AI Tool

Images de déshabillage gratuites

Clothoff.io

Clothoff.io

Dissolvant de vêtements AI

AI Hentai Generator

AI Hentai Generator

Générez AI Hentai gratuitement.

Article chaud

R.E.P.O. Crystals d'énergie expliqués et ce qu'ils font (cristal jaune)
2 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
Repo: Comment relancer ses coéquipiers
4 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
Hello Kitty Island Adventure: Comment obtenir des graines géantes
4 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
Combien de temps faut-il pour battre Split Fiction?
3 Il y a quelques semaines By DDD

Outils chauds

Bloc-notes++7.3.1

Bloc-notes++7.3.1

Éditeur de code facile à utiliser et gratuit

SublimeText3 version chinoise

SublimeText3 version chinoise

Version chinoise, très simple à utiliser

Envoyer Studio 13.0.1

Envoyer Studio 13.0.1

Puissant environnement de développement intégré PHP

Dreamweaver CS6

Dreamweaver CS6

Outils de développement Web visuel

SublimeText3 version Mac

SublimeText3 version Mac

Logiciel d'édition de code au niveau de Dieu (SublimeText3)

Commentaires PHP révélés : comparaison détaillée des commentaires sur une seule ligne et des commentaires sur plusieurs lignes Commentaires PHP révélés : comparaison détaillée des commentaires sur une seule ligne et des commentaires sur plusieurs lignes Mar 15, 2024 pm 12:51 PM

Le secret des commentaires PHP : comparaison détaillée des commentaires sur une seule ligne et des commentaires sur plusieurs lignes PHP est un langage de développement Web largement utilisé, dans lequel l'utilisation de commentaires joue un rôle essentiel dans la lisibilité et la maintenabilité du code. En PHP, les commentaires courants se présentent sous deux formes : les commentaires sur une seule ligne et les commentaires sur plusieurs lignes. Cet article comparera ces deux formulaires d'annotation en détail et fournira des exemples de code spécifiques pour aider les lecteurs à mieux comprendre leur utilisation et leurs différences. 1. Commentaires sur une seule ligne Un commentaire sur une seule ligne consiste à ajouter une ligne de commentaires dans le code, commençant par // et allant jusqu'à la fin de la ligne. Commentaires sur une seule ligne

Quels sont les types de commentaires php ? Quels sont les types de commentaires php ? Aug 23, 2023 pm 01:46 PM

Les types de commentaires PHP incluent les commentaires sur une seule ligne, les commentaires sur plusieurs lignes, les commentaires sur les documents, les commentaires conditionnels, etc. Introduction détaillée : 1. Un commentaire sur une seule ligne commence par une double barre oblique "//" et est utilisé pour commenter une seule ligne de code. Dans ce type de commentaire, tout depuis le début de la double barre oblique jusqu'à la fin de la ligne sera. considéré comme un commentaire, et non Sera interprété comme du code ; 2. Les commentaires multilignes commencent par un astérisque "/" et se terminent par un astérisque "*/". Ce type de commentaire peut être utilisé pour commenter un morceau de code ou. plusieurs lignes de code ; 3. Commentaires sur la documentation Il commence également par une barre oblique "/", se termine par une barre oblique "*/", et ainsi de suite.

Commentaires de code en PHP Commentaires de code en PHP May 23, 2023 am 08:27 AM

Les commentaires de code sont des rappels textuels que les programmeurs ajoutent lors de l’écriture du code pour faciliter la lecture et la compréhension du code par eux-mêmes et par les autres programmeurs. En PHP, les commentaires de code sont indispensables. Cet article présentera en détail les types, spécifications et utilisations des commentaires de code en PHP. 1. Types de commentaires de code en PHP En PHP, il existe trois types de commentaires : les commentaires sur une seule ligne, les commentaires sur plusieurs lignes et les commentaires de documentation. Commentaires sur une seule ligne Un commentaire sur une seule ligne commence par une double barre oblique "//" et se termine à la fin de la ligne. Par exemple : //Il s'agit d'un commentaire sur une seule ligne. Commentaire sur plusieurs lignes. Le commentaire sur plusieurs lignes se termine par "

Quels sont les types de commentaires en php Quels sont les types de commentaires en php Jul 25, 2023 pm 02:26 PM

Les types de commentaires en PHP sont : 1. Les commentaires sur une seule ligne, utilisés pour expliquer une certaine fonction, rappeler aux autres développeurs ou à vous-même d'y prêter attention, etc. 2. Les commentaires sur plusieurs lignes, utilisés pour expliquer les blocs de code sur plusieurs lignes dans détail; 3. Commentaires sur le document, utilisés pour fournir une description détaillée de l'ensemble du bloc de code, de la fonction ou de la méthode.

Un examen plus approfondi des commentaires PHP : la différence entre les commentaires sur une seule ligne et sur plusieurs lignes Un examen plus approfondi des commentaires PHP : la différence entre les commentaires sur une seule ligne et sur plusieurs lignes Mar 15, 2024 pm 05:15 PM

Lorsqu’on entre dans le domaine de la programmation PHP, les commentaires sont un concept très important. Lors de l'écriture du code, les commentaires sont cruciaux pour clarifier l'intention du code, aider les autres développeurs à comprendre la logique du code et vous faciliter la maintenance du code à l'avenir. En PHP, les commentaires sont divisés en commentaires sur une seule ligne et en commentaires sur plusieurs lignes, et il existe quelques différences d'utilisation. Cet article explorera en profondeur les caractéristiques des commentaires PHP et l'utilisation de commentaires sur une seule ligne et de commentaires sur plusieurs lignes, et l'illustrera à travers des exemples de code spécifiques. 1. Commentaires sur une seule ligne Un commentaire sur une seule ligne consiste à ajouter une ligne de commentaires au code pour expliquer

Spécification des commentaires PHP : Comment utiliser les commentaires de la documentation pour rédiger la documentation de l'API Spécification des commentaires PHP : Comment utiliser les commentaires de la documentation pour rédiger la documentation de l'API Jul 30, 2023 pm 07:00 PM

Spécification des commentaires PHP : Comment utiliser les commentaires de documentation pour rédiger la documentation de l'API Introduction : Lors du développement d'applications PHP, la rédaction d'une documentation API complète est très importante pour l'équipe de développement et les autres développeurs. Une bonne documentation améliore la lisibilité et la maintenabilité du code, et favorise le travail d'équipe et le partage d'informations. Cet article explique comment utiliser les commentaires de documentation pour rédiger la documentation de l'API PHP et fournit des exemples de code pour aider les lecteurs à comprendre comment rédiger des commentaires de manière standardisée. Spécification des commentaires En PHP, nous utilisons des commentaires pour expliquer et décrire le code. en général

Comment utiliser les commentaires en PHP pour améliorer la lisibilité et la compréhensibilité du code Comment utiliser les commentaires en PHP pour améliorer la lisibilité et la compréhensibilité du code Jul 15, 2023 pm 09:27 PM

Comment utiliser les commentaires en PHP pour améliorer la lisibilité et la compréhensibilité du code Introduction : Au cours du processus de développement, les commentaires sont un composant très important qui peut aider les développeurs à mieux comprendre le code et à améliorer la lisibilité et la maintenabilité du code. Cet article expliquera comment utiliser les commentaires en PHP pour améliorer la lisibilité et la compréhensibilité du code, et fournira quelques exemples de code pratiques. Commentaires sur une seule ligne Les commentaires sur une seule ligne sont utilisés pour expliquer et illustrer une certaine ligne de code. En PHP, les commentaires sur une seule ligne commencent par des doubles barres obliques (//) et se terminent à la fin de la ligne. Voici un exemple

Explication détaillée des types de commentaires PHP : commentaires sur une seule ligne et commentaires sur plusieurs lignes Explication détaillée des types de commentaires PHP : commentaires sur une seule ligne et commentaires sur plusieurs lignes Mar 15, 2024 pm 05:27 PM

PHP est un langage de script côté serveur populaire largement utilisé dans le domaine du développement Web. Dans le processus d'écriture de code, les commentaires sont un élément très important, qui peuvent aider les développeurs à mieux comprendre le code et à améliorer la lisibilité et la maintenabilité du code. Cet article présentera en détail les types de commentaires en PHP, y compris les commentaires sur une seule ligne et les commentaires sur plusieurs lignes, et fournira des exemples de code spécifiques. Commentaires sur une seule ligne En PHP, les commentaires sur une seule ligne peuvent être obtenus en utilisant des doubles barres obliques //. Les commentaires sur une seule ligne commencent par // et continuent jusqu'à la fin de la ligne. Les commentaires sur une seule ligne sont souvent utilisés pour commenter le code

See all articles