Vai al contenuto
Alessandro Matta
Informatica

Comandi WP-CLI per la manutenzione periodica di WordPress

mattalex 15 min di lettura

Cose da sapere prima di eseguire i comandi

WP-CLI permette di amministrare WordPress direttamente da terminale, senza utilizzare il pannello di controllo. È uno strumento particolarmente utile per chi gestisce più siti, installazioni WooCommerce, server e procedure di manutenzione ricorrenti.

Con una serie di comandi è possibile controllare utenti, plugin, temi, aggiornamenti, database, cron, backup e integrità dei file. Per WooCommerce si possono inoltre verificare prodotti, ordini, clienti, pagamenti e attività pianificate.

In questo articolo raccolgo una checklist di comandi WP-CLI per la manutenzione periodica di WordPress, organizzata per area di intervento.

Nota importante: negli esempi il prefisso wp viene omesso perché, nell’ambiente utilizzato, Plesk lo aggiunge automaticamente. Su una normale installazione WP-CLI i comandi completi iniziano invece con wp.

Prima di utilizzare comandi che modificano file, database, utenti, plugin o temi è necessario verificare di trovarsi nell’installazione corretta.

Controlla sempre:

  • la directory corrente;
  • il dominio del sito;
  • il database collegato;
  • il prefisso delle tabelle;
  • la disponibilità di un backup;
  • la compatibilità degli aggiornamenti.

Puoi eseguire alcuni controlli iniziali con:

core version
option get home
option get siteurl
config get table_prefix

Per conoscere la sintassi e le opzioni di un comando:

command --help

Per esempio:

plugin update --help

Prefisso delle tabelle WordPress

Negli esempi SQL utilizzo il prefisso standard wp_, quindi tabelle come:

wp_options
wp_users
wp_posts
wp_postmeta
wp_usermeta
wp_terms
wp_termmeta
wp_term_taxonomy
wp_term_relationships
wp_comments
wp_commentmeta

Il prefisso reale potrebbe però essere diverso. Un sito può utilizzare, per esempio:

site_options
site_users
site_posts
site_postmeta
site_usermeta

Prima di eseguire una query devi quindi verificare il valore configurato:

config get table_prefix

Puoi controllarlo anche direttamente nel file wp-config.php:

grep table_prefix wp-config.php

Durante una nuova installazione è generalmente preferibile utilizzare un prefisso diverso da quello standard. Questa scelta può rendere meno immediati alcuni attacchi automatizzati che fanno supposizioni sui nomi predefiniti delle tabelle.

Il prefisso personalizzato non è però una protezione sufficiente da solo. Sono comunque indispensabili aggiornamenti, password robuste, autenticazione a più fattori, permessi corretti, backup e monitoraggio.

Il cambio del prefisso su un sito già online deve essere eseguito soltanto dopo un backup completo e con una procedura verificata. Una sostituzione incompleta può rendere inutilizzabile l’installazione.

Controlli di sicurezza

Elencare gli amministratori

Per controllare gli utenti con ruolo amministratore:

user list --role=administrator --format=csv

Verifica che siano presenti soltanto utenti autorizzati. Account sconosciuti, indirizzi email strani o utenti creati recentemente devono essere analizzati.

Contare gli utenti per ruolo

Con jq installato sul server puoi raggruppare gli utenti in base al ruolo:

user list --format=json | jq '[.[] | .roles[]] | group_by(.) | map({role: .[0], count: length})'

Un numero anomalo di amministratori o editor può indicare una configurazione errata o una compromissione.

Controllare l’indicizzazione del sito

L’opzione blog_public indica se WordPress è configurato per consentire l’indicizzazione:

option get blog_public

In un sito pubblico il valore dovrebbe generalmente essere 1. Il valore 0 può essere corretto per ambienti di staging o installazioni non ancora pubblicate.

Verificare i checksum del core

Per verificare l’integrità dei file ufficiali di WordPress:

core verify-checksums

Il comando confronta i file del core con i checksum pubblicati per la versione installata. File modificati, mancanti o aggiunti devono essere analizzati.

Per controllare soltanto il core, ignorando temi e plugin:

core verify-checksums --skip-themes --skip-plugins

Un risultato anomalo non dimostra automaticamente la presenza di malware. Un file può essere stato modificato legittimamente, ma la differenza deve essere verificata.

