Pourquoi utiliser des commentaires?
- Si vous ne travaillez pas sur le code source pendant un certain temps, il est facile d'oublier ce que fait le code. Commenter le code source permet de se souvenir de ce que fait le code.
- Le commentaire du code source est également très important lorsque plusieurs développeurs doivent travailler sur le même projet. Les modifications apportées par un développeur peuvent être facilement comprises par d'autres développeurs en lisant simplement les commentaires.
- Comme meilleure pratique, vous devez avoir 3 lignes de commentaires pour 10 lignes de code
Dans ce didacticiel, vous apprendrez-
- Commentaires PHP
- Inclure PHP et PHP Include_once
- Exemple: Include / Include_once
- PHP Require & PHP require_once
- Exemple: exiger
- PHP inclure vs exiger
Commentaires PHP
- Les commentaires nous aident à comprendre le code
- Les commentaires sont des explications que nous incluons dans notre code source. Ces commentaires sont destinés à la compréhension humaine.
- Les commentaires sur une seule ligne commencent par des doubles barres obliques // et se terminent sur la même ligne.
- Les commentaires sur plusieurs lignes commencent par une barre oblique suivie de l'astérisque / * et se terminent par l'astérisque suivi de la barre oblique * /.
Le diagramme ci-dessous montre un fichier PHP avec des commentaires sur plusieurs lignes et sur une seule ligne Exemple PHP
Inclure PHP et PHP Include_once
L'instruction php «include» est utilisée pour inclure d'autres fichiers dans un fichier PHP.
Il a deux variantes, include et include_once. Include_once est ignoré par l'interpréteur PHP si le fichier à inclure.
L'instruction include a la syntaxe suivante
L'instruction include_once a la syntaxe suivante
ICI,
- «Include / include_once» est l'instruction qui inclut le fichier
- «'File_name'» est le nom du fichier à inclure.
Exemple: Include / Include_once
Supposons que vous développiez un site Web contenant le même menu de navigation sur toutes les pages.
Vous pouvez créer un en-tête commun puis l'inclure dans chaque page à l'aide de l'instruction include Voyons comment cela peut être fait.
- Nous allons créer 2 noms de fichiers
- header.php, index.php
Voici les codes pour; header.php
HomeAbout usServicesContact Us
index.php
La page d'en-tête ci-dessus affichera
PHP Require & PHP require_once
L'instruction require a deux variantes, require et require_once.
L'instruction require / require_once est utilisée pour inclure le fichier.
Require_once est ignoré si le fichier requis a déjà été ajouté par l'une des quatre instructions include.
Il a la syntaxe suivante
ICI,
- «Require / require_once» est l'instruction qui inclut le fichier
- «'File_name'» est le nom du fichier à inclure.
Exemple: exiger
Supposons que nous développions une application basée sur une base de données.
Nous pouvons créer un fichier de configuration que nous pouvons inclure dans toutes les pages qui se connectent à la base de données à l'aide de l'instruction require. config.php
Regardons maintenant l'exemple de code qui nécessite le fichier de configuration. Pages_model.php
PHP comprend vs nécessite
La différence entre include / require
| Comprendre | Exiger |
|---|---|
| Émet un avertissement lorsqu'une erreur se produit | N'émet pas d'avertissement |
| L'exécution du script se poursuit lorsqu'une erreur se produit | L'exécution du script s'arrête lorsqu'une erreur se produit. |
En règle générale, il est recommandé d'utiliser l'instruction include afin qu'en cas d'erreur, l'exécution du script continue d'afficher l'adresse e-mail du webmaster ou la page de contact.
L'instruction require doit être utilisée si le script entier ne peut pas s'exécuter sans le fichier demandé.
Les instructions «include» et «require» peuvent être utilisées à n'importe quelle ligne des codes source où vous voulez que le code apparaisse.
Résumé
- Un code HTML unique tel que des en-têtes, des pieds de page, des barres latérales, etc. peut être partagé sur plusieurs pages. Cela facilite la mise à jour du site Web en mettant simplement à jour un seul fichier.
- Le code PHP tel que les paramètres de configuration de la base de données, les fonctions personnalisées, etc. peut être partagé sur de nombreuses pages, garantissant que le site Web / l'application utilise les mêmes paramètres.
- Les commentaires sont utilisés pour aider à comprendre le code source. Ils sont pour la compréhension humaine
- Les instructions de commentaire sur une seule ligne commencent par des doubles barres obliques //.
- Les instructions de commentaires sur plusieurs lignes sont placées entre / * instructions * /.
- Les instructions «include, include_once, require et require_once» sont utilisées pour inclure des fichiers.
- Include_once / require_once est ignoré si le fichier demandé a déjà été inclus à l'aide de l'une des quatre instructions.
- L'instruction «include» émet un avertissement et continue l'exécution si le fichier demandé n'a pas été trouvé.
- L'instruction require déclenche une erreur fatale et arrête l'exécution du script.
- L'instruction «include» doit être dans la plupart des cas, sauf dans les situations où sans le fichier demandé à inclure, le script entier ne peut pas s'exécuter.