워드프레스 WP-CLI 명령어 정리 (설치, 플러그인, DB, search-replace)

By ItInfo

2026.10.16. 3 Min Read

워드프레스 관리를 웹 관리자 화면에서만 하고 있다면 WP-CLI를 꼭 써 보길 권한다. 플러그인 일괄 업데이트, DB 백업, 주소 일괄 변경처럼 화면에서 하나씩 누르던 작업을 터미널 명령 한 줄로 끝낼 수 있다. 실제로 이 블로그의 글 200여 개를 고칠 때도 WP-CLI를 썼다. 이 글에서는 설치부터 자주 쓰는 WP-CLI 명령어 목록까지 정리한다. 이 블로그의 SEO 정리 과정은 AIOSEO 점수 90점 넘기는 법에 있다.

WP-CLI 설치

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
php wp-cli.phar --info
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

wp --info

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
php wp-cli.phar --info
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

wp --info

명령은 워드프레스가 설치된 디렉터리(wp-config.php가 있는 곳)에서 실행하거나 –path 옵션으로 위치를 알려 준다. 웹 서버 계정으로 실행해야 파일 권한이 꼬이지 않는다.

cd /var/www/html
sudo -u www-data wp core version

cd /var/www/html
sudo -u www-data wp core version

WP-CLI 명령어 코어와 플러그인, 테마 관리

# 워드프레스 버전 확인과 업데이트
wp core version
wp core check-update
wp core update

# 플러그인
wp plugin list
wp plugin update --all
wp plugin deactivate 플러그인이름
wp plugin activate 플러그인이름

# 테마
wp theme list
wp theme update --all

# 워드프레스 버전 확인과 업데이트
wp core version
wp core check-update
wp core update

# 플러그인
wp plugin list
wp plugin update --all
wp plugin deactivate 플러그인이름
wp plugin activate 플러그인이름

# 테마
wp theme list
wp theme update --all

업데이트 후 사이트가 깨졌다면

관리자 화면에 들어갈 수 없을 때도 WP-CLI는 동작한다. 문제가 된 플러그인을 터미널에서 바로 비활성화할 수 있다. 실제 사례는 워드프레스 업데이트 후 치명적인 오류 해결기에 정리했다.

wp plugin deactivate 문제플러그인 --skip-plugins --skip-themes

wp plugin deactivate 문제플러그인 --skip-plugins --skip-themes

WP-CLI 명령어 글과 사용자 관리

# 글 목록 (발행된 글 10개)
wp post list --post_type=post --post_status=publish --posts_per_page=10

# 글 하나의 내용 보기
wp post get 123 --field=post_content

# 사용자 목록, 비밀번호 바꾸기
wp user list
wp user update admin계정 --prompt=user_pass

# 글 목록 (발행된 글 10개)
wp post list --post_type=post --post_status=publish --posts_per_page=10

# 글 하나의 내용 보기
wp post get 123 --field=post_content

# 사용자 목록, 비밀번호 바꾸기
wp user list
wp user update admin계정 --prompt=user_pass

비밀번호를 명령줄에 직접 쓰면 셸 기록에 남으니 –prompt로 입력받는 방식을 권한다.

WP-CLI 명령어 데이터베이스 작업

# DB 백업과 복원
wp db export /backup/wp_$(date +%Y%m%d).sql
wp db import /backup/wp_20261016.sql

# 주소 일괄 변경 (먼저 --dry-run 으로 확인)
wp search-replace 'http://example.com' 'https://example.com' --dry-run
wp search-replace 'http://example.com' 'https://example.com'

# 직접 SQL 실행
wp db query "SELECT COUNT(*) FROM wp_posts WHERE post_status='publish'"

# DB 백업과 복원
wp db export /backup/wp_$(date +%Y%m%d).sql
wp db import /backup/wp_20261016.sql

# 주소 일괄 변경 (먼저 --dry-run 으로 확인)
wp search-replace 'http://example.com' 'https://example.com' --dry-run
wp search-replace 'http://example.com' 'https://example.com'

# 직접 SQL 실행
wp db query "SELECT COUNT(*) FROM wp_posts WHERE post_status='publish'"

search-replace는 직렬화된 데이터까지 안전하게 바꿔 준다는 점에서 SQL의 REPLACE보다 낫다. 도메인을 옮기거나 http를 https로 바꿀 때 쓴다. DB 백업 전반은 mysqldump 백업과 복원에 정리했다.

캐시와 예약 작업

wp cache flush            # 객체 캐시 비우기
wp cron event list        # 예약된 작업 목록
wp cron event run --due-now

wp cache flush            # 객체 캐시 비우기
wp cron event list        # 예약된 작업 목록
wp cron event run --due-now

스크립트로 자동화하기

#!/bin/bash
# 매주 플러그인 업데이트 전 DB 백업
set -euo pipefail
cd /var/www/html
sudo -u www-data wp db export /backup/wp_before_update_$(date +%Y%m%d).sql
sudo -u www-data wp plugin update --all

#!/bin/bash
# 매주 플러그인 업데이트 전 DB 백업
set -euo pipefail
cd /var/www/html
sudo -u www-data wp db export /backup/wp_before_update_$(date +%Y%m%d).sql
sudo -u www-data wp plugin update --all

스크립트 작성과 예약 실행은 쉘 스크립트 기초와 crontab 사용법을 참고하자. 명령어 전체 목록은 WP-CLI 공식 명령어 문서에 있다.

WP-CLI 명령어 정리

core, plugin, post, user, db, search-replace 여섯 가지만 익혀도 워드프레스 관리 시간이 크게 줄어든다. 특히 관리자 화면이 열리지 않는 비상 상황에서 진가를 발휘한다. 느린 DB 쿼리를 찾는 방법은 전날 글인 MySQL 느린 쿼리 로그에 있다.

WP-CLI가 사용하는 PHP와 웹 요청을 처리하는 PHP는 다를 수 있다. CLI는 새 버전인데 웹에서는 구버전이 실행됐던 PHP 보안 업데이트 점검 사례처럼, 서버 패치 후에는 사이트 건강의 실제 웹 PHP 버전도 함께 확인하자.