Controllare i mu-plugin

I mu-plugin vengono caricati automaticamente e possono non essere visibili nella normale lista dei plugin:

plugin list --status=must-use

Verifica che siano presenti soltanto componenti conosciuti, documentati e autorizzati.

Controllare gli eventi cron

Gli eventi cron eseguono importazioni, sincronizzazioni, backup, invio email e altre attività automatiche:

cron event list

Per un riepilogo più leggibile:

cron event list --fields=hook,next_run_relative,recurrence --format=table

Per testare il sistema cron:

cron test

Non cancellare un evento soltanto perché il nome non è familiare. Prima identifica il plugin o il tema che lo ha registrato.

Pulizia del database

Eliminare i transient scaduti

I transient sono dati temporanei utilizzati da WordPress e dai plugin. Per eliminare soltanto quelli scaduti:

transient delete --expired

Per eliminare tutti i transient:

transient delete --all

La seconda operazione deve essere eseguita con maggiore cautela, perché alcuni plugin potrebbero dover ricostruire dati temporanei o cache.

Svuotare la object cache

cache flush

Il comando è utile dopo aggiornamenti, modifiche al tema, variazioni nelle opzioni o cambiamenti ai prodotti WooCommerce.

La cache delle pagine, del server o della CDN potrebbe richiedere comandi separati.

Cercare opzioni sospette

Puoi cercare nelle opzioni alcuni pattern che meritano un’analisi:

db query "SELECT option_name, LENGTH(option_value) AS value_length FROM wp_options WHERE option_value LIKE '%eJzs%' OR option_value LIKE '%base64_encode%';"

Sostituisci wp_options con il nome reale della tabella se il sito utilizza un prefisso diverso.

Le stringhe compresse, serializzate o codificate non sono automaticamente malevole. Possono appartenere a plugin legittimi.

Questa query serve soltanto a individuare elementi da esaminare. Non cancellare direttamente i risultati senza:

  • creare un backup;
  • esportare le righe interessate;
  • identificare il plugin che utilizza l’opzione;
  • verificare il contenuto completo;
  • controllare le dipendenze.

Controllo di plugin e temi

Elencare i plugin attivi

plugin list --status=active

Controlla nomi, versioni, stato e aggiornamenti disponibili.

Elencare tutti i plugin

plugin list --fields=name,status,version,update,update_version --format=table

Per visualizzare lo stato dettagliato di ogni plugin:

plugin list --field=name | while read plugin; do plugin status "$plugin"; done

Controllare il tema attivo

theme list --status=active

Controllare la versione di un tema

theme get nome-tema --field=version

Sostituisci nome-tema con lo slug reale del tema.

Modifiche inattese al tema devono essere confrontate con la cronologia degli interventi, con il repository o con i backup disponibili.

Aggiornamenti di WordPress

Controllare gli aggiornamenti del core

core check-update

Simulare l’aggiornamento dei plugin

plugin update --all --dry-run

Simulare l’aggiornamento dei temi

theme update --all --dry-run

Aggiornare il core

core update

Aggiornare il database WordPress

core update-db

Aggiornare tutti i plugin

plugin update --all

Aggiornare tutti i temi

theme update --all

Prima degli aggiornamenti crea sempre un backup e, quando possibile, esegui una prova in staging.

Dopo gli aggiornamenti controlla:

  • homepage;
  • login;
  • moduli;
  • menu;
  • pagine principali;
  • carrello e checkout;
  • email automatiche;
  • integrazioni esterne.

Monitoraggio degli utenti

Esportare gli utenti

user list --format=csv > /tmp/users_backup.csv

Per salvare uno storico con data e ora:

mkdir -p /var/backups/wordpress-audit
user list --format=csv > "/var/backups/wordpress-audit/users_$(date +%Y%m%d_%H%M%S).csv"

La directory deve essere protetta e non raggiungibile dal web, perché il file può contenere dati personali.

Controllare gli utenti creati in un mese

user list --fields=ID,user_login,user_email,user_registered --format=csv | grep "2026-09"

Per un elenco degli utenti più recenti:

user list --fields=ID,user_login,user_email,user_registered,roles --orderby=registered --order=DESC --format=table

Contare email sospette

