Comment ajouter PHP dans WordPress : Un guide complet

PHP fait fonctionner 74% de tous les sites web où le langage côté serveur est connu, y compris WordPress. Si vous souhaitez personnaliser le fonctionnement de votre site, étendre les fonctionnalités des plugins ou modifier le comportement de votre thème, vous travaillerez avec ce langage de script.

Lisez ce guide pour comprendre comment exécuter du code PHP dans WordPress en toute sécurité. Nous vous présenterons également un outil pratique pour vous aider à détecter les problèmes de PHP avant qu'ils ne causent de réels problèmes.

Ce qu'il faut savoir avant d'ajouter du PHP à WordPress

Un code PHP personnalisé devient nécessaire lorsque vous devez modifier le fonctionnement de plugins ou de thèmes existants. Vous pouvez ajouter des fonctionnalités qui ne sont pas disponibles via des plugins, créer des intégrations personnalisées entre différentes parties de votre site, ou remplacer les comportements par défaut de WordPress. Dans toutes ces situations, l'ajout d'un peu de code PHP peut vous éviter d'installer un énième plugin.

Cela dit, vous devez être prudent lorsque vous éditez du PHP. Même une petite erreur dans votre code, comme un point-virgule manquant ou une parenthèse supplémentaire, peut entraîner l'arrêt complet de votre site. En effet, chaque fois que votre site charge un article, il extrait des données d'une base de données ou traite un formulaire. PHP effectue ce travail en coulisse. Dans le pire des cas, vous vous retrouverez bloqué hors du tableau de bord d'administration, et la résolution du problème nécessitera un accès direct aux fichiers de votre serveur.

C'est pourquoi vous devez toujours sauvegarder votre site avant d'ajouter du code PHP à votre site WordPress. Avec une sauvegarde en place, testez votre code dans un environnement de mise en scène pour détecter les problèmes. L'environnement de test permet de s'assurer que votre code fonctionne comme prévu dans une configuration qui reflète étroitement la production et minimise les bogues, les problèmes d'intégration et les expériences négatives des utilisateurs une fois que le code est mis en ligne. Vous pouvez également envisager d'utiliser des plugins qui valident la syntaxe avant l'exécution afin d'éviter de nombreuses erreurs courantes qui font planter les sites. 

En outre, veillez à la compatibilité des versions de PHP lorsque vous écrivez du code personnalisé. 

Les installations WordPress fonctionnent sur différentes versions de PHP (de 7.4 à 8.4), et il existe des différences significatives de syntaxe et de fonctions entre les versions majeures. Un code qui fonctionne parfaitement en PHP 7.4 peut générer des erreurs en PHP 8.1 en raison de fonctions obsolètes ou d'un changement de comportement. Vérifiez toujours la version de PHP utilisée par votre environnement d'hébergement et écrivez du code compatible avec cette version. 

Lorsque vous partagez du code avec d'autres personnes, indiquez les exigences relatives à la version de PHP dans votre documentation. Ceci est d'autant plus important que le langage PHP continue de se développer, PHP 8.x introduisant un contrôle de type plus strict et supprimant des fonctionnalités précédemment obsolètes. 

N'oubliez pas non plus d'organiser votre code à l'aide de commentaires afin de comprendre ce qu'il fait des mois plus tard, lorsque vous y reviendrez inévitablement. Et assurez-vous de connaître les bases de l'accès FTP, car lorsque des erreurs PHP vous empêchent d'accéder à WordPress, l'accès direct aux fichiers est la seule solution.

Lire aussi : Comment désactiver les erreurs PHP dans WordPress

Méthodes pour ajouter PHP à WordPress

1. Utilisation des plugins

Tout le monde peut ajouter du PHP à WordPress à l'aide de plugins. C'est le moyen le plus sûr et le plus pratique. Ces plugins vous permettent d'ajouter, d'éditer et de gérer le code PHP sans modifier directement les fichiers principaux, les thèmes ou les plugins.

Par exemple, vous pouvez utiliser le plugin Code Snippets pour ajouter en toute sécurité du code PHP personnalisé à votre site, sans modifier le fichier functions.php de votre thème. Il s'agit d'un moyen plus propre et plus sûr d'exécuter de petits morceaux de code personnalisé (comme des modifications, des filtres ou des actions) pour modifier le fonctionnement de votre site.

