13 min. citiți

WP-CLI: Ghidul complet pentru gestionarea WordPress din linia de comandă

WP-CLI este instrumentul oficial de linie de comandă pentru gestionarea instalațiilor WordPress direct din terminal, fără a deschide vreodată un browser. Dacă ați petrecut vreodată o după-amiază făcând clic pe tabloul de bord de administrare WordPress pentru a actualiza pluginuri pe mai multe site-uri, știți deja de ce există acest instrument.

În acest ghid, veți învăța totul, de la instalarea WP-CLI pe Linux, macOS și Windows la automatizarea sarcinilor complexe de întreținere cu scripturi și fișiere de configurare. Fie că gestionați un singur blog sau zeci de site-uri client, stăpânirea WP-CLI va schimba fundamental modul în care lucrați cu WordPress.

Ce veți învăța:

Cum să instalați și să configurați WP-CLI pe diferite sisteme de operare
Comenzi esențiale pentru gestionarea plugin-urilor, temelor, utilizatorilor și conținutului
Operațiuni cu baze de date, inclusiv exporturi, importuri și căutare-înlocuire sigură
Tehnici de automatizare utilizând scripturi, aliasuri și cron jobs
Cele mai bune practici pentru a evita capcanele comune atunci când lucrați din terminal

Ce este WP-CLI? (Explicație rapidă mai întâi)

WP-CLI vine de la WordPress Command Line Interface – un instrument open-source care vă permite să gestionați site-urile WordPress în întregime din terminal. În loc să vă conectați la wp-admin și să navigați prin meniuri, rulați comenzi precum wp plugin update --all și urmăriți cum întregul pachet de pluginuri se actualizează în câteva secunde.

Proiectul a început în jurul anului 2011, fiind creat de dezvoltatori care doreau o modalitate mai rapidă de a gestiona WordPress la scară largă. În 2017, s-a mutat sub umbrela oficială WordPress.org și este acum întreținut de o echipă dedicată de colaboratori, inclusiv Alain Schlesser și Daniel Bachhuber.

Iată ce trebuie să știți despre WP-CLI:

Versiunea stabilă curentă: Seria WP-CLI 2.x
Compatibilitate WordPress: Funcționează cu WordPress 5.x până la 6.x (și istoric înapoi la 3.7)
Cerințe PHP: PHP 7.4+ sau 8.x recomandat pentru securitate și performanță
Ecosistem de comenzi: Peste 40 de comenzi părinte care acoperă practic fiecare operațiune WordPress
Utilizatori principali: Dezvoltatori, agenții, ingineri DevOps și utilizatori puternici care gestionează site-uri complexe sau multiple
Distribuție: Disponibil ca un fișier PHAR, prin intermediul managerilor de pachete sau preinstalat pe multe gazde WordPress gestionate

Principalele beneficii ale utilizării WP-CLI

Odată ce înțelegeți de ce există WP-CLI, curba de învățare devine mult mai ușor de justificat. Această secțiune explică avantajele concrete care fac ca acest instrument să merite timpul dumneavoastră.

Economie de timp la sarcinile repetitive
Actualizarea a 20 de pluginuri prin tabloul de bord WordPress înseamnă 20 de încărcări de pagină, 20 de clicuri și urmărirea a 20 de bare de progres. Cu WP-CLI, executați wp plugin update --all o singură dată și treceți mai departe. Pentru agențiile care gestionează mai multe site-uri ale clienților, această diferență se transformă în ore economisite în fiecare săptămână.

Operațiuni în masă și automate
Luați în considerare un scenariu în care pregătiți 15 magazine WooCommerce pentru Black Friday. Trebuie să actualizați plugin-urile, să ștergeți memoria cache și să verificați integritatea bazei de date pe fiecare site. WP-CLI vă permite să creați un script pentru această întreagă secvență și să o executați pe toate site-urile în câteva minute, nu în câteva ore. Capacitățile cheie de automatizare includ:

Actualizarea tuturor plugin-urilor în mai multe instalații cu un singur script
Crearea de utilizatori în masă cu roluri predefinite
Executarea întreținerii nocturne prin cron (optimizarea bazei de date, curățarea tranzitorie)
Implementarea configurațiilor identice WordPress în medii noi