db query "SELECT COUNT(*) AS suspicious_users FROM wp_users WHERE user_email LIKE '%.invalid%';"

Un indirizzo .invalid può appartenere a un test o a un’importazione legittima. Il risultato deve quindi essere verificato e non interpretato automaticamente come backdoor.

Eliminare un utente non autorizzato

user delete ID --yes

Prima di eliminare l’utente verifica che sia realmente non autorizzato, controlla eventuali contenuti associati e assicurati di avere un backup.

Per riassegnare i contenuti a un altro utente:

user delete ID --reassign=1 --yes

Query SQL per il controllo degli utenti

Contare tutti gli utenti

db query "SELECT COUNT(*) AS total_users FROM wp_users;"

Elencare gli utenti

db query "SELECT ID, user_login, user_email, user_registered FROM wp_users ORDER BY ID ASC;"

Individuare gli amministratori

db query "SELECT u.ID, u.user_login, u.user_email, u.user_registered FROM wp_users AS u INNER JOIN wp_usermeta AS um ON u.ID = um.user_id WHERE um.meta_key = 'wp_capabilities' AND um.meta_value LIKE '%administrator%';"

Se il prefisso è personalizzato, anche il valore di meta_key deve essere modificato. Con il prefisso site_, per esempio, il meta key potrebbe essere site_capabilities.

URL e permalink

Controllare home e site URL

option get home
option get siteurl

Verifica che gli URL siano corretti, utilizzino HTTPS e non contengano directory inattese.

Controllare la struttura dei permalink

rewrite structure

Rigenerare le regole dei permalink

rewrite flush

Utilizza questo comando con attenzione su server con regole personalizzate.

Controllare le sitemap

Il comando disponibile dipende dal plugin SEO installato. Se supportato:

sitemap list

In alternativa puoi cercare le opzioni relative alle sitemap:

option list --search="*sitemap*" --format=table

Non tutte le sitemap vengono registrate come opzioni WordPress, quindi il risultato dipende dall’estensione utilizzata.

Backup del database

Esportare il database

mkdir -p /var/backups/wordpress
db export "/var/backups/wordpress/backup_$(date +%Y%m%d_%H%M%S).sql"

Salva i backup in una directory non pubblica e, quando possibile, copiali anche su un sistema esterno.

Per verificare i file creati:

ls -lh /var/backups/wordpress/backup_*.sql

Un backup è utile soltanto se può essere ripristinato. Esegui periodicamente un test di importazione in un ambiente separato.

Backup completo

Il comando db export salva soltanto il database. Un backup completo deve comprendere anche:

  • core WordPress;
  • cartella wp-content;
  • tema attivo;
  • plugin;
  • media;
  • file di configurazione;
  • regole del server.

La procedura completa può essere gestita tramite gli strumenti di backup di Plesk o del provider.

Diagnosi rapida quotidiana

Per un controllo veloce puoi eseguire:

core version
option get home
option get siteurl
user list --role=administrator --format=csv
cron test
plugin list --status=must-use
db query "SELECT COUNT(*) AS total_users FROM wp_users;"

Puoi inoltre controllare le opzioni contenenti la parola admin:

option list --search="*admin*" --format=table | head -20

La parola “admin” non indica automaticamente un problema. Molti plugin legittimi utilizzano nomi di opzione simili.

Comandi WP-CLI per WooCommerce

WooCommerce dispone di comandi CLI specifici organizzati nel namespace wc. Per visualizzare quelli disponibili nella versione installata:

wc --help

Verificare WooCommerce

plugin get woocommerce --field=version

Per controllare lo stato del plugin:

plugin status woocommerce

Puoi anche verificare la versione memorizzata nelle opzioni:

option get woocommerce_version

Elencare gli ordini recenti

wc shop_order list --number=20 --fields=id,status,total,currency,date,customer_id --format=table

In alcune versioni può essere disponibile la forma:

wc order list --number=20 --fields=id,status,total,currency,date,customer_id --format=table

Verifica sempre i comandi disponibili con wc --help.

Controllare gli ordini in elaborazione

wc order list --status=processing --number=50 --fields=id,status,total,date,customer_id --format=table

Controllare gli ordini in attesa di pagamento

wc order list --status=pending --number=50 --fields=id,status,total,date,customer_id --format=table

Controllare gli ordini falliti

