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.