WP-CLI The command line interface for WordPress

WP-CLI este interfața liniei de comandă pentru WordPress. Poți actualiza module, configura instalări multisit și multe altele, fără să folosești un navigator web.

Întreținerea continuă este făcută posibilă de către:

Lansarea stabilă curentă este versiunea 2.9.0. Pentru anunțuri, urmărește @wpcli pe Twitter sau înregistrează-te pentru actualizări pe email. Consultă foaia de parcurs pentru o prezentare generală a ceea ce este plănuit pentru lansările viitoare.

Stare compilare Durata medie pentru rezolvarea unei probleme Procentul problemelor încă deschise

Legături rapide: Folosire | Instalare | Asistență | Extindere | Contribuție | Credite

Folosire

WP-CLI oferă o interfață de linie de comandă pentru multe acțiuni pe care le-ai putea executa în administrarea WordPress. De exemplu, wp plugin install --activate (documentație) îți permite să instalezi și să activezi un modul WordPress:

$ wp plugin install user-switching --activate
Installing User Switching (1.0.9)
Downloading installation package from https://downloads.wordpress.org/plugin/user-switching.1.0.9.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating 'user-switching'...
Plugin 'user-switching' activated.
Success: Installed 1 of 1 plugins.

WP-CLI include de asemenea comenzi pentru multe lucruri pe care nu le poți face în administrarea WordPress. De exemplu, wp transient delete --all (documentație) îți permite să ștergi unul sau toți tranzienții:

$ wp transient delete --all
Success: 34 transients deleted from the database.

Pentru o introducere mai completă a utilizării WP-CLI, citește Ghidul de inițiere rapidă. Sau vino alături de prietenii shell pentru a afla despre utilitățile liniei de comandă.

Deja te simți confortabil cu elementele de bază? Sari în lista completă de comenzi pentru informații detaliate despre gestionarea temelor și modulelor, importarea și exportarea datelor, efectuarea operațiunilor de căutare-înlocuire în baza de date și mai multe.

Instalare

Descărcarea fișierului Phar este metoda noastră de instalare recomandată pentru cei mai mulți utilizatori. Dacă ai nevoie, vezi și documentația noastră despre metodele de instalare alternative (Composer, Homebrew, Docker).

Înainte să instalezi WP-CLI, te rog asigură-te că mediul tău respectă cerințele minime:

Odată ce ai verificat cerințele, descarcă fișierul wp-cli.phar folosind wget sau curl:

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

Mai departe, verifică fișierul Phar pentru a vedea dacă funcționează:

php wp-cli.phar --info

Pentru a folosi WP-CLI din lina de comandă tastând wp, fă fișierul executabil și mută-l undeva în PATH-ul tău. De exemplu:

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

Dacă WP-CLI a fost instalat cu succes, ar trebui să vezi ceva asemănător când rulezi wp --info:

$ wp --info
OS:	Darwin 16.7.0 Darwin Kernel Version 16.7.0: Thu Jan 11 22:59:40 PST 2018; root:xnu-3789.73.8~1/RELEASE_X86_64 x86_64
Shell:	/bin/zsh
PHP binary:    /usr/local/bin/php
PHP version:    7.0.22
php.ini used:   /etc/local/etc/php/7.0/php.ini
WP-CLI root dir:        /home/wp-cli/.wp-cli/vendor/wp-cli/wp-cli
WP-CLI vendor dir:	    /home/wp-cli/.wp-cli/vendor
WP-CLI packages dir:    /home/wp-cli/.wp-cli/packages/
WP-CLI global config:   /home/wp-cli/.wp-cli/config.yml
WP-CLI project config:
WP-CLI version: 2.9.0

Actualizare

Poți actualiza WP-CLI cu wp cli update (documentație) sau repetând pașii de instalare.

Dacă WP-CLI este deținut de root sau un alt utilizator de sistem, trebuie să rulezi sudo wp cli update.

Vrei să trăiești viața la limită? Rulează wp cli update --nightly pentru a folosi ultima compilare nocturnă a WP-CLI. Compilarea nocturnă este mai mult sau mai puțin stabilă pentru a fi utilizată în mediul tău de dezvoltare și întotdeauna include ultimele și cele mai grozave funcționalități WP-CLI.

Auto-completare

WP-CLI vine de asemenea cu un script de auto-completare pentru Bash și ZSH. Doar descarcă wp-completion.bash și rulează source pe el din ~/.bash_profile:

source /FULL/PATH/TO/wp-completion.bash

Nu uita să rulezi apoi și source ~/.bash_profile.

Dacă folosești zsh pentru shell-ul tău, trebuie să încarci și să pornești bashcompinit înainte de comanda source. Pune următoarele în .zshrc:

autoload bashcompinit
bashcompinit
source /FULL/PATH/TO/wp-completion.bash

Asistență

Întreținătorii WP-CLI și contribuitorii au disponibilitate limitată pentru a răspunde la întrebările de asistență generală. Versiunea curentă WP-CLI este singura versiune oficială pentru care se oferă asistență.

Când ai nevoie de asistență, te rog să cauți mai întâi întrebarea ta în aceste locuri:

Dacă n-ai găsit un răspuns într-unul dintre locațiile de mai sus, poți:

Tichetele GitHub sunt menite să urmărească îmbunătățirile și erorile comenzilor existente, nu pentru asistență generală. Înainte să trimiți un raport de eroare, te rog să revezi cele mai bune practici ale noastre pentru a te asigura că problema ta este abordată în timp util.

Te rog nu adresa întrebări de asistență pe Twitter. Twitter nu este un loc acceptat pentru asistență pentru că: 1) este greu să ții conversații sub 280 de caractere și 2) Twitter nu este un loc unde cineva cu aceeași întrebare ca a ta poate căuta un răspuns într-o conversație anterioară.

Ține minte, libre != gratis; licența pentru sursa deschisă îți oferă libertate de folosire și modificare, dar nu angajamentul timpului altor persoane. Te rog fii respectuos și setează-ți așteptările în consecință.

Extindere

O comandă este unitatea atomică a funcționalității WP-CLI. wp plugin install (documentație) este o comandă. wp plugin activate (documentație) este alta.

WP-CLI suportă înregistrarea oricărei clase, funcție, sau închidere apelabilă ca o comandă. Ea citește detalii de folosire din blocul PHPdoc al funcției de apel. WP_CLI::add_command() (documentație) este folosită și intern, și pentru înregistrarea comenzilor din terțe părți.

/**
 * Delete an option from the database.
 *
 * Returns an error if the option didn't exist.
 *
 * ## OPTIONS
 *
 * <key>
 * : Key for the option.
 *
 * ## EXAMPLES
 *
 *     $ wp option delete my_option
 *     Success: Deleted 'my_option' option.
 */
$delete_option_cmd = function( $args ) {
	list( $key ) = $args;

	if ( ! delete_option( $key ) ) {
		WP_CLI::error( "Could not delete '$key' option. Does it exist?" );
	} else {
		WP_CLI::success( "Deleted '$key' option." );
	}
};
WP_CLI::add_command( 'option delete', $delete_option_cmd );

WP-CLI vine cu zeci de comenzi. Este mai ușor decât pare să creezi o comandă personalizată WP-CLI. Citește cartea de bucate a comenzilor pentru a afla mai multe. Răsfoiește documentația internă API pentru a descoperi o varietate de funcții ajutătoare pe care le poți folosi în comanda ta personalizată WP-CLI.

Contribuție

Apreciem că ai inițiativa de a contribui la WP-CLI. Datorită ție și comunității din jurul tău, acest WP-CLI este un proiect grozav.

Contribția nu este limitată doar la cod. Te încurajăm să contribui în modul care se potrivește cel mai bine abilităților tale, scriind tutoriale, oferind un demo la meetup-ul tău local, ajutând alți utilizatori cu întrebările lor de asistență sau revizuind documentația.

Citește prin ghidul de contribuire din manual pentru o introducere detaliată a modului în care te poți implica. Urmând aceste instrucțiuni te ajută să comunici că respecți timpul altor contribuitori în proiect. La rândul lor, ei vor face tot ce le stă în putință pentru a-ți întoarce acest respect atunci când lucrează cu tine, în zonele de fus orar și în întreaga lume.

Leadership

WP-CLI are un întreținător de proiect: schlessera.

Ocazional, noi acordăm acces de scriere contribuitorilor care au demonstrat, de-a lungul unei perioade de timp, că sunt capabili și investesc în avansarea proiectului.

Citește documentul de guvernanță din manual pentru mai multe detalii operaționale despre proiect.

Credite

Pe lângă bibliotecile definite în composer.json, am folosit cod sau idei din următoarele proiecte: