12 min. läsa
WP-CLI: Den kompletta guiden till att hantera WordPress från kommandoraden
WP-CLI är det officiella kommandoradsverktyget för att hantera WordPress-installationer direkt från din terminal, utan att någonsin öppna en webbläsare. Om du någonsin har tillbringat en eftermiddag med att klicka dig igenom WordPress adminpanel för att uppdatera plugins på flera webbplatser, vet du redan varför det här verktyget finns.
I den här guiden får du lära dig allt från att installera WP-CLI på Linux, macOS och Windows till att automatisera komplexa underhållsuppgifter med skript och konfigurationsfiler. Oavsett om du hanterar en enda blogg eller dussintals kundwebbplatser kommer WP-CLI att i grunden förändra hur du arbetar med WordPress.
Vad du kommer att lära dig:
- Så här installerar och konfigurerar du WP-CLI på olika operativsystem
- Viktiga kommandon för hantering av plugins, teman, användare och innehåll
- Databasoperationer inklusive export, import och säker sökning-ersättning
- Automatiseringstekniker med hjälp av skript, alias och cron-jobb
- Bästa praxis för att undvika vanliga fallgropar när du arbetar från terminalen
Vad är WP-CLI? (Snabb förklaring först)
WP-CLI står för WordPress Command Line Interface – ett verktyg med öppen källkod som låter dig hantera WordPress-webbplatser helt från terminalen. Istället för att logga in på wp-admin och navigera genom menyer kör du kommandon som wp plugin update --all och ser hur hela din plugin-stack uppdateras på några sekunder.
Projektet startade runt 2011 och skapades av utvecklare som ville ha ett snabbare sätt att hantera WordPress i stor skala. År 2017 flyttade det in under det officiella WordPress.org-paraplyet och underhålls nu av ett dedikerat team av bidragsgivare, inklusive Alain Schlesser och Daniel Bachhuber.
Här är vad du behöver veta om WP-CLI:
- Nuvarande stabil version: WP-CLI 2.x-serien
- Kompatibilitet med WordPress: Fungerar med WordPress 5.x till och med 6.x (och historiskt tillbaka till 3.7)
- Krav på PHP: PHP 7.4+ eller 8.x rekommenderas för säkerhet och prestanda
- Ekosystem av kommandon: Över 40 överordnade kommandon som täcker praktiskt taget alla WordPress-operationer
- Primära användare: Utvecklare, byråer, DevOps-ingenjörer och power users som hanterar komplexa eller flera webbplatser
- Distribution: Tillgänglig som en PHAR-fil, via pakethanterare eller förinstallerad på många hanterade WordPress-värdar
Viktiga fördelar med att använda WP-CLI
När du väl förstår varför WP-CLI finns blir inlärningskurvan mycket lättare att motivera. I det här avsnittet förklaras de konkreta fördelar som gör att det här verktyget är värt din tid.
Tidsbesparingar på repetitiva uppgifter
Att uppdatera 20 plugins via WordPress instrumentpanel innebär 20 sidladdningar, 20 klick och att titta på 20 förloppsindikatorer. Med WP-CLI kör du wp plugin update --all en gång och går vidare. För byråer som hanterar flera kundwebbplatser innebär denna skillnad timmar som sparas varje vecka.
Bulk- och automatiserade operationer
Tänk dig ett scenario där du förbereder 15 WooCommerce-butiker för Black Friday. Du måste uppdatera plugins, rensa cacheminnen och verifiera databasintegriteten på varje webbplats. Med WP-CLI kan du skripta hela denna sekvens och utföra den på alla webbplatser på några minuter i stället för timmar. Viktiga automatiseringsfunktioner inkluderar:
- Uppdatering av alla plugins i flera installationer med ett enda skript
- Skapa användare i bulk med fördefinierade roller
- Utföra nattligt underhåll via cron (databasoptimering, transient cleanup)
- Distribuera identiska WordPress-konfigurationer till nya miljöer
Tillförlitlighet för webbläsarbaserade operationer
Webbläsaroperationer drabbas av HTTP-timeouts. Import av stora databaser misslyckas mitt i processen. Sök-ersätt-operationer korrumperar serialiserade data när de görs med rå SQL. WP-CLI undviker alla dessa problem eftersom det körs direkt på servern utan timeout-begränsningar och kommandot search-replace hanterar serialiserade datastrukturer på rätt sätt.
Direkt kontroll över WordPress kärnsystem
Från en terminal kan du:
- Exportera och importera WordPress-databasen
- Ändra
wp-config.phpinställningar - Inspektera och utlösa wp-cron-händelser
- Växla underhållsläge på och av
- Kör godtycklig PHP-kod i WordPress-kontexten
Minskad belastning på wp-admin
På upptagna produktionsservrar förbrukar varje sidbelastning på adminpanelen resurser. Genom att köra underhållsoperationer via WP-CLI hålls den belastningen borta från webbservern, vilket är viktigt under perioder med hög trafik.
WP-CLI-krav och miljöer som stöds
Innan du installerar WP-CLI måste du bekräfta att din server eller lokala miljö uppfyller de grundläggande kraven. Den goda nyheten är att de flesta moderna WordPress-installationer redan uppfyller kraven.
Krav på PHP-version:
- Minimum: PHP 5.6 (även om detta är föråldrat)
- Rekommenderas: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 eller 8.5 för säkerhet och prestanda år 2026
Kompatibilitet med WordPress-versioner:
- Historiskt stöd: WordPress 3.7 och nyare
- Modernt mål: WordPress 5.0 till 6.7+ för aktuella projekt
Förväntningar på operativsystemet:
- Bästa stöd: UNIX-liknande system (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
- Windows: Stöds via WSL (Windows Subsystem for Linux) eller inbyggd PHP-installation
Ytterligare krav:
- PHP tillgängligt på kommandoraden (binärfilen
phpmåste finnas i din PATH) - cURL eller wget för nedladdning av filen
wp-cli.phar - SSH-åtkomst för fjärrservrar (detta ingår som standard i de flesta hanterade WordPress hosting-abonnemang)
Många populära hosts som Kinsta, SiteGround och DreamHost levereras nu med WP-CLI förinstallerat. WordPress.com inkluderar också WP-CLI för webbplatser med SSH-åtkomst aktiverad.
Så här installerar du WP-CLI på Linux och macOS
Standardinstallationsmetoden använder den officiella PHAR-filen (PHP Archive). Denna process fungerar på Ubuntu-, Debian-, CentOS-, Fedora- och macOS-terminaler.
Steg 1: Ladda ner PHAR-filen
Öppna din terminal och ladda ner wp-cli.phar med hjälp av curl:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
Alternativt kan du använda wget:
wget https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
Steg 2: Verifiera nedladdningen (valfritt men rekommenderas)
Kontrollera SHA-256-kontrollsumman mot det officiella värdet som publiceras i WP-CLI-dokumentationen för att säkerställa att filen inte manipulerades under nedladdningen:
sha256sum wp-cli.phar
Jämför resultatet med den kontrollsumma som anges på den officiella WP-CLI-webbplatsen.
Steg 3: Testa filen PHAR
Bekräfta att php-filen fungerar:
php wp-cli.phar --info
Du bör se utdata som visar WP-CLI-version, PHP-version och systeminformation.
Steg 4: Gör den körbar och flytta till PATH
Markera filen som körbar och flytta den till en katalog i ditt systems PATH:
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
Kommandot sudo krävs vanligtvis eftersom /usr/local/bin är en systemkatalog. Undvik att installera WP-CLI som root om du främst kommer att köra det som en vanlig användare.
Steg 5: Verifiera global installation
Bekräfta att WP-CLI nu är globalt tillgängligt:
wp --info
wp cli version
Du bör se utdata som bekräftar wp cli-versionen, PHP-binärplats och operativsystemdetaljer. Nu har du WP-CLI installerat och redo att använda.
Hur man installerar WP-CLI på Windows
Windows-användare har två huvudalternativ: att använda Windows Subsystem för Linux (WSL) eller att skapa en inbyggd Windows-installation. WSL ger en mer Linux-liknande upplevelse och rekommenderas i allmänhet.
Alternativ 1: Använda WSL (rekommenderas)
Aktivera först WSL i Windows 10 eller 11:
wsl --install
Installera Ubuntu från Microsoft Store och starta sedan Ubuntu-terminalen. Följ sedan exakt samma steg för Linux-installation som beskrivs i föregående avsnitt – ladda ner phar-filen, gör den körbar och flytta den till /usr/local/bin/wp.
Alternativ 2: Native Windows-installation
För en native-installation behöver du PHP för Windows installerat med den körbara filen php tillgänglig i din system PATH.
- Ladda ner och installera PHP från den officiella PHP för Windows-webbplatsen
- Lägg till PHP-katalogen i din PATH-miljövariabel i Windows
- Bekräfta att PHP fungerar genom att öppna kommandotolken och köra
php -v
Ladda sedan ner filen WP-CLI PHAR:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
Windows innehåller curl som standard sedan 2018, så det här bör fungera utan ytterligare inställningar. Skapa en mapp för WP-CLI (t.ex. C:\wp-cli) och flytta den nedladdade filen dit.
Skapa sedan en batch-wrapper-fil med namnet wp.bat i samma mapp:
@echo off
php "C:\wp-cli\wp-cli.phar" %*
Lägg till C:\wp-cli i din system PATH-miljövariabel. Öppna nu ett nytt Command Prompt- eller PowerShell-fönster och verifiera:
wp --info
Du bör se WP-CLI-version och miljöinformation som bekräftar att WP-CLI är korrekt installerat.
Grundläggande användning av WP-CLI och hjälp
När WP-CLI är installerat måste du förstå det grundläggande kommandomönstret innan du kan dyka ner i specifika operationer. Alla WP-CLI-kommandon följer denna struktur:
wp <command> <subcommand> [options]
Kommandon utförs från en WordPress-installationskatalog – mappen som innehåller wp-config.php. Om du befinner dig någon annanstans kan du ange sökvägen med --path=/var/www/html/mysite.
Kontrollera din miljö
Börja med att bekräfta din installation:
wp --info
Detta visar din WP-CLI-version, PHP-version, PHP-binär sökväg, operativsystem och andra miljödetaljer. För att bara se WP-CLI-versionen:
wp cli version
Utforska tillgängliga kommandon
För att lista alla tillgängliga wp cli-kommandon:
wp help
För hjälp med ett specifikt kommando:
wp help plugin
wp help core update
Du kan också lägga till --help till vilket kommando som helst:
wp user --help
Hjälpmeddelandet visas i en personsökare som liknar Unix man-sidor. Tryck på q för att avsluta.
Första kommandon att prova:
wp core version– visar din WordPress-versionwp plugin list– visar alla installerade WordPress-plugins med deras statuswp theme list– visar installerade temanwp user list– listar alla användare på webbplatsen
Med dessa skrivskyddade kommandon kan du utforska din WordPress-webbplats utan att ändra något, vilket är perfekt för att bli bekväm med gränssnittet.
Installera och konfigurera WordPress med WP-CLI
WP-CLI kan utföra en helt ny WordPress-installation snabbare än den traditionella webbaserade installationsprogrammet. Detta är särskilt värdefullt när du startar upp utvecklingsmiljöer eller distribuerar nya webbplatser programmatiskt.
Förutsättningar
Innan du kör installationskommandona måste du ha en MySQL- eller MariaDB-databas klar. I det här exemplet antar vi att du har skapat:
- Databasens namn:
wpsite_db - Databasanvändare:
wpsite_user - Lösenord:
securepassword123 - Värd:
localhost
Steg 1: Ladda ner WordPress-kärnfiler
Navigera till önskad installationskatalog och ladda ner WordPress-kärnan:
wp core download
Detta hämtar den senaste WordPress-versionen. För att ange en version eller lokal:
wp core download --version=6.4.2 --locale=fr_FR
När du är klar ser du en bekräftelse på att WordPress har laddats ner framgångsrikt.
Steg 2: Generera wp-config.php
Skapa konfigurationsfilen med hjälp av wp config create:
wp config create --dbname=wpsite_db --dbuser=wpsite_user --dbpass=securepassword123 --dbhost=localhost
Detta genererar en komplett wp-config.php med dina databasuppgifter och automatiskt genererade säkerhetssalter.
Steg 3: Kör installationen
Nu installerar du WordPress med dina webbplatsuppgifter:
wp core install --url=https://example.com --title="My New Site" --admin_user=admin --admin_password=strongpassword [email protected]
Du kommer att se meddelandet ”WordPress installerat framgångsrikt” och din webbplats är klar att använda.
Multisite-installation
För WordPress multisite-nätverk ska du använda multisite-varianten. WP-CLI kan konfigurera multisite-installationer med:
wp core multisite-install --url=https://example.com --title="My Network" --admin_user=admin --admin_password=strongpassword [email protected]
Hantera teman med WP-CLI
WP-CLI hanterar alla temafunktioner utan att det krävs åtkomst till WordPress adminpanel. Du kan lista, installera, aktivera, uppdatera och ta bort teman direkt från din terminal.
Lista installerade teman
För att se alla teman som för närvarande är installerade:
wp theme list
Exempel på utdata:
| namn | status | uppdatering | version |
|---|---|---|---|
| tjugotjugofyra | aktiv | none | 1.0 |
| tjugotrettiotre | inaktiv | none | 1.2 |
| astra | inaktiv | tillgänglig | 4.5.0 |
Aktivera ett tema
Byt till ett annat tema:
wp theme activate astra
Detta ändrar omedelbart det aktiva temat. Att byta tillbaka till ett standardtema är användbart vid felsökning av temarelaterade problem:
wp theme activate twentytwentyfour
Installera nya teman
Installera ett tema från WordPress.org-repository:
wp theme install astra
Installera och aktivera med ett enda kommando:
wp theme install astra --activate
Uppdatering av teman
Uppdatera ett specifikt tema:
wp theme update astra
Eller uppdatera alla teman på en gång:
wp theme update --all
Radera teman
Ta bort ett tema som du inte längre behöver:
wp theme delete twentytwentythree
Hantera plugins med WP-CLI
Plugin-hantering är det område där WP-CLI sparar mest tid. Du kan utföra massoperationer som skulle ta dussintals klick i instrumentpanelen.
Lista insticksprogram
wp plugin list
Exempel på utdata:
| namn | status | uppdatering | version |
|---|---|---|---|
| woocommerce | aktiv | none | 8.5.1 |
| yoast-seo | aktiv | tillgänglig | 21.0 |
| elementor | inaktiv | none | 3.18.0 |
Installera insticksprogram
Installera ett insticksprogram med dess slug:
wp plugin install woocommerce
Installera och aktivera:
wp plugin install yoast-seo --activate
Aktivera och avaktivera
Aktivera ett insticksprogram:
wp plugin activate elementor
Avaktivera ett plugin (användbart för felsökning):
wp plugin deactivate elementor
Avaktivera alla plugins på en gång (livräddare för felsökning av ”White Screen of Death”):
wp plugin deactivate --all
Uppdatering av plugins
Uppdatera ett specifikt plugin:
wp plugin update yoast-seo
Uppdatera alla plugins:
wp plugin update --all
Du kan också utesluta specifika plugins från en bulkuppdatering:
wp plugin update --all --exclude=woocommerce
Uppdatering och reparation av WordPress-kärnan
Att hålla WordPress uppdaterat är avgörande för säkerheten. WP-CLI gör denna process transparent och kontrollerbar.
Kontroll av uppdateringar
wp core check-update
Uppdatering av WordPress
Uppdatera till den senaste versionen:
wp core update
Efter en kärnuppdatering är det bra att uppdatera databasschemat:
wp core update-db
Verifiera kontrollsummor
Om du misstänker att din webbplats har blivit hackad kan du verifiera att kärnfilerna inte har ändrats:
wp core verify-checksums
Detta jämför dina filer mot de officiella kontrollsummorna i WordPress-arkivet.
Ominstallation av Core
Om filer är skadade kan du tvinga fram en ominstallation utan att innehållet påverkas:
wp core download --force --skip-content
Hantering av innehåll, användare och databas
WP-CLI gör att du kan interagera direkt med webbplatsens data.
Användarhantering
Lista användare:
wp user list
Skapa en ny administratör:
wp user create newadmin [email protected] --role=administrator --user_pass=securepass123
Uppdatera ett användarlösenord:
wp user update 1 --user_pass=newpassword
Ta bort en användare och tilldela dennes innehåll på nytt:
wp user delete 5 --reassign=1
Database Operations
Exportera databasen till en fil:
wp db export backup.sql
Importera en databas från en fil:
wp db import backup.sql
Optimera databasen:
wp db optimize
Öppna en MySQL-konsol som är direkt ansluten till din WordPress-databas:
wp db cli
Sök och ersätt (på rätt sätt)
Att flytta en WordPress-webbplats till en ny domän manuellt är riskabelt eftersom data ofta är serialiserade i databasen. En enkel SQL-sökning och ersättning kommer att förstöra widgetar och temaalternativ. WP-CLI hanterar serialisering korrekt.
Standard sök-ersätt
wp search-replace 'http://old-domain.com' 'https://new-domain.com'
Dry Run (Preview)
Kontrollera alltid vad som kommer att ändras innan du kör kommandot:
wp search-replace 'http://old-domain.com' 'https://new-domain.com' --dry-run
Exportera med ersättning
Du kan exportera en databas med de ersättningar som gjorts i filen och lämna den levande databasen orörd:
wp search-replace 'old.com' 'new.com' --export=migrated-db.sql
Avancerat underhåll: Cron och Object Cache
Hantera Cron-jobb
Visa schemalagda händelser:
wp cron event list
Kör alla fälliga cron-händelser omedelbart:
wp cron event run --due-now
Hantera transienter och cache
Rensa objektcachen:
wp cache flush
Ta bort alla utgångna transienter:
wp transient delete --expired
Automatisera arbetsuppgifter med skript
Du kan kombinera WP-CLI-kommandon till Bash-skript för automatiserat underhåll.
Exempel: Weekly Maintenance Script
Skapa en fil med namnet 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."
Gör den körbar (chmod +x maintain.sh) och kör den för att utföra fullständigt webbplatsunderhåll på några sekunder.
Använda WP-CLI på distans via SSH
Du behöver inte logga in på servern för att köra kommandon om du konfigurerar alias.
I din lokala wp-cli.yml fil:
@prod:
ssh: [email protected]/var/www/html
@dev:
ssh: [email protected]/var/www/html
Nu kan du köra kommandon på fjärrservern från din lokala maskin:
wp @prod plugin list
wp @dev core version
Bästa praxis
- Gör alltid säkerhetskopior: Innan du kör massuppdateringar eller sök-ersätt-kommandon, kör
wp db export. - Använd torrkörning: För sök-ersätt, använd alltid
--dry-runförst. - Kör inte som root: WP-CLI varnar dig om du kör som root. Det är säkrare att köra som webbserveranvändaren (t.ex.
www-data) eller ditt specifika användarkonto. - Testa på Staging: Använd WP-CLI för att klona din produktionswebbplats till staging, testa dina uppdateringsskript där och sedan tillämpa dem på produktionen.
Slutsats
WP-CLI förvandlar WordPress-hantering från en serie klick till strömlinjeformade, skriptbara operationer. Genom att börja med enkla kommandon som att kontrollera versioner och lista plugins läggs grunden för avancerad automatisering. Om du integrerar WP-CLI i ditt arbetsflöde redan idag kommer du att spara otaliga timmar i dina WordPress-projekt.