En général, pour ajouter du PHP à l'aide de plugins, vous devez installer et activer le plugin et rechercher une option permettant d'ajouter un nouvel extrait ou un nouveau bloc de code. Lorsque vous créez un nouvel extrait, vous devez généralement sélectionner PHP comme type de code, nommer votre extrait (utilisez un nom descriptif qui vous aidera à identifier son utilité ultérieurement) et ajouter votre code PHP dans l'éditeur de code. Vérifiez que votre code est correctement formaté avant de l'enregistrer.

La plupart des plugins de qualité valideront votre syntaxe PHP afin d'éviter les erreurs qui pourraient endommager votre site. Une fois satisfait de votre code, enregistrez et activez l'extrait pour le rendre actif sur votre site.

2. Ajout de PHP via functions.php

Pour ceux qui sont à l'aise avec les fichiers de thème, l'ajout de PHP au fichier functions.php est une approche traditionnelle. Ce fichier vous permet d'ajouter des fonctionnalités sans créer de plugin séparé.

Pour accéder à votre fichier functions.php, allez dans Apparence > Editeur de thème dans votre tableau de bord WordPress. Sélectionnez votre thème (idéalement un thème enfant) et localisez functions.php dans la liste des fichiers sur la droite. Lorsque vous ajoutez du code à ce fichier, placez-le toujours en bas pour éviter tout conflit avec les fonctions existantes.

Unlike plugin solutions, you’ll need to include the opening <?php tag if it’s not already there at the top of your file. After adding your code, click Update File to save your changes. Modern WordPress includes a basic safety mechanism that attempts to revert changes if it detects fatal PHP errors, but this isn’t foolproof.

Le principal inconvénient de cette approche est que votre code sera perdu lorsque vous mettrez à jour ou changerez de thème, à moins que vous n'utilisiez un thème enfant. De plus, une erreur de syntaxe ici affectera l'ensemble de votre site puisque functions.php se charge à chaque requête de page.

En rapport : Comment réparer une erreur d'analyse : Erreur de syntaxe, fin de fichier inattendue dans WordPress

3. Utilisation de FTP pour l'édition avancée de PHP

La méthode FTP offre le plus de contrôle aux développeurs qui préfèrent utiliser des éditeurs de code professionnels et veulent un accès complet aux fichiers WordPress. Cette approche consiste à accéder aux fichiers de votre serveur directement par l'intermédiaire d'un client FTP comme FileZilla.

Pour utiliser cette méthode, vous aurez besoin des identifiants FTP de votre fournisseur d'hébergement. Une fois connecté, accédez à votre répertoire d'installation de WordPress et localisez le dossier wp-content qui contient vos thèmes et vos plugins. À partir de là, vous pouvez modifier n'importe quel fichier PHP à l'aide de votre éditeur de code préféré.

La méthode FTP présente plusieurs avantages : vous pouvez utiliser des éditeurs de code avancés avec mise en évidence de la syntaxe, vérification des erreurs et autocomplétion ; vous pouvez modifier n'importe quel fichier du système WordPress ; et vous pouvez rapidement restaurer les sauvegardes en cas de problème.

Toutefois, ce pouvoir s'accompagne d'une responsabilité. Il n'y a pas de validation intégrée, de sorte que les erreurs dans votre code auront un impact direct sur votre site. Gardez toujours une connexion de secours ouverte lorsque vous effectuez des modifications afin de résoudre les problèmes si votre site tombe rapidement en panne.

Pour les personnalisations de thèmes, concentrez-vous sur le répertoire du thème enfant afin de préserver vos modifications lors des mises à jour. Lorsque vous modifiez des plugins, n'oubliez pas que vos modifications seront écrasées lors de la mise à jour du plugin ; documentez donc soigneusement vos modifications.

Exemples concrets de PHP dans WordPress

Maintenant que vous connaissez les différentes méthodes pour ajouter du PHP à WordPress, voyons quelques exemples pratiques. Ces exemples résolvent des problèmes courants et peuvent être mis en œuvre à l'aide de l'une ou l'autre des méthodes présentées précédemment.

1. Modifier le comportement de base de WordPress

Voici un extrait qui modifie le nombre d'articles affichés sur les pages d'archives :

php
function modify_posts_per_page($query) {
    if (!is_admin() && $query->is_main_query()) {
        if (is_category() || is_tag() || is_date()) {
            $query->set('posts_per_page', 12);
        }
    }
}
add_action('pre_get_posts', 'modify_posts_per_page');

Ce code s'insère dans WordPress avant qu'il n'interroge les articles et modifie le nombre affiché sur les pages de catégories, d'étiquettes et d'archives de dates à 12. Le crochet n'affecte que la requête principale et ne modifiera pas les résultats dans les widgets ou les requêtes personnalisées ailleurs sur votre site.

2. Création de codes courts personnalisés

Les shortcodes vous permettent d'ajouter du contenu dynamique à n'importe quel endroit de vos articles ou de vos pages. Voici un exemple qui affiche un contenu différent selon que l'utilisateur est connecté ou non :

php
function conditional_content_shortcode($atts, $content = null) {
    $attributes = shortcode_atts(
        array(
            'logged_in' => '',
            'logged_out' => '',
        ),
        $atts
    );
    
    if (is_user_logged_in() && !empty($attributes['logged_in'])) {
        return $attributes['logged_in'];
    } elseif (!is_user_logged_in() && !empty($attributes['logged_out'])) {
        return $attributes['logged_out'];
    }
    
    return $content;
}
add_shortcode('user_content', 'conditional_content_shortcode');

Vous pouvez utiliser ce shortcode comme suit :

[user_content logged_in="Welcome back!" logged_out="Please log in to access this content."] 

Le message approprié s'affiche en fonction du statut de l'utilisateur.

3. Personnalisation des fonctions d'administration

Parfois, vous souhaitez personnaliser la zone d'administration de WordPress. Ce snippet ajoute un widget de tableau de bord personnalisé avec des informations importantes pour les éditeurs de votre site :

php
function custom_dashboard_widget() {
    echo '<p>Welcome to the site dashboard! Before publishing content, please:</p>
    <ul>
        <li>Check that all images have alt text</li>
        <li>Preview the post on mobile devices</li>
        <li>Add at least one category and three tags</li>
    </ul>
    <p>For assistance, contact the admin at: admin@example.com</p>';
}

function add_custom_dashboard_widget() {
    wp_add_dashboard_widget(
        'custom_help_widget',
        'Publishing Checklist',
        'custom_dashboard_widget'
    );
}
add_action('wp_dashboard_setup', 'add_custom_dashboard_widget');

Cela crée un widget avec une liste de contrôle de publication visible par toute personne accédant au tableau de bord.

Lorsque vous mettez en œuvre ces exemples, n'oubliez pas de les adapter. Modifiez les noms des variables, les valeurs et les comportements des fonctions pour qu'ils correspondent à votre propre configuration de WordPress.

Dépannage des erreurs PHP dans WordPress

Même les développeurs expérimentés commettent des erreurs lorsqu'ils ajoutent du PHP à WordPress. Savoir identifier et corriger ces erreurs rapidement peut vous épargner des heures de frustration et éviter de longues périodes d'indisponibilité de votre site.

Erreurs PHP courantes que vous rencontrerez

Les erreurs de syntaxe sont les problèmes les plus fréquents lors de l'ajout de PHP à WordPress. Elles se produisent lorsque la structure de votre code ne respecte pas les règles de PHP - points-virgules manquants, parenthèses ou crochets non appariés, ou guillemets non fermés. Ces erreurs déclenchent généralement le redoutable "écran blanc de la mort", où votre site n'affiche rien d'autre qu'une page blanche.

Les erreurs fatales se produisent lorsque PHP comprend votre syntaxe mais rencontre un problème lors de l'exécution. Cela peut se produire lorsque vous appelez une fonction qui n'existe pas, lorsque vous essayez d'utiliser une classe qui n'est pas disponible, ou lorsque vous essayez d'accéder à une variable non définie d'une manière qui interrompt l'exécution. De nombreuses erreurs fatales sont accompagnées de messages d'erreur spécifiques qui permettent d'identifier le problème.

Les erreurs de logique sont les plus difficiles à diagnostiquer, car votre code s'exécute sans erreur mais ne produit pas les résultats escomptés. Il peut s'agir de problèmes de style, de contenu manquant ou de fonctionnalités qui fonctionnent partiellement mais se comportent de manière incorrecte.

Mode de récupération de WordPress

Les versions récentes de WordPress comprennent un mode de récupération qui s'active lorsque des erreurs PHP critiques sont détectées. Si WordPress détecte un problème suffisamment grave pour affecter l'accès à l'administration, il envoie à l'administrateur du site un courriel contenant un lien de récupération spécial. Ce lien vous permet d'accéder à la zone d'administration dans un mode limité où les plugins ou les thèmes problématiques sont temporairement désactivés.

