본문으로 건너뛰기

워드프레스 VPS에서 WP-CLI를 사용하는 방법은 무엇인가요?

💡 요약 정리

  • SSH로 접속 후 bin 디렉터리를 만들고 wp-cli.phar를 다운로드합니다.
  • 워드프레스 VPS는 php-fpm 경로(/usr/local/php-fpm82/bin/php 등)로 WP-CLI를 실행합니다.
  • --path에는 워드프레스 설치 경로(예: /카페24ID/www/)를 지정해야 명령이 정상 동작합니다.
  • 플러그인 버전 확인: plugin get, 업데이트: plugin update를 사용합니다.
  • SSH Key 인증을 설정하면 비밀번호 로그인은 불가합니다. 설정 반영까지 약 3분 소요될 수 있습니다.

1. WP-CLI는 무엇인가요?

  • WP-CLI는 브라우저 없이 터미널에서 워드프레스 업데이트, 플러그인 관리 등을 수행할 수 있는 명령줄 도구(CLI, Command Line Interface)입니다.

2. SSH 접속 방식

1) 일반 비밀번호 로그인 방식

  • SSH 접속 시 계정 ID와 비밀번호를 입력하는 기본 방식입니다.
  • 접속 전에 보안 설정에서 SSH 허용이 필요합니다.

① SSH로 자신의 호스팅 계정에 접속합니다.

SSH 접속 화면 예시

② 접속 후 현재 위치를 확인합니다.

터미널에서 현재 작업 경로 확인 예시

2) SSH Key 인증 방식 (보안 강화 권장)

  • 공개키/개인키 쌍을 사용하는 방식으로, 비밀번호 없이 SSH 접속이 가능합니다.
  • SSH Key 인증이 설정되면 비밀번호 방식으로는 접속할 수 없습니다.
  • 접속 방법 가이드: SSH 인증키 파일을 이용한 로그인 가이드

유의 사항

  • SSH Key 설정은 나의 서비스 관리의 보안 메뉴에서 변경할 수 있습니다.
  • 설정 변경 후 적용까지 약 3분 정도 소요될 수 있습니다.

3. bin 디렉토리 생성 및 이동

  • WP-CLI 파일을 저장할 디렉터리를 생성하고 해당 디렉터리로 이동합니다.
mkdir bin
cd bin

4. WP-CLI 다운로드

  • 아래 명령어로 wp-cli.phar 파일을 다운로드합니다.
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

5. PHP 버전별 실행 경로 확인

  • 카페24는 서비스 종류(일반 웹호스팅/워드프레스 VPS)에 따라 PHP 실행 파일 경로가 다릅니다.
  • 사용 중인 환경과 PHP 버전에 맞는 경로를 선택해 WP-CLI를 실행하세요.
  1. 일반 웹호스팅 서비스
  • PHP 8.2: /usr/local/php82/bin/php
  • PHP 8.4: /usr/local/php84/bin/php
  1. 워드프레스 VPS 호스팅 서비스
  • PHP 8.2: /usr/local/php-fpm82/bin/php
  • PHP 8.4: /usr/local/php-fpm84/bin/php

참고 사항

  • 워드프레스 VPS 호스팅은 php-fpm 기반 실행 환경을 사용하므로, 경로에 php-fpm이 포함됩니다.
  • 사용하는 서버의 PHP 버전에 맞는 경로를 선택해 명령어를 실행하세요.

6. WP-CLI 동작 확인

  • 다운로드한 wp-cli.phar 파일이 정상 동작하는지 확인합니다. 서버의 PHP 버전에 맞는 실행 경로를 사용하세요.

  • 워드프레스 VPS 예시

/usr/local/php-fpm82/bin/php wp-cli.phar --info
  • 일반 웹호스팅 예시
/usr/local/php82/bin/php wp-cli.phar --info
  • 정상적으로 정보가 출력되면 WP-CLI가 올바르게 설치된 것입니다.
wp-cli --info 실행 결과 예시

7. 워드프레스 설치 경로 지정 및 버전 확인

  • 워드프레스가 설치된 경로를 지정하여 명령어를 실행할 수 있습니다.

  • 워드프레스 VPS 예시

/usr/local/php-fpm82/bin/php wp-cli.phar core version --path=/카페24ID/www/
  • 일반 웹호스팅 예시
/usr/local/php82/bin/php wp-cli.phar core version --path=/카페24ID/www/
워드프레스 core version 출력 예시

참고 사항

  • --path 옵션은 워드프레스가 실제 설치된 디렉터리를 지정합니다. 예: /카페24ID/www/, /카페24ID/www/wp
  • PHP 실행 경로는 사용하는 PHP 버전과 일치해야 합니다.
  • 명령어 실행 시 권한 오류가 발생하면 아래처럼 실행 권한을 부여하세요.
chmod +x wp-cli.phar

8. 특정 플러그인 버전 확인 및 업데이트 방법

① 플러그인 버전 확인

  • 워드프레스 설치 디렉터리를 --path로 지정한 뒤 아래 명령을 실행합니다.

  • 워드프레스 VPS 예시

/usr/local/php-fpm82/bin/php wp-cli.phar plugin get 플러그인명 --path=/카페24ID/www/
  • 일반 웹호스팅 예시
/usr/local/php82/bin/php wp-cli.phar plugin get 플러그인명 --path=/카페24ID/www/
WP-CLI plugin get 명령 실행 예시 WP-CLI plugin get 결과(version, status 등) 예시
  • version 항목에서 현재 설치된 버전을 확인할 수 있습니다.
  • status가 active이면 활성화된 플러그인입니다.
  • 플러그인명은 wp-content/plugins/ 디렉터리의 폴더명과 동일해야 합니다.

② 플러그인 업데이트

  • 업데이트 가능한 플러그인은 다음 명령으로 최신 버전으로 업그레이드할 수 있습니다.

  • 워드프레스 VPS 예시

/usr/local/php-fpm82/bin/php wp-cli.phar plugin update 플러그인명 --path=/카페24ID/www/
  • 일반 웹호스팅 예시
/usr/local/php82/bin/php wp-cli.phar plugin update 플러그인명 --path=/카페24ID/www/
WP-CLI plugin update 명령 실행 예시 WP-CLI plugin update 결과(old_version, new_version, status) 예시
  • old_version: 업데이트 전 버전
  • new_version: 업데이트 후 버전
  • status: 업데이트 결과(Updated = 성공)
  • 여러 플러그인을 한 번에 업데이트하려면 --all 옵션을 사용할 수 있습니다.
여러 플러그인 동시 업데이트(--all 옵션) 예시

참고 사항

  • PHP 경로는 서버의 PHP 버전에 맞게 조정해야 합니다.
    • 워드프레스 VPS: /usr/local/php-fpm82/bin/php, /usr/local/php-fpm84/bin/php
    • 일반 웹호스팅: /usr/local/php82/bin/php, /usr/local/php84/bin/php
  • --path 옵션은 워드프레스가 설치된 실제 경로를 지정해야 합니다.