wc order list --status=failed --number=50 --fields=id,status,total,date,customer_id --format=table

Un numero elevato di ordini pendenti o falliti può indicare problemi con gateway di pagamento, cron, webhook, email o integrazioni esterne.

Visualizzare un ordine specifico

wc order get ID

Sostituisci ID con l’identificativo dell’ordine.

Elencare i prodotti

wc product list --number=100 --fields=id,name,sku,type,status,stock_status,stock_quantity,price --format=table

Controllare i prodotti esauriti

wc product list --stock_status=outofstock --number=100 --fields=id,name,sku,stock_status,stock_quantity --format=table

Controllare i prodotti in bozza

wc product list --status=draft --number=100 --fields=id,name,sku,status --format=table

Controllare le categorie

wc product_cat list --number=100 --fields=id,name,slug,count --format=table

Controllare i clienti

wc customer list --number=100 --fields=id,email,first_name,last_name,date_created --format=table

Controllare i gateway di pagamento

wc payment_gateway list

Verifica che siano attivi soltanto i metodi autorizzati.

Controllare le zone di spedizione

wc shipping_zone list

Per elencare i metodi associati a una zona:

wc shipping_zone_method list ZONE_ID

Sostituisci ZONE_ID con l’identificativo reale.

Strumenti di manutenzione WooCommerce

Elencare gli strumenti disponibili

wc tool list

Svuotare i transient WooCommerce

wc tool run clear_transients --user=1

Eliminare i transient scaduti

wc tool run clear_expired_transients --user=1

Aggiornare il database WooCommerce

wc update

Gli strumenti disponibili possono variare in base alla versione installata. Controlla sempre:

wc tool --help

Controllo dei pagamenti

I pagamenti devono essere verificati sia in WooCommerce sia nel pannello del provider esterno.

Puoi iniziare controllando i gateway:

wc payment_gateway list

Poi puoi elencare gli ordini sospesi o falliti:

wc order list --status=pending --number=100 --fields=id,status,total,payment_method,date --format=table
wc order list --status=failed --number=100 --fields=id,status,total,payment_method,date --format=table

Questi comandi non dimostrano da soli che un pagamento sia fallito. Confronta sempre i dati con:

  • log del gateway;
  • log di WooCommerce;
  • log PHP;
  • notifiche webhook;
  • pannello del provider;
  • stato reale della transazione.

Non modificare automaticamente lo stato di un ordine senza avere verificato il pagamento sul provider.

Controllo di Action Scheduler

WooCommerce e molti plugin utilizzano Action Scheduler per eseguire processi asincroni e pianificati.

Se il comando è disponibile:

action-scheduler action list --status=pending --per-page=100
action-scheduler action list --status=failed --per-page=100

Un accumulo di azioni in attesa o fallite può indicare problemi con cron, API, gateway o plugin.

Non eliminare in massa le azioni fallite prima di avere identificato l’hook e il componente che le ha generate.

Controllo delle sincronizzazioni

Se WooCommerce è collegato a un gestionale o a un sistema esterno, controlla periodicamente:

  • cron di sincronizzazione;
  • prodotti non aggiornati;
  • SKU mancanti;
  • quantità non sincronizzate;
  • ordini non trasferiti;
  • duplicati;
  • errori di autenticazione;
  • log delle richieste API.

Per visualizzare gli eventi cron:

cron event list --fields=hook,next_run_relative,recurrence --format=table

Per controllare gli ordini recenti:

wc order list --number=100 --orderby=date --order=desc --fields=id,status,total,date --format=table

Una buona integrazione dovrebbe utilizzare identificativi univoci e conservare un riferimento tra l’ordine WooCommerce e il record del gestionale.

Routine di manutenzione

Controlli giornalieri

core version
option get home
option get siteurl
user list --role=administrator --format=csv
cron test
cron event list --fields=hook,next_run_relative,recurrence --format=table
wc order list --status=failed --number=50 --fields=id,status,total,date --format=table

Controlli settimanali

core verify-checksums
plugin list --update=available
theme list --update=available
transient delete --expired
wc tool run clear_expired_transients --user=1
wc order list --status=pending --number=100 --fields=id,status,total,date --format=table

Controlli mensili

user list --format=csv
plugin list --format=table
theme list --format=table
core check-update
cron event list

