Dans les plugins WordPress, lorsque vous devez absolument créer vos propres tables

WordPress Le charme de WordPress repose entièrement sur les plugins. Presque toutes les fonctionnalités que vous souhaitez peuvent être obtenues grâce à des plugins. Cependant, à mesure que les fonctionnalités se multiplient, le stockage des données devient un obstacle inévitable. Le système fournit des tables prêtes à l'emploi telles que wp_posts, wp_comments et wp_options, qui suffisent pour les modifications quotidiennes. Mais dès que les données commencent à affluer à grande échelle, les choses se compliquent.

Quand devrai-je réellement construire les tables moi-même ?

J'ai déjà créé un plugin pour cours en ligne où les inscriptions des apprenants, les journaux de progression des cours et les résultats des examens étaient saisis un par un. Au début, par paresse, j'ai tout mis dans les métadonnées des publications. Très vite, le chargement de la liste d'administration est devenu aussi lent qu'un escargot : des dizaines de milliers d'enregistrements ont fini par saturer la base de données. Les commandes en ligne, les journaux de comportement des utilisateurs, les classements par points : ces scénarios sont très similaires. Des champs de données fixes, un nombre de lignes qui ne cesse d'augmenter et des exigences fréquentes en matière de filtrage croisé. À ce stade, les tables personnalisées cessent d'être facultatives et deviennent une solution vitale.

La documentation officielle est très claire à ce sujet : évitez de créer de nouvelles tables si vous pouvez l'éviter. Mais regardez ça... WooCommerce le bon de commande, puis jetez un œil à LearnDash Le calendrier d'apprentissage ? Tous les principaux plugins ont créé leur propre ensemble de tables, n'est-ce pas ? Une fois le projet lancé, ce sont les performances et la maintenance à long terme qui comptent vraiment ; la documentation doit parfois passer au second plan.

dbDelta : l'approche la plus fiable pour la création de tables

Pour créer des tables, WordPress fournit l'excellent outil dbDelta. Plutôt que d'utiliser la force brute, il examine d'abord la structure existante de la table avant de procéder à l'écriture de votre code. SQL Modifiez uniquement ce qui doit l'être, paire par paire. Lors de la mise à niveau des plugins, la plus grande crainte est de perdre les anciennes données des utilisateurs. dbDelta vous aide à éviter cet écueil.

Pour commencer, utilisez d'abord require_once sur le fichier upgrade.php, puis utilisez la variable globale $wpdb pour obtenir le préfixe de la table, ce qui est essentiel dans un environnement multisite. Pour le nom de la table, écrivez simplement $wpdb->prefix suivi de votre propre suffixe.

Astuce pratique pour écrire des instructions CREATE TABLE : placez chaque champ sur une ligne distincte, faites précéder la clé primaire de deux espaces et n'oubliez pas d'inclure `$wpdb->get_charset_collate()` à la fin. Ces détails déterminent si dbDelta peut reconnaître votre intention.

Exemple concret de stockage des commentaires des utilisateurs

Par exemple, si je souhaite stocker les commentaires des utilisateurs, j'écrirais cela comme suit :

PHP global $twpdb ; $table_name = $twpdb->prefix . 'user_feedback' ; $charset_collate = $twpdb->get_charset_collate() ;

$sql = "CREATE TABLE $table_name ( id mediumint(9) NOT NULL AUTO_INCREMENT, user_name tinytext NOT NULL, user_email text NOT NULL, message longtext NOT NULL,
  submitted_on datetime DEFAULT CURRENT_TIMESTAMP NOT NULL, PRIMARY KEY (id) ) $charset_collate;"; require_once ABSPATH . 'wp-admin/includes/upgrade.php'; dbDelta( $sql );

Insérez cet extrait dans le hook d'activation, et dès que le plugin s'activera, la table sera créée sans bruit.

Comment migrer facilement les structures de table lors des mises à niveau des plugins ?

Les plugins subissent inévitablement des itérations. Après quelques mois, vous pourriez soudainement souhaiter ajouter un champ « statut de lecture » ou créer un index pour la colonne e-mail, ce qui ne peut être fait simplement en activant des hooks.