Fiabilitatea operațiunilor bazate pe browser
Operațiunile bazate pe browser se lovesc de timeout HTTP. Importurile mari de baze de date eșuează în mijlocul procesului. Operațiunile search-replace corup datele serializate atunci când sunt efectuate cu SQL brut. WP-CLI evită toate aceste probleme deoarece rulează direct pe server, fără constrângeri de timp, iar comanda sa search-replace gestionează corect structurile de date serializate.

Control direct asupra sistemelor WordPress de bază
Dintr-un singur terminal, puteți:

Exportați și importați baza de date WordPress
Modificați setările wp-config.php
Inspectarea și declanșarea evenimentelor wp-cron
Activarea și dezactivarea modului de întreținere
Rulați cod PHP arbitrar în contextul WordPress

Sarcină redusă pe wp-admin
Pe serverele de producție aglomerate, fiecare încărcare a paginii tabloului de bord administrativ consumă resurse. Executarea operațiunilor de întreținere prin WP-CLI menține această sarcină în afara serverului web, ceea ce este important în perioadele cu trafic ridicat.

Cerințe WP-CLI și medii acceptate

Înainte de a instala WP-CLI, trebuie să confirmați că serverul dvs. sau mediul local îndeplinește cerințele de bază. Vestea bună este că majoritatea configurațiilor WordPress moderne se califică deja.

Cerințe pentru versiunea PHP:

Minim: PHP 5.6 (deși acesta este învechit)
Recomandat: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 sau 8.5 pentru securitate și performanță în 2026

Compatibilitatea cu versiunea WordPress:

Suport istoric: WordPress 3.7 și mai nou
Țintă modernă: WordPress 5.0 până la 6.7+ pentru proiectele curente

Așteptările sistemului de operare:

