11 min. baca

WP-CLI: Panduan Lengkap Mengelola WordPress dari Baris Perintah

WP-CLI adalah alat baris perintah resmi untuk mengelola instalasi WordPress langsung dari terminal Anda, tanpa perlu membuka browser. Jika Anda pernah menghabiskan waktu seharian mengklik dasbor admin WordPress untuk memperbarui plugin di berbagai situs, Anda pasti sudah tahu mengapa tool ini ada.

Dalam panduan ini, Anda akan mempelajari segala hal mulai dari menginstal WP-CLI di Linux, macOS, dan Windows hingga mengotomatiskan tugas-tugas pemeliharaan yang kompleks dengan skrip dan file konfigurasi. Baik Anda mengelola satu blog atau lusinan situs klien, menguasai WP-CLI akan mengubah cara kerja Anda dengan WordPress secara fundamental.

Apa yang akan Anda pelajari:

Cara menginstal dan mengonfigurasi WP-CLI di berbagai sistem operasi
Perintah penting untuk mengelola plugin, tema, pengguna, dan konten
Operasi basis data termasuk ekspor, impor, dan pencarian-penggantian yang aman
Teknik otomatisasi menggunakan skrip, alias, dan pekerjaan cron
Praktik terbaik untuk menghindari jebakan umum saat bekerja dari terminal

Apa yang dimaksud dengan WP-CLI? (Penjelasan Singkat Terlebih Dahulu)

WP-CLI adalah singkatan dari WordPress Command Line Interface-sebuah alat sumber terbuka yang memungkinkan Anda mengelola situs WordPress sepenuhnya dari terminal. Alih-alih masuk ke wp-admin dan menavigasi menu, Anda menjalankan perintah seperti wp plugin update --all dan melihat seluruh tumpukan plugin Anda diperbarui dalam hitungan detik.

Proyek ini dimulai sekitar tahun 2011, dibuat oleh para pengembang yang menginginkan cara yang lebih cepat untuk mengelola WordPress dalam skala besar. Pada tahun 2017, proyek ini pindah ke bawah payung resmi WordPress.org dan sekarang dikelola oleh tim kontributor yang berdedikasi termasuk Alain Schlesser dan Daniel Bachhuber.

Inilah yang perlu Anda ketahui tentang WP-CLI:

Versi stabil saat ini: Seri WP-CLI 2.x
Kompatibilitas WordPress: Dapat digunakan pada WordPress 5.x hingga 6.x (dan secara historis kembali ke 3.7)
Persyaratan PHP: PHP 7.4+ atau 8.x direkomendasikan untuk keamanan dan performa
Ekosistem perintah: Lebih dari 40 perintah induk yang mencakup hampir semua operasi WordPress
Pengguna utama: Pengembang, agensi, insinyur DevOps, dan pengguna utama yang mengelola situs yang kompleks atau banyak
Distribusi: Tersedia sebagai file PHAR, melalui manajer paket, atau sudah terinstal di banyak host WordPress terkelola

Manfaat Utama Menggunakan WP-CLI

Setelah Anda memahami mengapa WP-CLI ada, kurva pembelajaran menjadi lebih mudah untuk dijustifikasi. Bagian ini menjelaskan keuntungan nyata yang membuat alat ini sepadan dengan waktu Anda.

Penghematan waktu untuk tugas-tugas yang berulang
Memperbarui 20 plugin melalui dasbor WordPress berarti 20 pemuatan halaman, 20 klik, dan melihat 20 bilah kemajuan. Dengan WP-CLI, Anda menjalankan wp plugin update --all sekali dan melanjutkan. Untuk agensi yang mengelola beberapa situs klien, perbedaan ini bertambah menjadi jam kerja yang dihemat setiap minggunya.

Operasi massal dan otomatis
Pertimbangkan skenario di mana Anda sedang mempersiapkan 15 toko WooCommerce untuk Black Friday. Anda perlu memperbarui pengaya, menghapus cache, dan memverifikasi integritas basis data di setiap situs. WP-CLI memungkinkan Anda membuat skrip untuk seluruh urutan ini dan menjalankannya di semua situs dalam hitungan menit, bukan jam. Kemampuan otomatisasi utama meliputi:

