WordPress
Utiliser WP-CLI sur votre site WordPress
KPanel includes a WP-CLI console that runs commands against your WordPress site from the browser, with no SSH client and no server login. This guide covers where to find it, exactly which commands…
Utilisation de WP-CLI sur Votre Site WordPress
KPanel inclut une console WP-CLI qui exécute des commandes contre votre site WordPress depuis le navigateur, sans client SSH ni connexion au serveur. Ce guide couvre où la trouver, exactement quelles commandes sont autorisées et pourquoi, les raccourcis intégrés à l'écran, et quoi faire quand vous avez besoin de quelque chose que la console ne peut pas exécuter.
Ouverture de la Console
- Connectez-vous à KPanel et cliquez sur Websites dans la barre latérale gauche.
- Cliquez sur votre site WordPress.
- Ouvrez l'onglet WordPress, puis la section Console.
L'entrée commence déjà avec un wp fixe, donc vous tapez uniquement ce qui vient après. plugin list, pas wp plugin list. Appuyez sur Entrée ou cliquez sur Run.
Console est l'une des sections qui apparaissent sur les plans gérés. Sur les autres plans, la bande d'onglets se termine par un lien +8 on Managed à la place. Chaque action décrite ici qui n'est pas une commande brute a un bouton équivalent ailleurs dans KPanel, donc rien n'est hors de portée : la console est un moyen plus rapide d'accéder au même moteur.
Les commandes s'exécutent en tant qu'utilisateur système de votre site, dans le répertoire de votre site. Elles ne peuvent pas voir ou toucher aucun autre site.
Ce que la Console Exécutera et n'Exécutera Pas
La console utilise une liste d'autorisation. Seuls les préfixes de commande ci-dessous sont acceptés, et tout le reste est rejeté avant d'atteindre le serveur avec un message nommant la commande qu'il a refusée.
| Domaine | Autorisé |
|---|---|
| Core | core version, core check-update, core update, core is-installed, core verify-checksums |
| Plugins | plugin list, plugin update, plugin install, plugin activate, plugin deactivate, plugin status, plugin get, plugin delete, plugin verify-checksums |
| Thèmes | theme list, theme update, theme install, theme activate, theme status, theme get, theme delete |
| Utilisateurs | user list, user get, user create, user update, user set-role, user delete, user reset-password, user add-cap, user remove-cap, user generate |
| Base de données | db size, db tables, db optimize, db repair, db check |
| Cache et transients | cache flush, cache get, cache set, cache add, cache delete, transient get, transient set, transient delete |
| Règles de réécriture | rewrite flush, rewrite list, rewrite structure |
| Cron | cron event list, cron event run, cron schedule list |
| Configuration | config get, config list, config has, config shuffle-salts |
| Mode maintenance | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| Inspection en lecture seule | option get, option list, post list, post get, comment list, comment get |
| Média et langue | media regenerate, language core install, language core update |
| Rechercher et remplacer | search-replace |
Les exclusions délibérées comptent plus que les inclusions :
evaletshellsont bloqués. PHP arbitraire et shell arbitraire rendraient la console équivalente à une invite root dans un onglet du navigateur.db import,db export,db drop,db queryetdb resetsont bloqués. L'importation et la réinitialisation détruisent une base de données sans étape de confirmation ;db queryest une invite SQL sans restriction. Utilisez phpMyAdmin à la place : Accessing Your Database With phpMyAdmin.config setetconfig deletesont bloqués. Une mauvaise écriturewp-config.phpmet le site hors ligne. Lisez les valeurs ici, changez-les via le gestionnaire de fichiers.option updateetoption deletesont bloqués. Éditer les options à l'aveugle est une façon courante de casser un site au-delà de la récupération.
La console ne prend aucune sauvegarde pour vous, sur aucune commande. Seuls les boutons de la section Quick Actions le font. Avant search-replace, core update, plugin update, theme update, db optimize ou db repair, faites une sauvegarde vous-même à partir de l'onglet Backups du site. Voir Taking a Backup.
Travail dans la Console
L'écran en fait plus que d'accepter une commande à la fois.
Boutons prédéfinis. Des raccourcis groupés se trouvent au-dessus de l'invite : Performance (vider le cache, effacer les transients, vider les réécriture, vérifier l'autoload), Base de données (optimiser, vérifier, réparer, taille), Diagnostics (version WP, vérifier les mises à jour, vérifier le noyau, événements cron), Contenu (lister les plugins, thèmes, utilisateurs, exécuter cron maintenant), Sécurité (utilisateurs admin, sommes de contrôle des plugins, réinitialiser les salts, wp-config) et Maintenance (mode maintenance activé et désactivé, régénérer les miniatures, statut). Un clic exécute la commande.
Historique. Appuyez sur les flèches haut et bas dans l'invite pour naviguer dans vos 50 dernières commandes sur ce site.
Snippets. Cliquez sur l'icône de signet à côté d'une commande pour l'enregistrer avec un nom, de sorte qu'une longue invocation que vous utilisez chaque mois soit un clic la prochaine fois.
Carte d'environnement. Au-dessus de l'invite, une carte affiche la version PHP du site, la version WordPress, la limite de mémoire, la mémoire actuellement utilisée, le maximum de téléchargement et la limite de temps d'exécution, avec un bouton Copy for support qui met tout cela plus votre liste de plugins actifs dans le presse-papiers. Collez-le dans un ticket de support et vous avez économisé un aller-retour.
Copier la sortie. Chaque bloc de résultats a des boutons de copie et d'effacement.
La sortie s'écoule à mesure que la commande s'exécute, de sorte qu'une opération longue affiche la progression plutôt que de rester silencieuse.
Commandes À Connaître
Diagnostic
core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes
verify-checksums compare vos fichiers core et plugins par rapport aux copies officielles publiées et signale tout ce qui est modifié. C'est le contrôle de première ligne le plus rapide sur un site que vous soupçonnez d'avoir été altéré.
option list --autoload=yes répertorie chaque option que WordPress charge à chaque requête. Une table d'autoload gonflée est l'une des causes les plus courantes d'un site lent sans raison visible.
Maintenance
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
Utilisateurs
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
Tout ce qui est tapé ici est enregistré dans le journal d'activité de votre compte, y compris les mots de passe. Changez un mot de passe que vous définissez de cette façon une fois que vous êtes connecté. Les détails complets sur la récupération de compte sont dans Resetting a Lost WordPress Admin Password.
Rechercher et Remplacer
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Faites toujours un essai à blanc d'abord. La procédure pas à pas complète, y compris pourquoi un remplacement SQL brut corrompt une base de données WordPress, est dans Running a Search and Replace.
Console ou Quick Actions ?
Les deux exécutent le même WP-CLI en dessous. Choisissez sur cette base :
| Tâche | Meilleure voie |
|---|---|
| Vider le cache, mettre à jour les plugins, régénérer les médias | Quick Actions, un clic et il sauvegarde d'abord |
| Rechercher et remplacer avec un aperçu par table | Quick Actions, la carte Search & Replace |
| Tout ce qui nécessite un drapeau spécifique | Console |
| Lister, inspecter, diagnostiquer | Console |
| Exécuter un événement cron en retard | Console |
Édition wp-config.php ou importation d'une base de données | Aucun des deux. Utilisez le gestionnaire de fichiers ou phpMyAdmin |
Quand Vous Avez Besoin de Plus que la Liste d'Autorisation
Pour WP-CLI sans restriction, connectez-vous via SSH et exécutez wp directement à partir du répertoire de votre site. SSH n'utilise que l'authentification par clé, donc ajoutez d'abord votre clé publique depuis l'onglet Files du site, puis SSH Keys. Les détails de connexion, y compris l'hôte exact, le port et le nom d'utilisateur, sont affichés sur ce même écran. Voir Adding SSH Keys et Connecting Over SFTP.
Dépannage
"'x y' is not in the allowed command list." La commande n'est pas sur la liste d'autorisation. Vérifiez le tableau ci-dessus pour trouver l'équivalent autorisé le plus proche, ou utilisez SSH.
"No results returned. Check that WP-CLI is available." La commande s'est exécutée mais n'a rien imprimé. Habituellement, le comportement correct pour une requête sans correspondances.
The command times out. Les commandes de la console sont limitées à 60 secondes. Les opérations longues telles que la régénération d'une grande bibliothèque multimédia doivent être exécutées à partir de Quick Actions, qui utilise une limite plus longue, ou via SSH.
Nothing runs and the buttons are disabled. Votre rôle de compte Kapsule est en lecture seule pour ce site. Demandez à un propriétaire de compte de l'augmenter.