카페24, 가비아 등 공유 호스팅에서 wp-cli 사용하기

Kinsta, GoDaddy 등의 해외 호스팅이나 직접 구성한 서버에서는 wp-cli 를 사용하여 search-replace 코어, 테마, 플러그인 업데이트 등 command-line 환경에서 어려운 작업을 손쉽게 처리할 수 있는데요,

카페24, 가비아 등의 국내 호스팅 환경에서는 호스팅 서버에 wp-cli 가 설치되어 있지 않아 아쉬울 때가 있습니다.

1회성으로 활용하기에 좋은 방법이 있어 소개드립니다.

서버에 SSH 로 접속하여 워드프레스 루트로 이동한 뒤 아래 명령어를 실행하여 wp-cli 파일을 다운로드 받습니다.

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

다운로드가 완료되면 아래 명령어를 통해 실행파일이 잘 작동하는지 확인합니다.

php ./wp-cli.phar --info

오류가 발생하지 않고 wp-cli 의 정보가 출력된다면, 성공입니다.

OS:     Linux 5.10.60.1-microsoft-standard-WSL2 #1 SMP Wed Aug 25 23:20:18 UTC 2021 x86_64
Shell:  /usr/bin/zsh
PHP binary:     /usr/bin/php8.1
PHP version:    8.1.0
php.ini used:   /etc/php/8.1/cli/php.ini
MySQL binary:   /usr/bin/mysql
MySQL version:  mysql  Ver 8.0.27-0ubuntu0.20.04.1 for Linux on x86_64 ((Ubuntu))
SQL modes:
WP-CLI root dir:        /home/wp-cli/
WP-CLI vendor dir:      /home/wp-cli/vendor
WP_CLI phar path:
WP-CLI packages dir:    /home/wp-cli/.wp-cli/packages/
WP-CLI global config:
WP-CLI project config:  /home/wp-cli/wp-cli.yml
WP-CLI version: 2.7.1

위와 같은 결과가 나오지 않고 Permission(권한) 관련 오류가 발생한다면, 아래 명령어로 권한을 조정 해 줍니다.

chmod +x ./wp-cli.phar

조금 더 명령어를 쉽게 할 수 있도록 파일명을 바꿉니다.

mv wp-cli.phar wp

이제 평소에 쓰든 wp 라는 명령어 대신 조금 더 긴 명령어(php ./wp)로 실행하면 wp-cli 가 작동합니다.

php ./wp core version

조금 더 길어진 명령어가 불편하다면 단축어를 등록하여 원래 사용방법대로 사용할 수도 있습니다.

우선 wp 파일을 적당한 곳으로 옮깁니다. (현지 콘솔 위치가 wp 파일이 있는 위치라고 가정)

mkdir ~/bin
mv ./wp ~/bin

.bash_profile 혹은 .profile 파일에 별칭 등록

vi ~/.bash_profile

적당한 위치에 아래 한 줄을 입력합니다 (PATH=$PATH…. 구문이 있다면 그 아래)

alias wp="php $HOME/bin/wp"

파일을 저장하고 나온 뒤(:wq) 아래 명령을 실행하거나 SSH 접속을 종료 후 다시 접속합니다.

source ~/.bash_profile

이제 내 호스팅 디렉토리 내 어디에서건 wp 명령어를 사용 가능합니다.