Memperbarui semua plugin di beberapa instalasi dengan satu skrip
Membuat pengguna secara massal dengan peran yang telah ditentukan sebelumnya
Menjalankan pemeliharaan malam hari melalui cron (pengoptimalan basis data, pembersihan sementara)
Menerapkan konfigurasi WordPress yang sama ke lingkungan baru

Keandalan atas operasi berbasis browser
Operasi browser mencapai batas waktu HTTP. Impor basis data yang besar gagal di tengah proses. Operasi pencarian-penggantian merusak data terserialisasi ketika dilakukan dengan SQL mentah. WP-CLI menghindari semua masalah ini karena berjalan langsung di server tanpa batasan waktu, dan perintah search-replace-nya dengan benar menangani struktur data terserialisasi.

Kontrol langsung atas sistem inti WordPress
Dari satu terminal, Anda bisa:

Mengekspor dan mengimpor database WordPress
Mengubah pengaturan wp-config.php
Memeriksa dan memicu peristiwa wp-cron
Mengaktifkan dan menonaktifkan mode pemeliharaan
Menjalankan kode PHP sembarang dalam konteks WordPress

Mengurangi beban pada wp-admin
Pada server produksi yang sibuk, setiap pemuatan halaman dasbor admin menghabiskan sumber daya. Menjalankan operasi pemeliharaan melalui WP-CLI membuat beban tersebut tidak membebani server web, yang penting selama periode lalu lintas tinggi.

Persyaratan WP-CLI dan Lingkungan yang Didukung

Sebelum menginstal WP-CLI, Anda perlu mengonfirmasi server atau lingkungan lokal Anda memenuhi persyaratan dasar. Kabar baiknya adalah sebagian besar pengaturan WordPress modern sudah memenuhi syarat.

Persyaratan versi PHP:

Minimal: PHP 5.6 (meskipun sudah ketinggalan zaman)
Direkomendasikan: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 atau 8.5 untuk keamanan dan kinerja pada tahun 2026

Kompatibilitas versi WordPress:

Dukungan historis: WordPress 3.7 dan yang lebih baru
Target modern: WordPress 5.0 hingga 6.7+ untuk proyek-proyek saat ini

Ekspektasi sistem operasi:

