PHP include_once

La fonction include_once en PHP consiste et effectue des opérations sur un fichier particulier lors de l'exécution du script. C'est donc la même chose que l'instruction include de PHP où le seul changement sera que si le script d'un autre fichier est déjà présent alors il ne l'inclura plus et cette fonction include_once ne renvoie que TRUE. Par conséquent, comme son nom l'indique, le fichier ici ne sera inclus qu'une seule fois.

Commencez votre cours de développement de logiciels libres

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

include_once est essentiellement utilisé là où le fichier unique peut être inclus et utilisé plus d'une fois lors de l'exécution du script, ce qui aidera à éviter différents problèmes tels que la réaffectation de valeurs de variables, la redéfinition de fonctions, etc. Cette fonction est également très similaire à la fonction require_once.

Syntaxe :

include_once('file name with its full path');

La syntaxe supérieure est explicite.

Exemples de fonction PHP include_once

Considérons que dans le code nous avons l'exigence de 2 fichiers différents comme le fichier p et le fichier q. Consultez la condition ci-dessous :

p : inclure m, inclure n

m : inclure n

n : echo "C'est la fonction a"

Ici, supposons que nous exécutions la fonction p, puis qu'elle inclut d'abord les fonctions m et n. Comme nous pouvons le voir ci-dessous, cette fonction m appelle également n, l'incluant donc. Par cela, nous pouvons déduire que n sera inclus deux fois, ce qui n’est pas approprié. Ainsi, en utilisant la fonction include_once, nous pouvons limiter son appel à une seule fois.

Par conséquent, include_once sera applicable dans les cas où supposons qu'il y ait 2 modèles et que l'un d'eux nécessite d'appeler un modèle de connexion à la base de données. Ici, l'inclure, à chaque fois, peut provoquer une erreur de duplication. Ainsi, en utilisant include_once, nous pouvons éviter la même chose qui est destinée à n'être incluse qu'une seule fois.

Exemples de PHP include_once

Voici les exemples donnés ci-dessous :

Exemple n°1

Code :

<?php
// First file displaying present date
echo "Finding the current date here \n";
echo "today is:".date("Y-m-d");
?>

Il s'agit du premier fichier que nous enregistrons sous un nom « Main.php » que nous appellerons dans notre prochain morceau de code.

<?php
include_once('Main.php');
include_once('Main.php');
?>

Sortie :

Nous utilisons la fonction include_once pour inclure notre fichier Main.php deux fois dans le code ci-dessus. Mais comme nous pouvons le voir dans la sortie, nous obtenons les données d'affichage d'écho une seule fois car la deuxième instance appelée est ignorée. En effet, la fonction include_once() ignore toutes les inclusions identiques à la première après son exécution.

Exemple n°2

Considérons qu'il y a 3 fichiers à exécuter comme ci-dessous :

FIRST_FUNCTION.php
SECOND_FUNCTION.php
THIRD_FUNCTION.php

Le code de FIRST_FUNCTION.php ressemble à celui-ci :

<?php
// declaring a function
function func(){
echo 'first function called';
}
?>

SECOND_FUNCTION.php :

<?php
// using include function to include the above function
include('FIRST_FUNCTION.PHP');
echo 'second function called';
func();
?>

THIRD_FUNCTION.php

<?php
include('FIRST_FUNCTION.PHP');
include('SECOND_FUNCTION.PHP');
func();
?>

Maintenant, lorsque ce THIRD_FUNCTION.php est exécuté, nous obtenons une erreur car le fichier SECOND_FUNCTION.php inclut déjà le FIRST_FUNCTION.php. L'erreur indiquera que la fonction func() a déjà été déclarée dans SECOND_FUNCTION.php et que nous l'avons déjà incluse dans THIRD_FUNCTION.php, ce qui signifie que nous avons déjà inclus FIRST_FUNCTION.php deux fois. Donc, pour nous assurer que nous n'utilisons FIRST_FUNCTION.php qu'une seule fois, nous devons utiliser la fonction include_once() afin que notre THIRD_FUNCTION.php puisse être modifié par celui comme ci-dessous :

<?php
// using include_once function
include_once('FIRST_FUNCTION.PHP');
include('SECOND_FUNCTION.PHP');
?>

Sortie :

Alors maintenant, lorsque nous exécuterons ce code, nous n'obtiendrons aucune erreur car PHP n'inclura le FIRST_FUNCTION.php qu'une seule fois pour éviter de générer une erreur. Par conséquent, dans de tels cas, il est nécessaire d'utiliser la fonction include_once() au lieu de la fonction include() dans le code PHP.

Fonction PHP include bien que très similaire à la fonction require, nous trouvons quelques dissemblances entre elles et elles sont les suivantes :

• La fonction include renvoie un avertissement (E_WARNING) chaque fois qu'une erreur se produit, alors que la fonction require ne le fait pas.
• L'exécution du script continue même après qu'une erreur soit rencontrée lors de la fonction d'inclusion, mais l'exécution s'arrête lorsqu'une erreur se produit (E_COMPILE_ERROR) lors de l'exécution avec la fonction requise.
• Ex : l'instruction require peut être utilisée pour s'exécuter dans les cas de codage de fonction CMS, Framework ou PHP où nous devons inclure un fichier clé dans le flux de celui-ci. Cela aide à maintenir l'intégrité et la sécurité des applications, supposons que l'un des fichiers clés ne soit pas présent.
• De même, en incluant le fichier, nous pouvons gagner beaucoup de temps car nous pouvons toujours créer et inclure un pied de page, un en-tête ou un fichier de menu standard pour toutes les pages Web. Ensuite, nous pouvons mettre à jour uniquement le fichier d'en-tête lorsque cela est nécessaire.

Avantages de l'utilisation de PHP include_once

• Puisque ceci include_once renvoie un avertissement lorsqu'il n'est pas en mesure de trouver le fichier spécifique au lieu d'une erreur fatale et donc l'exécution ne s'arrêtera pas et se déroulera toujours sans problème.
• Meilleur dans la gestion des cas où nous devons réutiliser certaines fonctions et variables.
• Cela permet d'éviter les problèmes de réaffectation des valeurs des variables, de redéfinition de certaines fonctions, etc.
• Utile dans les cas où nous devons appeler périodiquement certaines fonctions.

Conclusion

PHP include once est utilisé pour inclure n'importe quel script et pour s'assurer qu'il n'est exécuté qu'une seule fois, évitant ainsi toute erreur qui pourrait être causée par un appel en double de celui-ci. Ceci est essentiellement utilisé lorsqu'un morceau de code commun doit être utilisé pour tout type de déclarations ou de fichiers de configuration requis pour l'exécution du code.

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!