wp option get / update în WordPress

wp option get <key> [--format=<format>]
wp option update <key> [<value>] [--autoload=<autoload>] [--format=<format>]
wp option list [--search=<pattern>] [--fields=<fields>] [--format=<format>]

Ce face wp option get / update

Opțiunile sunt setările site-ului salvate în tabelul wp_options: numele site-ului (blogname), descrierea (blogdescription), adresa (home, siteurl), e-mailul administratorului și setările pluginurilor. wp option get afișează valoarea unei opțiuni, iar wp option update o schimbă; dacă opțiunea nu există, update o creează.

wp option list arată opțiunile și valorile lor într-un tabel. Cu --search filtrezi după nume, folosind * și ? ca metacaractere, iar cu --autoload=on vezi doar opțiunile încărcate automat la fiecare cerere. Formatul total_bytes arată mărimea totală a opțiunilor găsite, util când site-ul încarcă prea multe date la fiecare pagină.

Valorile complexe (tablouri PHP salvate serializat) se citesc și se scriu mai sigur cu --format=json. Comanda update are și aliasul wp option set.

Parametri

Parametru	Descriere
<key>	Numele opțiunii (de exemplu blogname, admin_email).
<value>	Noua valoare, la update. Dacă lipsește, valoarea se citește din STDIN.
--format=<format>	La get: var_export (implicit), json, yaml. La update: plaintext (implicit) sau json. La list: table (implicit), json, csv, count, yaml, total_bytes.
--autoload=<autoload>	La update: dacă opțiunea se încarcă automat (on, off, yes, no). La list: on arată doar opțiunile cu autoload, off doar pe celelalte.
--search=<pattern>	La list: filtrează după numele opțiunii, cu metacaracterele * și ?.
--exclude=<pattern>	La list: exclude opțiunile al căror nume se potrivește cu modelul.
--fields=<fields>	La list: coloanele afișate. Implicit option_name și option_value; opțional autoload și size_bytes.
--orderby=<fields> / --order=<order>	La list: sortare după option_id (implicit), option_name sau option_value, crescător (asc, implicit) sau descrescător (desc).

Exemple

Exemplul 1: Schimbarea numelui site-ului

Citești valoarea veche, o înlocuiești și verifici rezultatul. Ghilimelele sunt necesare pentru că valoarea conține un spațiu.

wp option get blogname
wp option update blogname "Cafenea Iași"
wp option get blogname

Ieșire în terminal

Blogul meu
Success: Updated 'blogname' option.
Cafenea Iași

Exemplul 2: Listarea opțiunilor care încep cu „blog”

Filtrul --search acceptă metacaracterul *; pune modelul între ghilimele ca shell-ul să nu-l interpreteze.

wp option list --search="blog*"

Ieșire în terminal

+-----------------+-------------------------------+
| option_name     | option_value                  |
+-----------------+-------------------------------+
| blogname        | Cafenea Iași                  |
| blogdescription | Cafea de specialitate în Iași |
| blog_charset    | UTF-8                         |
| blog_public     | 1                             |
+-----------------+-------------------------------+

Exemplul 3: O opțiune proprie salvată ca JSON, fără autoload

Cu --format=json valoarea devine un tablou PHP în baza de date. --autoload=off evită încărcarea ei la fiecare cerere, dacă o folosești rar.

wp option update dex_setari '{"oras":"Cluj","moneda":"lei"}' --format=json --autoload=off
wp option get dex_setari --format=json

Ieșire în terminal

Success: Updated 'dex_setari' option.
{"oras":"Cluj","moneda":"lei"}

Greșeli frecvente

• Citirea unei opțiuni care nu există: wp option get se oprește cu Error: Could not get 'nume' option. Does it exist?. Verifică numele exact cu wp option list --search.
• Schimbarea doar a opțiunilor home și siteurl la mutarea site-ului pe alt domeniu. Linkurile din articole și din setările pluginurilor rămân pe domeniul vechi; pentru ele folosește wp search-replace.
• Scrierea unei valori complexe ca text simplu: fără --format=json, textul {"oras":"Cluj"} se salvează ca șir de caractere, nu ca tablou, iar pluginul care o citește nu o mai înțelege.
• Mesajul Success: Value passed for 'nume' option is unchanged. nu e o eroare: valoarea nouă era identică cu cea veche, deci nu s-a schimbat nimic.

Comenzi înrudite

• wp search-replace: Caută și înlocuiește un text în toată baza de date WordPress, inclusiv în datele PHP serializate.
• wp transient: Citește, setează și șterge transients (valori temporare cu expirare) din terminal, inclusiv toate cele expirate.
• wp cache flush: Golește cache-ul de obiecte WordPress (Object Cache), de exemplu după o modificare directă în baza de date.
• get_option / update_option: Citesc, salvează și șterg setări permanente ale site-ului în tabelul wp_options (Options API).