wp shell în WordPress

wp shell [--basic]

Ce face wp shell

wp shell pornește o consolă PHP (REPL) în care WordPress e deja încărcat: poți apela orice funcție, clasă sau variabilă globală pe care ai folosi-o într-un plugin. Scrii o linie, apeși Enter și vezi imediat rezultatul.

În consola de bază a WP-CLI, după fiecare expresie apare => urmat de valoarea întoarsă, afișată ca la var_dump() (de exemplu string(13) "...", unde numărul e lungimea în octeți). Pentru instrucțiuni precum echo vezi doar ce afișează ele. Ieși cu exit sau Ctrl+D.

Dacă pe sistem e disponibil PsySH sau Boris, WP-CLI îl folosește în locul consolei proprii, iar aspectul rezultatelor diferă. Cu --basic forțezi consola de bază a WP-CLI.

Parametri

Parametru	Descriere
--basic	Folosește consola PHP proprie a WP-CLI, chiar dacă PsySH sau Boris sunt disponibile.

Exemple

Exemplul 1: Verificarea rapidă a unor valori

Liniile care încep cu wp> sunt scrise de tine. Cafenea Iași are 13 octeți, pentru că ș ocupă 2 octeți în UTF-8.

wp shell --basic

Ieșire în terminal

wp> get_option( 'blogname' );
=> string(13) "Cafenea Iași"
wp> count( get_users( array( 'role' => 'editor' ) ) );
=> int(2)
wp> exit

Exemplul 2: Testarea unei funcții din tema ta

Cu echo vezi doar textul afișat, fără =>. Funcția dex_pret_formatat() e un exemplu dintr-o temă copil.

wp shell --basic

Ieșire în terminal

wp> echo home_url( '/meniu/' );
https://exemplu.ro/meniu/
wp> echo dex_pret_formatat( 12.5 );
12,50 lei
wp> exit

Greșeli frecvente

• Testarea unor funcții care modifică date (wp_delete_post(), update_option()) pe site-ul de producție: consola lucrează pe baza de date reală, nu pe o copie.
• Așteptarea ca o modificare în fișierele temei să apară imediat în consola deja deschisă: codul PHP a fost încărcat la pornire. Închide consola și pornește-o din nou.
• Compararea rezultatelor cu ale unui coleg care are PsySH instalat: afișarea diferă. Folosiți amândoi --basic.

Comenzi înrudite

• wp eval: Execută cod PHP cu WordPress încărcat: o linie direct din terminal (eval) sau un fișier întreg (eval-file).
• wp option get / update: Citește, modifică și listează opțiunile WordPress din tabelul wp_options direct din terminal.