Une fois en mode de récupération, vous pouvez accéder à l'éditeur du thème ou du plugin pour corriger le code incriminé. WordPress identifiera le fichier et souvent la ligne contenant l'erreur, ce qui rendra le dépannage beaucoup plus rapide. Une fois le problème résolu, vous pouvez quitter le mode de récupération et votre site fonctionnera à nouveau normalement.

Si vous ne recevez pas d'e-mail relatif au mode de récupération ou si vous ne pouvez pas y accéder, vous devrez utiliser le protocole FTP pour résoudre le problème manuellement.

Correction des erreurs PHP via FTP

Lorsqu'une erreur PHP vous empêche d'accéder à WordPress, le FTP devient votre outil de secours. Connectez-vous à votre serveur en utilisant vos identifiants FTP et naviguez jusqu'à l'emplacement du fichier que vous avez récemment modifié. Si vous ne vous souvenez pas du fichier à l'origine du problème, vérifiez les journaux d'erreurs de votre serveur (généralement accessibles via votre panneau de contrôle d'hébergement) pour trouver des indices.

Une fois que vous avez identifié le fichier problématique, téléchargez-en une copie de sauvegarde, puis modifiez le fichier pour corriger l'erreur. La solution la plus simple consiste souvent à revenir à une version précédente ou à commenter entièrement le nouveau code en utilisant /* et */ autour de la section problématique. Après avoir effectué vos modifications, téléchargez le fichier corrigé sur le serveur.

Pour les problèmes liés aux plugins ou aux thèmes installés à partir du dépôt WordPress, vous pouvez également renommer le dossier du plugin ou du thème via FTP pour le désactiver complètement. Par exemple, en remplaçant "plugin-name" par "plugin-name-disabled", vous empêcherez WordPress de le charger, ce qui rétablira souvent l'accès à votre zone d'administration.

Utilisation des journaux d'erreurs 

Les journaux d'erreurs de WordPress fournissent des informations précieuses lors de la résolution de problèmes PHP. Pour activer la journalisation détaillée, ajoutez cette ligne à votre fichier wp-config.php :

php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Cette configuration écrit toutes les erreurs PHP dans un fichier debug.log dans votre répertoire wp-content sans les afficher aux visiteurs du site. Après avoir activé la journalisation de débogage, reproduisez l'erreur, puis consultez le fichier journal pour obtenir des informations spécifiques sur ce qui n'a pas fonctionné et où.

N'oubliez pas de désactiver WP_DEBUG sur les sites de production après avoir résolu vos problèmes, car les journaux de débogage peuvent devenir volumineux et potentiellement exposer des informations sensibles sur la structure de votre site.

En lien : Comment utiliser les journaux d'erreurs PHP de WordPress pour le dépannage (Guide)

Meilleures pratiques pour PHP dans WordPress

1. Tout documenter

Un code bien documenté est le cadeau que vous offrez à votre futur moi. Pour chaque extrait de code PHP que vous ajoutez à WordPress, incluez des commentaires qui expliquent ce que fait le code, pourquoi il est nécessaire, et toutes les dépendances qu'il a. Utilisez les formats de commentaires standards de PHP :

php
// This is a single line comment

/*
 * This is a multi-line comment
 * that continues here
 */

/**
 * Function documentation in DocBlock format
 * 
 * @param string $example Parameter description
 * @return bool Returns true if successful
 */

Documentez non seulement ce que fait le code, mais aussi toutes les suppositions qu'il fait sur la structure du thème, la compatibilité avec les plugins ou les versions de WordPress. Ces notes seront précieuses lorsque vous reviendrez sur ce code des mois plus tard, ou lorsqu'un autre développeur héritera de votre site.

2. Respecter les normes de codage de WordPress

WordPress a établi des normes de codage qui rendent le langage PHP plus cohérent et plus lisible. 

Il s'agit notamment de

• Utiliser les tabulations pour l'indentation, et non les espaces
• Nommer les fonctions avec des lettres minuscules et des traits de soulignement
• Toujours inclure des accolades pour les instructions conditionnelles et les boucles
• Ajout d'espaces après les virgules et autour des opérateurs

Au-delà de la lisibilité, le respect de ces normes garantit que votre code fonctionne bien avec les fonctions de base de WordPress et s'intègre proprement avec d'autres plugins et thèmes. La documentation sur les normes de codage de WordPress fournit des directives complètes pour écrire du PHP compatible avec WordPress.

3. Préfixez vos fonctions

WordPress charge dans le même environnement PHP du code provenant de sources multiples, y compris les fichiers principaux, les plugins et les thèmes. Cela crée un risque de collision de noms de fonctions, lorsque deux morceaux de code distincts essaient de déclarer des fonctions avec des noms identiques.

Pour éviter ce problème, préfixez toutes vos fonctions personnalisées par un identifiant unique lié à votre site ou à votre projet :

php
// Instead of this
function add_custom_styles() {
    // Function code
}

// Do this
function mysite_add_custom_styles() {
    // Function code
}

Cette simple convention de dénomination réduit considérablement les risques de conflits avec les plugins actuels ou futurs.

4. Vérifier l'existence des fonctions

Avant de déclarer une fonction, vérifiez si elle existe déjà afin d'éviter les erreurs fatales :

php
if (!function_exists('mysite_custom_function')) {
    function mysite_custom_function() {
        // Function code
    }
}

Cette approche défensive du codage signifie que votre site ne tombera pas en panne si la même fonction est accidentellement déclarée deux fois, que ce soit dans votre code ou à cause d'un conflit avec un plugin.

5. Utiliser des thèmes enfants pour modifier le thème

Si vous ajoutez du PHP qui modifie les fonctionnalités du thème, utilisez toujours un thème enfant plutôt que de modifier directement le thème parent. Cela permet de préserver votre code personnalisé lorsque le thème parent est mis à jour, évitant ainsi la situation redoutée où vos personnalisations disparaissent après une mise à jour.

La création d'un thème enfant est simple : créez un nouveau répertoire dans wp-content/themes avec un fichier style.css qui fait référence au thème parent, et ajoutez votre fichier functions.php avec votre code personnalisé. WordPress documente officiellement ce processus en détail.

6. Tester progressivement

Lors de l'implémentation de fonctionnalités PHP complexes, n'écrivez pas tout en même temps. Ajoutez du code par petites étapes testables, en vérifiant que chaque élément fonctionne avant de passer au suivant. Cette approche facilite considérablement le débogage, car elle permet d'identifier rapidement l'ajout qui a causé un problème.

Une bonne séquence de test est la suivante :

1. Ajouter la structure de la fonction de base et vérifier qu'elle ne casse rien.
2. Mettre en œuvre les fonctionnalités de base et les tester avec des données simples
3. Ajouter la gestion des erreurs et des cas limites
4. Optimiser les performances si nécessaire

En suivant cette approche de mise en œuvre progressive, vous détecterez les problèmes à un stade précoce, lorsqu'ils sont encore simples à résoudre.

Surveiller les erreurs PHP avec WP Umbrella

Oubliez les interminables fichiers debug.log.

WP Umbrella surveille le PHP de votre site en temps réel. Lorsqu'il détecte un problème, il vous alerte immédiatement par email ou Slack, vous permettant souvent de corriger les problèmes avant que les visiteurs ne les remarquent.

Outre la surveillance des erreurs PHP, il couvre également plusieurs autres fonctions utiles, notamment

• Contrôles de sécurité toutes les six heures. WP Umbrella compare vos plugins et thèmes actifs avec les derniers avis de sécurité et vous alerte lorsqu'un risque apparaît.
• La surveillance des certificats SSL vous avertit bien avant que l'expiration n'interrompe le trafic sécurisé.
• Suivi de la disponibilité et des performances à partir de plusieurs sites. Si votre site tombe en panne, vous recevez une alerte instantanée et une chronologie de la panne.
• Sauvegarde et restauration: Sauvegardes incrémentielles conformes au GDPR avec planification flexible et restauration en un clic.
• Détection visuelle des changements après les mises à jour. Si une mise en page se décale ou si un élément disparaît, vous pouvez revenir en arrière sans attendre la plainte d'un client.

Pourquoi c'est important :

• Protection proactive : empêchez les erreurs fatales d'entraîner l'arrêt de l'ensemble du site.
• Supervision centralisée : les agences peuvent surveiller des dizaines de sites à partir d'un seul écran au lieu de se connecter à chaque serveur. 

C'est plus sûr que de laisser WP_DEBUG_DISPLAY activé en production et bien plus rapide que d'attendre que les clients vous envoient une capture d'écran par email.

L'installation de WP Umbrella ne prend que quelques minutes : installez le plugin, connectez-le à votre compte WP Umbrella et configurez les préférences de notification. Le plugin offre la tranquillité d'esprit que votre site WordPress est continuellement surveillé pour tout problème affectant la performance ou la sécurité. Essayez-le gratuitement pendant 14 jours !

---

Sources :

• W3techs
• WordPress