Cel mai bun suport: Sisteme de tip UNIX (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
Windows: Suportat prin WSL (Windows Subsystem for Linux) sau prin instalarea nativă PHP

Cerințe suplimentare:

PHP disponibil pe linia de comandă (binarul php trebuie să fie în PATH)
cURL sau wget pentru descărcarea fișierului wp-cli.phar
Acces SSH pentru servere la distanță (majoritatea planurilor de găzduire WordPress gestionate includ acest lucru în mod implicit)

Multe gazde populare precum Kinsta, SiteGround și DreamHost au acum WP-CLI preinstalat. WordPress.com include, de asemenea, WP-CLI pentru site-urile cu acces SSH activat.

Cum să instalați WP-CLI pe Linux și macOS

Metoda standard de instalare utilizează fișierul oficial PHAR (PHP Archive). Acest proces funcționează pe terminalele Ubuntu, Debian, CentOS, Fedora și macOS.

Pasul 1: Descărcați fișierul PHAR
Deschideți terminalul și descărcați wp-cli.phar utilizând curl:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Alternativ, utilizați wget:

wget https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Pasul 2: Verificarea descărcării (opțional, dar recomandat)
Comparați suma de verificare SHA-256 cu valoarea oficială publicată în documentația WP-CLI pentru a vă asigura că fișierul nu a fost modificat în timpul descărcării:

sha256sum wp-cli.phar

Comparați rezultatul cu suma de control listată pe site-ul oficial WP-CLI.

Pasul 3: Testați fișierul PHAR
Confirmați că fișierul php funcționează:

php wp-cli.phar --info

Ar trebui să vedeți rezultatele care afișează versiunea WP-CLI, versiunea PHP și informații despre sistem.

Pasul 4: Faceți-l executabil și mutați-l în PATH
Marcați fișierul ca executabil și mutați-l într-un director din PATH-ul sistemului dvs:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Comanda sudo este de obicei necesară deoarece /usr/local/bin este un director de sistem. Evitați instalarea WP-CLI ca root dacă îl veți rula în principal ca utilizator obișnuit.

Pasul 5: Verificarea instalării globale
Confirmați că WP-CLI este acum disponibil la nivel global:

wp --info
wp cli version

Ar trebui să vedeți rezultatul care confirmă versiunea wp cli, locația binarului PHP și detaliile sistemului de operare. În acest moment, aveți WP-CLI instalat și gata de utilizare.

Cum să instalați WP-CLI pe Windows

Utilizatorii Windows au la dispoziție două căi principale: utilizarea Windows Subsystem for Linux (WSL) sau configurarea unei instalări native Windows. WSL oferă o experiență mai apropiată de Linux și este în general recomandat.

Opțiunea 1: Utilizarea WSL (recomandată)
Mai întâi, activați WSL pe Windows 10 sau 11:

wsl --install

Instalați Ubuntu din Microsoft Store, apoi lansați terminalul Ubuntu. De acolo, urmați exact aceiași pași de instalare Linux descriși în secțiunea anterioară – descărcați fișierul phar, faceți-l executabil și mutați-l la /usr/local/bin/wp.

Opțiunea 2: Instalare nativă Windows
Pentru o instalare nativă, aveți nevoie de PHP pentru Windows instalat cu executabilul php disponibil în PATH-ul sistemului.

Descărcați și instalați PHP de pe site-ul oficial PHP pentru Windows
Adăugați directorul PHP la variabila de mediu Windows PATH
Confirmați că PHP funcționează deschizând Command Prompt și executând php -v

Apoi, descărcați fișierul WP-CLI PHAR:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Windows include curl în mod implicit din 2018, astfel încât acest lucru ar trebui să funcționeze fără configurare suplimentară. Creați un dosar pentru WP-CLI (de exemplu, C:\wp-cli) și mutați fișierul descărcat acolo.

Apoi creați un fișier batch wrapper numit wp.bat în același dosar:

@echo off
php "C:\wp-cli\wp-cli.phar" %*

Adăugați C:\wp-cli la variabila de mediu PATH a sistemului dumneavoastră. Acum deschideți o nouă fereastră Prompt de comandă sau PowerShell și verificați:

wp --info

Ar trebui să vedeți versiunea WP-CLI și detaliile mediului, confirmând că WP-CLI este instalat corect.

Utilizarea WP-CLI de bază și obținerea de ajutor

Odată cu instalarea WP-CLI, trebuie să înțelegeți modelul de bază al comenzilor înainte de a intra în operațiuni specifice. Toate comenzile WP-CLI urmează această structură:

wp <command> <subcommand> [options]

Comenzile sunt executate din directorul de instalare WordPress – folderul care conține wp-config.php. Dacă sunteți în altă parte, puteți specifica calea cu --path=/var/www/html/mysite.

Verificarea mediului
Începeți prin a vă confirma configurația:

wp --info

Aceasta afișează versiunea WP-CLI, versiunea PHP, calea binară PHP, sistemul de operare și alte detalii de mediu. Pentru a vedea doar versiunea WP-CLI:

wp cli version

Explorarea comenzilor disponibile
Pentru a lista toate comenzile wp cli disponibile:

wp help

Pentru ajutor cu privire la o anumită comandă:

wp help plugin
wp help core update

De asemenea, puteți adăuga --help la orice comandă:

wp user --help

Ieșirea de ajutor se afișează într-un pager similar paginilor de manual Unix. Apăsați q pentru a ieși.

Primele comenzi de încercat:

wp core version – afișează versiunea WordPress
wp plugin list – afișează toate plugin-urile WordPress instalate cu starea lor
wp theme list – arată temele instalate
wp user list – listează toți utilizatorii de pe site

Aceste comenzi numai pentru citire vă permit să explorați site-ul WordPress fără să modificați nimic, ceea ce este perfect pentru a vă acomoda cu interfața.

Instalarea și configurarea WordPress cu WP-CLI

WP-CLI poate efectua o nouă instalare completă WordPress mai rapid decât instalatorul tradițional bazat pe web. Acest lucru este deosebit de valoros atunci când creați medii de dezvoltare sau implementați site-uri noi în mod programatic.

Condiții prealabile
Înainte de a executa comenzile de instalare, trebuie să aveți pregătită o bază de date MySQL sau MariaDB. Pentru acest exemplu, presupunem că ați creat:

Numele bazei de date: wpsite_db
Utilizator bază de date: wpsite_user
Parolă: securepassword123
Gazdă: localhost

Pasul 1: Descărcați fișierele de bază WordPress
Navigați la directorul de instalare dorit și descărcați WordPress core:

wp core download

Aceasta obține cea mai recentă versiune WordPress. Pentru a specifica o versiune sau o localitate:

wp core download --version=6.4.2 --locale=fr_FR

După finalizare, veți vedea confirmarea că WordPress a fost descărcat cu succes.

Pasul 2: Generarea wp-config.php
Creați fișierul de configurare utilizând wp config create:

wp config create --dbname=wpsite_db --dbuser=wpsite_user --dbpass=securepassword123 --dbhost=localhost

Acest lucru generează un wp-config.php complet cu datele de identificare ale bazei de date și sărurile de securitate generate automat.

Pasul 3: Rulați instalarea
Acum instalați WordPress cu detaliile site-ului dvs:

wp core install --url=https://example.com --title="My New Site" --admin_user=admin --admin_password=strongpassword [email protected]

Veți vedea mesajul „WordPress instalat cu succes” și site-ul dvs. este gata de utilizare.

Instalare multisite
Pentru rețele WordPress multisite, utilizați varianta multisite. WP-CLI poate configura instalații multisite cu:

wp core multisite-install --url=https://example.com --title="My Network" --admin_user=admin --admin_password=strongpassword [email protected]

Gestionarea temelor cu WP-CLI

WP-CLI gestionează toate operațiunile legate de teme fără a necesita acces la tabloul de bord de administrare WordPress. Puteți lista, instala, activa, actualiza și șterge teme direct din terminal.

Listare teme instalate
Pentru a vedea toate temele instalate în prezent:

wp theme list

Exemplu de ieșire:

nume	statut	actualizare	versiune
douăzeci și douăzeci și patru	activă	none	1.0
douăzeci și douăzeci și trei	inactiv	none	1.2
astra	inactiv	disponibile	4.5.0

Activarea unei teme
Treceți la o altă temă:

wp theme activate astra

Acest lucru schimbă imediat tema activă. Revenirea la o temă implicită este utilă pentru depanarea problemelor legate de temă:

wp theme activate twentytwentyfour

Instalarea de teme noi
Instalați o temă din depozitul WordPress.org:

wp theme install astra

Instalați și activați într-o singură comandă:

wp theme install astra --activate

Actualizarea temelor
Actualizați o temă specifică:

wp theme update astra

Sau actualizați toate temele odată:

wp theme update --all

Ștergerea temelor
Eliminați o temă de care nu mai aveți nevoie:

wp theme delete twentytwentythree

Gestionarea plugin-urilor cu WP-CLI

Gestionarea pluginurilor este domeniul în care WP-CLI economisește cel mai mult timp. Puteți efectua operațiuni în masă care ar necesita zeci de clicuri în tabloul de bord.

Listarea plugin-urilor

wp plugin list

Exemplu de ieșire:

nume	statut	actualizare	versiune
woocommerce	activă	none	8.5.1
yoast-seo	activă	disponibile	21.0
elementor	inactiv	none	3.18.0

Instalarea pluginurilor
Instalați un plugin după slug-ul său:

wp plugin install woocommerce

Instalați și activați:

wp plugin install yoast-seo --activate

Activarea și dezactivarea
Activați un plugin:

wp plugin activate elementor

Dezactivați un plugin (util pentru depanare):

wp plugin deactivate elementor

Dezactivați toate plugin-urile deodată (salvator pentru depanarea „White Screen of Death”):

wp plugin deactivate --all

Actualizarea pluginurilor
Actualizați un plugin specific:

wp plugin update yoast-seo

Actualizați toate plugin-urile:

wp plugin update --all

De asemenea, puteți exclude anumite plugin-uri de la o actualizare în masă:

wp plugin update --all --exclude=woocommerce

Actualizarea și repararea WordPress Core

Păstrarea WordPress actualizat este esențială pentru securitate. WP-CLI face acest proces transparent și controlabil.

Verificarea actualizărilor

wp core check-update

Actualizarea WordPress
Actualizați la cea mai recentă versiune:

wp core update

După o actualizare de bază, este o bună practică să actualizați schema bazei de date:

wp core update-db

Verificarea sumelor de control
Dacă suspectați că site-ul dvs. a fost piratat, puteți verifica dacă fișierele de bază nu au fost modificate:

wp core verify-checksums

Aceasta compară fișierele dvs. cu sumele de verificare oficiale ale depozitului WordPress.

Reinstalarea Core
Dacă fișierele sunt corupte, puteți forța o reinstalare fără a vă afecta conținutul:

wp core download --force --skip-content

Gestionarea conținutului, a utilizatorilor și a bazei de date

WP-CLI vă permite să interacționați direct cu datele site-ului dvs.

Gestionarea utilizatorilor
Listați utilizatorii:

wp user list

Creați un nou administrator:

wp user create newadmin [email protected] --role=administrator --user_pass=securepass123

Actualizați parola unui utilizator:

wp user update 1 --user_pass=newpassword

Ștergeți un utilizator și reatribuiți-i conținutul:

wp user delete 5 --reassign=1

Operațiuni cu baza de date
Exportați baza de date într-un fișier:

wp db export backup.sql

Importați o bază de date dintr-un fișier:

wp db import backup.sql

Optimizați baza de date:

wp db optimize

Deschideți o consolă MySQL conectată direct la baza dvs. de date WordPress:

wp db cli

Căutare și înlocuire (modul corect)

Mutarea manuală a unui site WordPress pe un domeniu nou este riscantă deoarece datele sunt adesea serializate în baza de date. O simplă căutare și înlocuire SQL va rupe widget-urile și opțiunile temei. WP-CLI gestionează serializarea corect.

Căutare-înlocuire standard

wp search-replace 'http://old-domain.com' 'https://new-domain.com'

Rulare uscată (previzualizare)
Verificați întotdeauna ce se va schimba înainte de a executa comanda:

wp search-replace 'http://old-domain.com' 'https://new-domain.com' --dry-run

Export cu înlocuire
Puteți exporta o bază de date cu înlocuirile efectuate în fișier, lăsând baza de date activă neatinsă:

wp search-replace 'old.com' 'new.com' --export=migrated-db.sql

Întreținere avansată: Cron și Object Cache

Gestionarea Cron Jobs
Vizualizați evenimentele programate:

wp cron event list

Rulați imediat toate evenimentele cron datorate:

wp cron event run --due-now

Gestionarea tranzienților și a cache-ului
Ștergeți cache-ul obiectului:

wp cache flush

Ștergeți toate tranzitorii expirate:

wp transient delete --expired

Automatizarea sarcinilor cu ajutorul scripturilor

Puteți combina comenzile WP-CLI în scripturi Bash pentru întreținere automată.

Exemplu: Script de întreținere săptămânală
Creați un fișier numit maintain.sh:

#!/bin/bash
# Update everything
wp core update
wp core update-db
wp plugin update --all
wp theme update --all

# Cleanup
wp transient delete --expired
wp cache flush
wp db optimize

echo "Maintenance complete."

Faceți-l executabil (chmod +x maintain.sh) și executați-l pentru a efectua întreținerea completă a site-ului în câteva secunde.

Utilizarea WP-CLI la distanță prin SSH

Nu trebuie să vă conectați la server pentru a executa comenzi dacă configurați aliasuri.

În fișierul dvs. local wp-cli.yml:

@prod:
  ssh: [email protected]/var/www/html
@dev:
  ssh: [email protected]/var/www/html

Acum puteți rula comenzi pe serverul de la distanță de pe calculatorul dvs. local:

wp @prod plugin list
wp @dev core version

Cele mai bune practici

Faceți întotdeauna copii de rezervă: Înainte de a executa actualizări în masă sau comenzi de căutare-înlocuire, executați wp db export.
Utilizați Dry Run: Pentru căutare-înlocuire, utilizați întotdeauna mai întâi --dry-run.
Nu rulați ca Root: WP-CLI vă avertizează dacă rulați ca root. Este mai sigur să rulați ca utilizator al serverului web (de exemplu, www-data) sau contul dvs. de utilizator specific.
Testați pe Staging: Utilizați WP-CLI pentru a vă clona site-ul de producție în staging, testați-vă scripturile de actualizare acolo și apoi aplicați-le în producție.

Concluzie

WP-CLI transformă gestionarea WordPress dintr-o serie de clicuri în operațiuni raționalizate, programabile. Începând cu comenzi simple, cum ar fi verificarea versiunilor și listarea plugin-urilor, se construiește fundația pentru automatizarea avansată. Integrarea WP-CLI în fluxul dvs. de lucru astăzi va economisi nenumărate ore în cadrul proiectelor dvs. WordPress.