J'ai pris l'habitude de stocker un numéro de version de la base de données dans la table des options, par exemple « my_plugin_db_version ». Lorsque je mets à jour le plugin, je compare les versions ; si elles ne correspondent pas, je relance simplement « dbDelta ». Il ajoute consciencieusement les nouveaux champs sans endommager les données existantes. Cette astuce m'a sauvé à plusieurs reprises dans des environnements de production.

Une fois, j'ai repris un plugin pour quelqu'un d'autre, et après la mise à jour des utilisateurs, tout s'est détraqué, tout cela parce que le développeur avait négligé de gérer les changements structurels. Depuis lors, avant de publier une nouvelle version, je lance toujours moi-même plusieurs séries de tests dbDelta pour voir exactement quelles zones ont été modifiées.

Lecture et écriture quotidiennes : N'oubliez jamais que la sécurité passe avant tout.

La table est désormais en place ; il ne reste plus qu'à effectuer les opérations courantes de lecture et d'écriture. L'utilisation des fonctions insert, update, delete et get_results de $wpdb est l'approche la plus fiable. N'oubliez jamais d'utiliser prepare(), même lorsque les données semblent propres : l'injection SQL n'est pas une mince affaire.

Méthodes courantes pour insérer un commentaire

Insérez un commentaire, quelque chose comme ceci :

PHP $wpdb->insert(     $table_name,     array(         'user_name' => sanitize_text_field($_POST['name']),         'user_email' => sanitize_email($_POST['email']),
        'message' => sanitise_textarea_field( $_POST['message'] ), 'submitted_on' => current_time( 'mysql' ) ), array( '%s', '%s', '%s', '%s' ) );

Je les regrouperais généralement dans des fonctions plus petites, telles que la vérification des commentaires par e-mail ou la récupération des dix dernières entrées, afin que le code principal ne soit pas trop encombré.

Lorsque vous désinstallez des plugins, n'oubliez pas de faire le ménage après.

Le jour où un plugin est désinstallé, les utilisateurs souhaitent généralement emporter leurs données avec eux, sauf si vous avez explicitement accepté de les conserver au préalable. L'approche la plus propre consiste à créer un fichier `uninstall.php` séparé dans le répertoire racine, qui ne sera déclenché que lors d'une véritable désinstallation. Dans ce fichier, vous pouvez exécuter `DROP TABLE` ou effectuer un nettoyage sélectif en fonction des paramètres, selon ce qui vous convient le mieux. Cette méthode est beaucoup plus fiable et transparente que l'utilisation de `register_uninstall_hook`.

Certains plugins incluent une option permettant de choisir « s'il faut conserver les données », ce qui dépend de votre public cible. Les sites d'entreprise peuvent souhaiter les conserver, tandis que les outils légers ont tendance à être préférés lorsque les données sont complètement purgées.

Enfin, quelques mots d'expérience

Quand il s'agit de savoir s'il faut ou non utiliser des tables personnalisées, vous feriez bien de vous poser cette question à deux reprises. Le plus souvent, les types de publications personnalisés sont associés à... meta À vrai dire, c'est déjà suffisant. Mais pour vraiment franchir le pas, il faut respecter les conventions relatives aux bases de données : ajouter des index si nécessaire, ne jamais faire de compromis sur les types de champs et absolument activer utf8mb4 – qui n'utilise pas d'émojis de nos jours ?

Au fil des années passées à écrire des plugins, j'ai constaté que les projets les plus faciles à réaliser sont invariablement ceux qui consacrent beaucoup d'efforts à la couche de données. Une fois que la structure des tables est solide, les tâches suivantes, telles que la pagination, les sauvegardes et les requêtes complexes, s'exécutent beaucoup plus facilement.

Si vous hésitez à construire votre propre table, n'hésitez pas à partager votre situation dans les commentaires. Une brève discussion pourrait vous aider à trouver la solution la plus simple.

Contactez nous
Vous n'arrivez pas à lire le tutoriel ? Contactez-nous pour une réponse gratuite ! Aide gratuite pour les sites personnels et les sites de petites entreprises !	Service clientèle WeChat
① Tel : 020-2206-9892
② QQ咨询：1025174874
(iii) Courriel : info@361sale.com
④ Horaires de travail : du lundi au vendredi, de 9h30 à 18h30, jours fériés.