Gli aggiornamenti dovrebbero essere eseguiti dopo il backup e, quando possibile, dopo una verifica in staging.

Backup periodico del database

Il percorso del backup deve essere generico e adattato alla configurazione del server.

mkdir -p /var/backups/wordpress
db export "/var/backups/wordpress/backup_$(date +%Y%m%d_%H%M%S).sql"

Per controllare il file:

ls -lh /var/backups/wordpress/backup_*.sql

Non salvare i backup in una directory pubblica. Un file SQL può contenere dati personali, configurazioni e informazioni riservate.

Il backup del database non comprende i file. Per un ripristino completo devi includere anche tema, plugin, media, configurazione e regole del server.

Esempio di script di audit

Puoi raccogliere i principali dati di controllo in un report:

#!/bin/bash

REPORT_DIR="/var/backups/wordpress-audit"
DATE="$(date +%Y%m%d_%H%M%S)"
REPORT="${REPORT_DIR}/audit_${DATE}.txt"

mkdir -p "$REPORT_DIR"

{
  echo "=== AUDIT WORDPRESS: ${DATE} ==="
  echo
  echo "=== CORE ==="
  core version
  core check-update
  core verify-checksums
  echo
  echo "=== URL ==="
  option get home
  option get siteurl
  echo
  echo "=== AMMINISTRATORI ==="
  user list --role=administrator --format=table
  echo
  echo "=== PLUGIN ==="
  plugin list --format=table
  echo
  echo "=== TEMI ==="
  theme list --format=table
  echo
  echo "=== CRON ==="
  cron event list --fields=hook,next_run_relative,recurrence --format=table
  echo
  echo "=== ORDINI RECENTI ==="
  wc order list --number=20 --fields=id,status,total,date --format=table
  echo
  echo "=== ORDINI FALLITI ==="
  wc order list --status=failed --number=50 --fields=id,status,total,date --format=table
} > "$REPORT"

echo "Report salvato in: $REPORT"

Adatta soltanto la directory di destinazione alle tue necessità. Non inserire password, token o chiavi API nello script.

I report possono contenere informazioni personali e devono essere protetti da accessi non autorizzati.

Comandi da usare con cautela

Alcuni comandi modificano o cancellano dati e non dovrebbero essere automatizzati senza controlli:

user delete ID --yes
transient delete --all
db query "DELETE FROM ..."
plugin update --all
theme update --all
core update
rewrite flush
wc update

Prima di eseguirli:

  • crea un backup;
  • verifica il sito corretto;
  • controlla la sintassi con --help;
  • testa in staging;
  • salva l’output del comando;
  • verifica il sito pubblico.

Raccomandazioni finali

Questi comandi sono utili per individuare anomalie, ma non sostituiscono un sistema completo di sicurezza e monitoraggio.

Una corretta manutenzione dovrebbe comprendere:

  • backup automatici e verificati;
  • aggiornamenti pianificati;
  • controllo degli amministratori;
  • verifica dell’integrità del core;
  • analisi di plugin e mu-plugin;
  • controllo degli eventi cron;
  • monitoraggio del server;
  • controllo del database;
  • verifica degli ordini WooCommerce;
  • controllo dei pagamenti;
  • analisi dei log;
  • procedura di ripristino documentata.

Se rilevi utenti amministratori sconosciuti, file modificati, redirect sospetti, opzioni anomale o ordini non autorizzati, non limitarti a cancellare il singolo elemento. Potrebbe esserci una vulnerabilità ancora attiva o una backdoor.

In caso di compromissione puoi approfondire il mio servizio di ripristino WordPress.

Conclusione

WP-CLI permette di trasformare la manutenzione di WordPress in un processo più rapido, ripetibile e controllabile.

I comandi dedicati a utenti, plugin, temi, database, cron, backup e checksum aiutano a individuare anomalie prima che diventino problemi gravi. Con WooCommerce è inoltre possibile controllare ordini, prodotti, clienti, pagamenti, strumenti di pulizia e processi pianificati.

La manutenzione più efficace è quella eseguita con regolarità, documentata e preceduta da backup.

Utilizza i comandi di sola lettura per i controlli periodici e riserva le operazioni distruttive o gli aggiornamenti a procedure pianificate, con verifiche e possibilità di ripristino.

Posso aiutarti? Clicca qui!