Dukungan terbaik: Sistem mirip UNIX (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
Windows: Didukung melalui WSL (Windows Subsystem for Linux) atau instalasi PHP asli

Persyaratan tambahan:

PHP tersedia pada baris perintah ( php biner harus berada di PATH Anda)
cURL atau wget untuk mengunduh file wp-cli.phar
Akses SSH untuk server jarak jauh (sebagian besar paket hosting WordPress terkelola menyertakan ini secara default)

Banyak host populer seperti Kinsta, SiteGround, dan DreamHost sekarang dikirimkan dengan WP-CLI yang sudah terinstal. WordPress.com juga menyertakan WP-CLI untuk situs-situs dengan akses SSH yang diaktifkan.

Cara Menginstal WP-CLI di Linux dan macOS

Metode instalasi standar menggunakan berkas PHAR (Arsip PHP) resmi. Proses ini bekerja pada terminal Ubuntu, Debian, CentOS, Fedora, dan macOS.

Langkah 1: Unduh berkas PHAR
Buka terminal Anda dan unduh wp-cli.phar menggunakan curl:

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

Atau, gunakan wget:

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

Langkah 2: Verifikasi unduhan (opsional, tetapi disarankan)
Periksa checksum SHA-256 terhadap nilai resmi yang dipublikasikan dalam dokumentasi WP-CLI untuk memastikan bahwa file tidak dirusak selama pengunduhan:

sha256sum wp-cli.phar

Bandingkan output dengan checksum yang tercantum pada situs web resmi WP-CLI.

Langkah 3: Uji file PHAR
Konfirmasikan bahwa file php berfungsi:

php wp-cli.phar --info

Anda akan melihat output yang menampilkan versi WP-CLI, versi PHP, dan informasi sistem.

Langkah 4: Buatlah file tersebut dapat dieksekusi dan pindahkan ke PATH
Tandai file tersebut sebagai file yang dapat dieksekusi dan pindahkan ke direktori di PATH sistem Anda:

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

Perintah sudo biasanya diperlukan karena /usr/local/bin adalah direktori sistem. Hindari menginstal WP-CLI sebagai root jika Anda akan menjalankannya sebagai pengguna biasa.

Langkah 5: Verifikasi instalasi global
Konfirmasikan bahwa WP-CLI sekarang tersedia secara global:

wp --info
wp cli version

Anda akan melihat keluaran yang mengonfirmasi versi wp cli, lokasi biner PHP, dan detail sistem operasi. Pada titik ini, Anda telah menginstal WP-CLI dan siap digunakan.

Cara Memasang WP-CLI di Windows

Pengguna Windows memiliki dua jalur utama: menggunakan Windows Subsystem for Linux (WSL) atau menyiapkan instalasi Windows asli. WSL memberikan pengalaman yang lebih mirip Linux dan umumnya direkomendasikan.

Opsi 1: Menggunakan WSL (Direkomendasikan)
Pertama, aktifkan WSL pada Windows 10 atau 11:

wsl --install

Instal Ubuntu dari Microsoft Store, lalu luncurkan terminal Ubuntu. Dari sana, ikuti langkah-langkah instalasi Linux yang sama persis seperti yang diuraikan di bagian sebelumnya-unduh file phar, buat file tersebut dapat dieksekusi, dan pindahkan ke /usr/local/bin/wp.

Opsi 2: Instalasi Windows asli
Untuk instalasi asli, Anda memerlukan PHP untuk Windows yang terinstal dengan eksekusi php yang tersedia di PATH sistem Anda.

Unduh dan instal PHP dari situs resmi PHP untuk Windows
Tambahkan direktori PHP ke variabel lingkungan PATH Windows Anda
Konfirmasikan bahwa PHP berfungsi dengan membuka Command Prompt dan menjalankannya php -v

Selanjutnya, unduh file WP-CLI PHAR:

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

Windows menyertakan curl secara default sejak tahun 2018, jadi ini akan bekerja tanpa pengaturan tambahan. Buat sebuah folder untuk WP-CLI (misalnya, C:\wp-cli) dan pindahkan berkas yang telah diunduh ke sana.

Kemudian buat file pembungkus batch bernama wp.bat di folder yang sama:

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

Tambahkan C:\wp-cli ke variabel lingkungan PATH sistem Anda. Sekarang buka jendela Command Prompt atau PowerShell baru dan lakukan verifikasi:

wp --info

Anda akan melihat versi WP-CLI dan detail lingkungan yang mengonfirmasi bahwa WP-CLI telah terinstal dengan benar.

Penggunaan Dasar WP-CLI dan Mendapatkan Bantuan

Dengan WP-CLI terinstal, Anda harus memahami pola perintah dasar sebelum menyelami operasi tertentu. Semua perintah WP-CLI mengikuti struktur ini:

wp <command> <subcommand> [options]

Perintah dijalankan dari dalam direktori instalasi WordPress-folder yang berisi wp-config.php. Jika Anda berada di tempat lain, Anda dapat menentukan jalurnya dengan --path=/var/www/html/mysite.

Memeriksa lingkungan Anda
Mulailah dengan mengonfirmasi pengaturan Anda:

wp --info

Ini menampilkan versi WP-CLI, versi PHP, jalur biner PHP, sistem operasi, dan detail lingkungan lainnya. Untuk melihat versi WP-CLI saja:

wp cli version

Menjelajahi perintah yang tersedia
Untuk membuat daftar semua perintah wp cli yang tersedia:

wp help

Untuk bantuan pada perintah tertentu:

wp help plugin
wp help core update

Anda juga dapat menambahkan --help ke perintah apa pun:

wp user --help

Output bantuan ditampilkan pada halaman pager yang mirip dengan halaman man Unix. Tekan q untuk keluar.

Perintah pertama yang harus dicoba:

wp core version – menampilkan versi WordPress Anda
wp plugin list – menampilkan semua plugin WordPress yang terinstal dengan statusnya
wp theme list – menampilkan tema yang diinstal
wp user list – mencantumkan semua pengguna di situs

Perintah read-only ini memungkinkan Anda menjelajahi situs WordPress Anda tanpa mengubah apa pun, yang sangat cocok untuk membuat Anda merasa nyaman dengan antarmukanya.

Menginstal dan Mengonfigurasi WordPress dengan WP-CLI

WP-CLI dapat melakukan instalasi WordPress baru yang lengkap lebih cepat daripada installer berbasis web tradisional. Hal ini sangat berharga ketika menjalankan lingkungan pengembangan atau menerapkan situs baru secara terprogram.

Prasyarat
Sebelum menjalankan perintah instalasi, Anda perlu menyiapkan database MySQL atau MariaDB. Untuk contoh ini, asumsikan Anda telah membuat:

Nama basis data: wpsite_db
Pengguna basis data: wpsite_user
Kata sandi: securepassword123
Tuan rumah: localhost

Langkah 1: Unduh file inti WordPress
Navigasikan ke direktori instalasi yang Anda inginkan dan unduh inti WordPress:

wp core download

Ini mengambil versi WordPress terbaru. Untuk menentukan versi atau lokasi:

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

Setelah selesai, Anda akan melihat konfirmasi bahwa WordPress berhasil diunduh.

Langkah 2: Buatlah wp-config.php
Buatlah berkas konfigurasi menggunakan wp config create:

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

Ini menghasilkan wp-config.php lengkap dengan kredensial basis data Anda dan garam keamanan yang dibuat secara otomatis.

Langkah 3: Jalankan instalasi
Sekarang instal WordPress dengan detail situs Anda:

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

Anda akan melihat pesan “WordPress berhasil diinstal” dan situs Anda siap digunakan.

Instalasi multisite
Untuk jaringan multisite WordPress, gunakan varian multisite. WP-CLI dapat mengonfigurasi instalasi multisite dengan:

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

Mengelola Tema dengan WP-CLI

WP-CLI menangani semua operasi tema tanpa memerlukan akses ke dasbor admin WordPress. Anda dapat membuat daftar, menginstal, mengaktifkan, memperbarui, dan menghapus tema langsung dari terminal Anda.

Daftar tema yang terinstal
Untuk melihat semua tema yang saat ini terinstal:

wp theme list

Keluaran sampel:

nama	status	pembaruan	versi
twentytwentyfour	aktif	none	1.0
dua puluh dua puluh tiga	tidak aktif	none	1.2
astra	tidak aktif	tersedia	4.5.0

Mengaktifkan tema
Beralih ke tema lain:

wp theme activate astra

Hal ini segera mengubah tema yang aktif. Beralih kembali ke tema default berguna untuk memecahkan masalah terkait tema:

wp theme activate twentytwentyfour

Menginstal tema baru
Menginstal tema dari repositori WordPress.org:

wp theme install astra

Instal dan aktifkan dalam satu perintah:

wp theme install astra --activate

Memperbarui tema
Memperbarui tema tertentu:

wp theme update astra

Atau perbarui semua tema sekaligus:

wp theme update --all

Menghapus tema
Menghapus tema yang tidak lagi Anda perlukan:

wp theme delete twentytwentythree

Mengelola Plugin dengan WP-CLI

Manajemen plugin adalah tempat di mana WP-CLI paling banyak menghemat waktu. Anda bisa melakukan operasi massal yang membutuhkan puluhan klik di dasbor.

Mencantumkan plugin

wp plugin list

Keluaran sampel:

nama	status	pembaruan	versi
woocommerce	aktif	none	8.5.1
yoast-seo	aktif	tersedia	21.0
elementor	tidak aktif	none	3.18.0

Menginstal plugin
Instal plugin berdasarkan slug-nya:

wp plugin install woocommerce

Instal dan aktifkan:

wp plugin install yoast-seo --activate

Mengaktifkan dan Menonaktifkan
Mengaktifkan plugin:

wp plugin activate elementor

Menonaktifkan plugin (berguna untuk melakukan debug):

wp plugin deactivate elementor

Nonaktifkan semua plugin sekaligus (penyelamat untuk debugging “White Screen of Death”):

wp plugin deactivate --all

Memperbarui plugin
Memperbarui plugin tertentu:

wp plugin update yoast-seo

Perbarui semua plugin:

wp plugin update --all

Anda juga dapat mengecualikan plugin tertentu dari pembaruan massal:

wp plugin update --all --exclude=woocommerce

Memperbarui dan Memperbaiki WordPress Core

Menjaga WordPress tetap diperbarui sangat penting untuk keamanan. WP-CLI membuat proses ini transparan dan dapat dikontrol.

Memeriksa pembaruan

wp core check-update

Memperbarui WordPress
Perbarui ke versi terbaru:

wp core update

Setelah pembaruan inti, merupakan praktik yang baik untuk memperbarui skema basis data:

wp core update-db

Memverifikasi checksum
Jika Anda mencurigai situs Anda telah diretas, Anda bisa memverifikasi bahwa file inti belum dimodifikasi:

wp core verify-checksums

Ini membandingkan file Anda dengan checksum repositori WordPress resmi.

Menginstal Ulang Core
Jika file rusak, Anda dapat melakukan penginstalan ulang tanpa mempengaruhi konten Anda:

wp core download --force --skip-content

Mengelola Konten, Pengguna, dan Basis Data

WP-CLI memungkinkan Anda untuk berinteraksi dengan data situs Anda secara langsung.

Manajemen Pengguna
Daftar pengguna:

wp user list

Membuat administrator baru:

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

Memperbarui kata sandi pengguna:

wp user update 1 --user_pass=newpassword

Menghapus pengguna dan menetapkan ulang konten mereka:

wp user delete 5 --reassign=1

Operasi Basis Data
Mengekspor basis data ke sebuah file:

wp db export backup.sql

Mengimpor basis data dari file:

wp db import backup.sql

Mengoptimalkan basis data:

wp db optimize

Buka konsol MySQL yang terhubung langsung ke database WordPress Anda:

wp db cli

Cari dan Ganti (Cara yang Benar)

Memindahkan situs WordPress ke domain baru secara manual berisiko karena data sering kali diserialisasikan dalam database. Pencarian-dan-penggantian SQL yang sederhana akan merusak widget dan opsi tema. WP-CLI menangani serialisasi dengan benar.

Pencarian-Penggantian Standar

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

Uji Coba (Pratinjau)
Selalu periksa apa yang akan berubah sebelum menjalankan perintah:

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

Mengekspor dengan penggantian
Anda dapat mengekspor database dengan penggantian yang dibuat dalam file, membiarkan database langsung tidak tersentuh:

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

Pemeliharaan Lanjutan: Cron dan Cache Objek

Mengelola Pekerjaan Cron
Melihat acara yang dijadwalkan:

wp cron event list

Jalankan semua acara cron dengan segera:

wp cron event run --due-now

Mengelola Transien dan Cache
Menghapus cache objek:

wp cache flush

Menghapus semua transien yang kedaluwarsa:

wp transient delete --expired

Mengotomatiskan Tugas dengan Skrip

Anda dapat menggabungkan perintah WP-CLI ke dalam skrip Bash untuk pemeliharaan otomatis.

Contoh: Skrip Pemeliharaan Mingguan
Buat sebuah file bernama 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."

Buatlah agar dapat dieksekusi (chmod +x maintain.sh) dan jalankan untuk melakukan pemeliharaan situs secara penuh dalam hitungan detik.

Menggunakan WP-CLI dari Jarak Jauh melalui SSH

Anda tidak perlu masuk ke server untuk menjalankan perintah jika Anda mengonfigurasi alias.

Dalam file wp-cli.yml lokal Anda:

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

Sekarang Anda dapat menjalankan perintah pada server jarak jauh dari mesin lokal Anda:

wp @prod plugin list
wp @dev core version

Praktik Terbaik

Selalu Cadangkan: Sebelum menjalankan pembaruan massal atau perintah pencarian-penggantian, jalankan wp db export.
Gunakan Dry Run: Untuk pencarian-penggantian, selalu gunakan --dry-run terlebih dahulu.
Jangan jalankan sebagai Root: WP-CLI akan memperingatkan Anda jika Anda menjalankan sebagai root. Lebih aman jika Anda menjalankannya sebagai pengguna server web (misalnya, www-data) atau akun pengguna khusus Anda.
Menguji di Pementasan: Gunakan WP-CLI untuk mengkloning situs produksi Anda ke staging, menguji skrip pembaruan Anda di sana, lalu menerapkannya ke produksi.

Kesimpulan

WP-CLI mengubah manajemen WordPress dari serangkaian klik menjadi operasi yang efisien dan dapat ditulis dalam skrip. Dimulai dengan perintah sederhana seperti memeriksa versi dan daftar plugin membangun fondasi untuk otomatisasi tingkat lanjut. Mengintegrasikan WP-CLI ke dalam alur kerja Anda hari ini akan menghemat waktu yang tak terhitung jumlahnya di seluruh proyek WordPress Anda.