Meilleure pratique : Vérifier si une fonction existe lors de l'ajout dans un thème WordPress

L'un de nos lecteurs plus techniques nous a récemment demandé comment vérifier l'existence d'une fonction PHP avant d'intégrer du nouveau code dans un site WordPress. Ceci est important pour garantir que votre site fonctionne sans problème et évite les erreurs.

L'une des forces de WordPress est sa flexibilité et l'équipe WPBeginner ajoute régulièrement des fonctions personnalisées pour améliorer les fonctionnalités de notre site. Nous comprenons que le code PHP personnalisé peut échouer s'il appelle une fonction qui n'existe plus ou qui n'a pas encore été définie.

Dans cet article, nous vous montrerons comment vérifier facilement si une fonction existe avant de l'ajouter à votre thème WordPress, vous permettant ainsi d'éviter les erreurs potentielles dans votre code.

Pourquoi ajouter « Si la fonction existe » à votre code personnalisé ?

WordPress est principalement écrit dans le langage de programmation PHP. PHP est un langage de programmation côté serveur qui s'exécute sur les serveurs de votre hébergement WordPress.

Comme le code PHP doit avoir fini de s'exécuter avant que la page ne soit chargée dans les navigateurs de vos visiteurs, il y a certaines limitations. L'une de ces limitations est que si quelque chose se passe mal, cela pourrait empêcher le chargement de toute la page.

Dans WordPress, si une fonction manquante empêche le reste du code de s'exécuter, alors il s'arrête et affiche un message d'erreur critique ou d'erreur fatale.

Qu'est-ce qui peut faire qu'une fonction cesse soudainement de fonctionner ou disparaisse ?

C'est une erreur WordPress plus courante que vous ne le pensez.

Par exemple, disons qu'un de vos plugins WordPress contient une fonction que vous avez ajoutée dans l'en-tête ou le pied de page de votre thème. La désactivation du plugin fera disparaître la fonction et provoquera l'erreur critique sur votre site WordPress.

Cela dit, examinons comment vérifier facilement si une fonction existe avant de l'exécuter dans les fichiers de votre thème WordPress.

Vérifier si une fonction existe dans WordPress

Heureusement, le langage de programmation PHP dispose d'une méthode intégrée pour vérifier facilement l'existence d'une fonction avant de l'exécuter.

Supposons que vous ayez une fonction WordPress qui affiche l'heure actuelle avec des informations de fuseau horaire. Voici un exemple de code que vous pouvez utiliser pour essayer.

Vous pouvez l'ajouter directement au fichier functions.php de votre thème, mais dans ce tutoriel, nous utiliserons le plugin d'extraits de code WPCode car c'est le moyen le plus sûr et le plus simple d'ajouter du code personnalisé dans WordPress.

Tout d'abord, vous devez installer et activer le Plugin Gratuit WPCode. Si vous avez besoin d'aide pour cela, consultez notre guide étape par étape pour débutants sur comment installer un plugin WordPress.

Après l'activation, vous devez aller dans Extraits de code » + Ajouter un extrait sur votre tableau de bord WordPress. Une fois là, survolez l'option « Ajouter votre code personnalisé (Nouvel extrait) » avec votre souris, puis cliquez sur le bouton « Utiliser l'extrait » qui apparaît.

Cela ouvrira une nouvelle page où vous pourrez ajouter votre extrait personnalisé. Tapez un titre tel que « Afficher l'heure actuelle avec le fuseau horaire », puis collez l'extrait de code ci-dessous dans le volet d'aperçu du code.

//display current time with timezone
function wpb_show_timezone() {
$better_time = current_time('F j, Y g:i a e');
echo "<p>The current time is " . $better_time ."</p>";
}

Après cela, vous devez sélectionner « Extrait PHP » dans le menu déroulant Type de code pour vous assurer que le code s'exécute correctement.

Enfin, vous devez activer le bouton bascule Activer et cliquer sur le bouton « Enregistrer le extrait de code » pour stocker votre nouveau extrait de code.

Pour appeler cette fonction, vous devrez ajouter le code suivant n'importe où dans votre thème WordPress où vous souhaitez afficher l'heure actuelle.

<?php wpb_show_timezone(); ?>

Voici à quoi cela ressemblait sur notre site Web de test.

Maintenant, que se passerait-il si le code responsable de l'exécution de cette fonction disparaissait ?

L'appel de la fonction cassera votre site Web comme ceci.

Ajoutons une vérification pour nous assurer que ce code ne s'exécute que lorsque la fonction existe.

Encore une fois, vous devrez ajouter le code directement au fichier functions.php de votre thème ou utiliser un plugin d'extraits de code tel que WPCode (recommandé) :

<?php
if( function_exists('wpb_show_timezone')) {
wpb_show_timezone();
} else {
// do nothing
}
?>

Dans ce code, nous utilisons la fonction function_exists(). Cette fonction vérifie si une fonction existe et renvoie Vrai ou Faux.

Nous avons ensuite ajouté une condition if-else pour prendre les mesures appropriées en fonction de la disponibilité de la fonction.

Maintenant, lorsque la fonction n'est plus disponible, le code l'ignorera simplement, et WordPress pourra charger le reste de votre site Web normalement.

Nous espérons que cet article vous a aidé à apprendre comment vérifier si une fonction existe dans WordPress. Vous voudrez peut-être aussi consulter notre guide sur comment afficher facilement du code sur votre site WordPress ou notre sélection d'experts des meilleurs éditeurs de code pour Mac et Windows pour l'édition de fichiers WordPress.

Si cet article vous a plu, abonnez-vous à notre chaîne YouTube pour des tutoriels vidéo WordPress. Vous pouvez également nous retrouver sur Twitter et Facebook.