Utilisation de WP-CLI avec le journal d’activité
Vous vous demandez comment exporter ou nettoyer votre journal d'activité sans ouvrir wp-admin ? Le plugin Activity Log inclut des commandes WP-CLI pour exporter les données du journal et purger les anciennes entrées directement depuis la ligne de commande.
Ce guide couvre l'utilisation de WP-CLI avec le plugin Activity Log, y compris tous les indicateurs d'exportation et de purge disponibles.
Configuration requise
WP-CLI doit être installé sur votre serveur, avec un accès pour l'exécuter depuis la ligne de commande. Le plugin Activity Log doit être installé et activé. Exécutez toutes les commandes depuis la racine de votre installation WordPress.
Commande d’exportation
La commande export affiche les entrées du journal d'activité dans le terminal ou dans un fichier. Combinez n'importe lequel des indicateurs ci-dessous pour filtrer les résultats.
wp duplicator-activity-log export
Par défaut, cela affiche toutes les entrées du journal sous forme de tableau formaté. Ajoutez des options pour filtrer et modifier le format de sortie.
Options d’exportation
Tous les indicateurs sont facultatifs et peuvent être combinés librement.
- –format=
Format de sortie. Accepte table (par défaut), csv ou json. - –category_l1=
Filtrer par catégorie d'événement de niveau supérieur. Valeurs acceptées :user,content,media,plugin,theme,wordpress,appearance,taxonomy,settings. - –severity=
Filtrer par niveau de gravité. Valeurs acceptées :info,low,medium,high,critical. - –user_id=
Filtrer les événements par un identifiant d'utilisateur WordPress spécifique. - –event_type=
Filtrer par un code de type d'événement spécifique, par exemple :user_login_failed,plugin_activated,content_post_published. - –search=
Rechercher dans les messages d'événements et les noms d'objets. Équivalent au champ Rechercher des événements dans l'administration. - –date_from=
Filtrer les entrées par date. Utilisez le formatYYYY-MM-DDouYYYY-MM-DD HH:MM:SS - –date_to=
Afficher les événements jusqu'à cette date incluse. - –site_id=
Sur un réseau WordPress Multisite, filtrer les événements pour un site spécifique par son ID de blog. Par défaut, le site actuel. - –fields=
Liste des champs à afficher, séparés par des virgules. Cet indicateur s'applique uniquement au formattable. Les exportations CSV et JSON incluent toujours tous les champs.
Champs disponibles pour –fields :
id, date_gmt, severity, event_type, event_label, category_l1, category_l2, category_l3, message, user_id, user_login, user_role, object_type, object_id, object_name, ip_address, user_agent, request_method, request_uri, source, site_id, metadata.
Exemples d’exportation
Exporter tous les événements sous forme de fichier CSV :
wp duplicator-activity-log export --format=csv > activity-log.csv
Exporter uniquement les événements de gravité élevée sur 7 jours :
wp duplicator-activity-log export --severity=high --date_from=2026-01-01 --date_to=2026-01-07
Exporter toutes les tentatives de connexion échouées au format JSON :
wp duplicator-activity-log export --event_type=user_login_failed --format=json
Exporter tous les événements de plugin pour une plage de dates spécifique dans un fichier :
wp duplicator-activity-log export --category_l1=plugin --date_from=2026-01-01 --date_to=2026-01-31 --format=csv > plugins-jan.csv
Exportez uniquement des champs spécifiques pour un CSV léger :
wp duplicator-activity-log export --format=csv --fields=date_gmt,user_login,severity,message > compact-log.csv
Commande de purge
La commande purge supprime toutes les entrées de journal plus anciennes que votre période de rétention configurée (définie dans Journal d’activité › Paramètres › Général). C'est la même action que celle exécutée automatiquement par la tâche cron quotidienne.
La commande purge supprime les entrées du journal d'activité directement depuis la ligne de commande.
wp duplicator-activity-log purge
- L'exécution de purge sans indicateurs supprime toutes les entrées du journal d'activité. WP-CLI demande une confirmation avant la suppression, sauf si –yes est passé.
- older-than=<days> : Supprimer uniquement les entrées plus anciennes que le nombre de jours donné, au lieu de tout supprimer.
- yes : Ignorer la demande de confirmation.
Exemples de purge
Supprimer toutes les entrées du journal, avec une invite de confirmation :
wp duplicator-activity-log purge
Supprimer les entrées plus anciennes que 90 jours :
wp duplicator-activity-log purge --older-than=90
Supprimer toutes les entrées sans invite de confirmation :
wp duplicator-activity-log purge --yes
Utilisez ces commandes pour déclencher le nettoyage à la demande au lieu d'attendre la prochaine exécution planifiée. Pour la même action depuis wp-admin, utilisez Journal d'activité > Paramètres > Outils > Purger tous les journaux.
C'est tout ! Avec ces commandes, vous pouvez exporter et nettoyer les données du journal d'activité entièrement depuis la ligne de commande, sans ouvrir wp-admin.