본문으로 건너뛰기

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

💡 요약 정리

  • 매니지드 워드프레스는 SSH로 접속해 WP-CLI를 사용할 수 있습니다.
  • bin 디렉토리를 만들고 wp-cli.phar를 다운로드한 뒤, PHP 실행 경로로 실행합니다.
  • PHP 실행 파일 경로는 서비스 종류와 PHP 버전에 따라 다르니 정확히 선택합니다.
  • 워드프레스 경로(--path) 지정으로 core/플러그인 명령을 실행합니다.
  • 플러그인 버전 확인과 업데이트까지 터미널에서 처리할 수 있습니다.
“매니지드워드프레스 호스팅 서비스에서는 SSH를 통해 직접 워드프레스 관리 도구인 WP-CLI를 사용할 수 있습니다.”

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

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

2. WP-CLI는 어떻게 사용하나요?

1) SSH 접속 방식

카페24에서는 SSH 접속 방식이 2가지로 제공됩니다.

    1. 일반 비밀번호 로그인 방식
    • SSH 접속 시, 계정 ID와 비밀번호를 입력하는 기본 방식입니다.
    • 나의 서비스 관리에서 Shell(SSH) 접속 설정이 허용이어야 합니다.
    • 바로가기 : [Shell(SSH) 접속설정]

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

SSH 접속 예시 화면
  • SSH 클라이언트(예: macOS/Linux 터미널, Windows의 PowerShell 또는 PuTTY)에서 접속합니다.

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

SSH 접속 후 현재 디렉터리 확인 예시

  • 기본 홈 디렉터리(예: /home/hosting_users/ID)인지 확인합니다.

    1. SSH Key 인증 방식 (보안 강화 권장)
    • 공개키/개인키 쌍을 이용하는 방식으로, 비밀번호 없이 SSH 접속이 가능합니다.
    • SSH Key 인증이 설정되어 있으면 비밀번호 방식으로는 접속할 수 없습니다.
    • 자세한 설정 방법은 아래 가이드를 참고하세요.

  • 유의 사항

    • SSH Key 설정은 나의 서비스 관리의 [보안관리 → FTP/Shell 접속설정]에서 변경할 수 있습니다.
      바로가기 : [Shell(SSH) 접속설정]
    • 설정 변경 후 적용까지 약 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

6. WP-CLI 동작 확인

  • 다운로드한 wp-cli.phar가 정상 동작하는지 확인합니다.
  • 정상적으로 정보가 출력되면 WP-CLI가 올바르게 설치된 것입니다.
/usr/local/php82/bin/php wp-cli.phar --info
wp-cli --info 실행 결과 예시

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

  • 워드프레스가 설치된 경로를 지정하여 명령을 실행합니다.
/usr/local/php82/bin/php wp-cli.phar core version --path=/{카페24 ID}/www/
  • --path는 워드프레스가 실제 설치된 디렉터리를 지정합니다.
    예: /ID/www/, /ID/www/wp 등
core version 출력 예시

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

1) 플러그인 버전 확인

  • 워드프레스 설치 경로를 지정한 뒤 아래 명령어를 실행합니다.
/usr/local/php82/bin/php wp-cli.phar plugin get 플러그인명 --path=/{ID}/www/
  • 출력의 version에서 현재 설치된 버전을 확인할 수 있으며, status가 active이면 활성화된 플러그인입니다.
plugin get 명령 실행 예시 plugin get 출력 예시

2) 플러그인 업데이트

  • 업데이트 가능한 플러그인은 아래 명령어로 최신 버전으로 업그레이드할 수 있습니다.
/usr/local/php82/bin/php wp-cli.phar plugin update 플러그인명 --path=/{ID}/www/
plugin update 명령 실행 예시 plugin update 출력 예시
  • 여러 플러그인을 한 번에 업데이트하려면 --all 옵션을 사용할 수 있습니다.
plugin update --all 실행 예시
  • 출력 필드 안내
    • old_version: 업데이트 전 버전
    • new_version: 업데이트 후 버전
    • status: 업데이트 결과(Updated = 성공)

9. 참고 및 권한 오류 해결

  • --path 옵션은 워드프레스 설치 디렉터리를 지정합니다. 예: /ID/www/, /ID/www/wp
  • PHP 실행 경로는 사용하는 PHP 버전과 반드시 일치해야 합니다.
  • 명령어 실행 시 권한 오류가 발생하면, 아래 명령어로 실행 권한을 부여하세요.
chmod +x wp-cli.phar
  • 추가 참고: PHP 경로 요약
    • PHP 8.2: /usr/local/php82/bin/php
    • PHP 8.4: /usr/local/php84/bin/php
주의: SSH Key 인증을 활성화하면 비밀번호 방식 로그인은 사용할 수 없습니다.