wp cli

WP-CLI

WP-CLI는 WordPress용 명령줄 인터페이스입니다. 웹 브라우저를 사용하지 않고도 플러그인 업데이트, 다중 사이트 설치 구성 등의 작업을 수행할 수 있습니다.

지속적인 유지 관리는 다음을 통해 가능합니다.

현재 안정 릴리스 버전은 2.11.0입니다. 공지 사항을 보려면 Twitter에서 @wpcli를 팔로우하거나 이메일 업데이트에 등록하세요. 향후 릴리스에 대한 계획에 대한 개요는 로드맵을 확인하세요.

빠른 링크: 사용 | 설치 | 지원 | 확장 | 기여 | 크레딧

사용

WP-CLI는 WordPress 관리자에서 수행할 수 있는 다양한 작업에 대한 명령줄 인터페이스를 제공합니다. 예를 들어, wp plugin install --activate (doc)를 사용하면 WordPress 플러그인을 설치하고 활성화할 수 있습니다.

$ wp plugin install user-switching --activate
Installing User Switching (1.0.9)
Downloading installation package from https://downloads.wordpress.org/plugin/user-switching.1.0.9.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating ' user-switching ' ...
Plugin ' user-switching ' activated.
Success: Installed 1 of 1 plugins.

WP-CLI에는 WordPress 관리자에서 수행할 수 없는 많은 작업에 대한 명령도 포함되어 있습니다. 예를 들어 wp transient delete --all (doc)을 사용하면 하나 또는 모든 임시 항목을 삭제할 수 있습니다.

$ wp transient delete --all
Success: 34 transients deleted from the database.

WP-CLI 사용에 대한 전체 소개를 보려면 빠른 시작 가이드를 읽어보세요. 또는 쉘 친구들과 만나 유용한 명령줄 유틸리티에 대해 알아보세요.

이미 기본 사항에 익숙해지셨나요? 테마 및 플러그인 관리, 데이터 가져오기 및 내보내기, 데이터베이스 검색-바꾸기 작업 수행 등에 대한 자세한 정보를 보려면 전체 명령 목록을 살펴보십시오.

설치 중

Phar 파일을 다운로드하는 것은 대부분의 사용자에게 권장되는 설치 방법입니다. 필요한 경우 대체 설치 방법(Composer, Homebrew, Docker)에 대한 설명서도 참조하세요.

WP-CLI를 설치하기 전에 환경이 최소 요구 사항을 충족하는지 확인하십시오.

• UNIX와 유사한 환경(OS X, Linux, FreeBSD, Cygwin); Windows 환경에서는 제한된 지원
• PHP 5.6 이상
• 워드프레스 3.7 이상. 최신 WordPress 릴리스보다 오래된 버전에서는 기능이 저하될 수 있습니다.

요구 사항을 확인한 후 wget 또는 curl 사용하여 wp-cli.phar 파일을 다운로드합니다.

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

다음으로 Phar 파일을 확인하여 작동하는지 확인합니다.

php wp-cli.phar --info

wp 입력하여 명령줄에서 WP-CLI를 사용하려면 파일을 실행 가능하게 만들고 PATH의 어딘가로 이동합니다. 예를 들어:

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

WP-CLI가 성공적으로 설치된 경우 wp --info 실행할 때 다음과 같은 내용이 표시되어야 합니다.

$ wp --info
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.11.0

업데이트 중

wp cli update (doc)를 사용하거나 설치 단계를 반복하여 WP-CLI를 업데이트할 수 있습니다.

WP-CLI를 루트 또는 다른 시스템 사용자가 소유한 경우 sudo wp cli update 실행해야 합니다.

가장자리에 있는 삶을 살고 싶나요? WP-CLI의 최신 야간 빌드를 사용하려면 wp cli update --nightly 실행하세요. Nightly 빌드는 개발 환경에서 사용할 수 있을 만큼 충분히 안정적이며 항상 최신 및 최고의 WP-CLI 기능을 포함합니다.

탭 완성

WP-CLI에는 Bash 및 ZSH용 탭 완성 스크립트도 함께 제공됩니다. wp-completion.bash를 다운로드하고 ~/.bash_profile 에서 소스를 얻으세요.

 source /FULL/PATH/TO/wp-completion.bash

나중에 source ~/.bash_profile 실행하는 것을 잊지 마세요.

쉘에 zsh를 사용하는 경우 소싱하기 전에 bashcompinit 로드하고 시작해야 할 수도 있습니다. .zshrc 에 다음을 입력하세요.

autoload bashcompinit
bashcompinit
source /FULL/PATH/TO/wp-completion.bash

지원하다

WP-CLI의 유지 관리 담당자와 기여자는 일반적인 지원 질문을 처리할 수 있는 시간이 제한되어 있습니다. WP-CLI의 현재 버전은 공식적으로 지원되는 유일한 버전입니다.

지원을 찾을 때 먼저 다음 장소에서 질문을 검색하십시오.

• 일반적인 문제 및 해결 방법
• WP-CLI 핸드북
• WP-CLI GitHub 조직의 공개 또는 종료된 문제
• WordPress.org 지원 포럼의 'WP-CLI' 태그가 지정된 스레드
• WordPress StackExchange에서 'WP-CLI' 태그가 붙은 질문

위의 장소 중 하나에서 답을 찾지 못한 경우 다음을 수행할 수 있습니다.

• WordPress.org Slack의 #cli 채널에 가입하여 해당 시간에 대화 가능한 사람과 채팅하세요. 이 옵션은 빠른 질문에 가장 적합합니다.
• WordPress.org 지원 포럼에 새 스레드를 게시하고 커뮤니티에서 볼 수 있도록 'WP-CLI' 태그를 지정하세요.

GitHub 문제는 일반 지원이 아닌 기존 명령의 개선 사항과 버그를 추적하기 위한 것입니다. 버그 보고서를 제출하기 전에 모범 사례를 검토하여 문제가 적시에 해결되도록 하세요.

트위터에서 지원 관련 질문을 하지 마세요. 트위터는 지원하기에 적합한 장소가 아닙니다. 1) 280자 미만으로는 대화를 나누기가 어렵습니다. 2) 트위터는 같은 질문을 가진 사람이 이전 대화에서 답변을 검색할 수 있는 곳이 아닙니다.

기억하세요, libre != gratis; 오픈 소스 라이선스는 귀하에게 사용 및 수정의 자유를 부여하지만 다른 사람의 시간을 약속하지는 않습니다. 존중하고 이에 따라 기대치를 설정하십시오.

확장

명령은 WP-CLI 기능의 원자 단위입니다. wp plugin install (doc)는 하나의 명령입니다. wp plugin activate (doc)는 또 다른 것입니다.

WP-CLI는 호출 가능한 클래스, 함수 또는 클로저를 명령으로 등록하는 것을 지원합니다. 콜백의 PHPdoc에서 사용 세부 정보를 읽습니다. WP_CLI::add_command() (doc)는 내부 및 타사 명령 등록에 모두 사용됩니다.

 /**
 * Delete an option from the database.
 *
 * Returns an error if the option didn't exist.
 *
 * ## OPTIONS
 *
 * <key>
 * : Key for the option.
 *
 * ## EXAMPLES
 *
 *     $ wp option delete my_option
 *     Success: Deleted 'my_option' option.
 */
$ delete_option_cmd = function ( $ args ) {
	list ( $ key ) = $ args ;

	if ( ! delete_option ( $ key ) ) {
		WP_CLI :: error ( " Could not delete ' $ key ' option. Does it exist? " );
	} else {
		WP_CLI :: success ( " Deleted ' $ key ' option. " );
	}
};
WP_CLI :: add_command ( ' option delete ' , $ delete_option_cmd );

WP-CLI에는 수십 개의 명령이 제공됩니다. 사용자 정의 WP-CLI 명령을 생성하는 것이 보기보다 쉽습니다. 자세히 알아보려면 명령 요리책을 읽어보세요. 내부 API 문서를 탐색하여 사용자 정의 WP-CLI 명령에 사용할 수 있는 다양한 유용한 기능을 찾아보세요.

기여

WP-CLI에 적극적으로 기여해 주셔서 감사합니다. WP-CLI가 이렇게 훌륭한 프로젝트가 된 것은 여러분과 여러분 주변의 커뮤니티 덕분입니다.

기여는 코드에만 국한되지 않습니다. 튜토리얼을 작성하고, 지역 모임에서 데모를 제공하고, 다른 사용자의 지원 질문을 돕거나, 문서를 수정하는 등 자신의 능력에 가장 적합한 방식으로 기여하는 것이 좋습니다.

참여 방법에 대한 철저한 소개를 보려면 핸드북에 있는 기여 지침을 읽어보세요. 이러한 지침을 따르면 프로젝트에 참여하는 다른 기여자의 시간을 존중한다는 점을 전달하는 데 도움이 됩니다. 결과적으로 그들은 시간대와 전 세계에서 귀하와 협력할 때 그러한 존중에 보답하기 위해 최선을 다할 것입니다.

지도

WP-CLI에는 schlessera라는 한 명의 프로젝트 관리자가 있습니다.

경우에 따라 우리는 일정 기간 동안 프로젝트 진행에 능력이 있고 투자했음을 입증한 기여자에게 쓰기 액세스 권한을 부여합니다.

프로젝트에 대한 자세한 운영 세부 정보는 핸드북의 거버넌스 문서를 읽어보세요.

크레딧

작곡가.json에 정의된 라이브러리 외에도 다음 프로젝트의 코드나 아이디어를 사용했습니다.

• Drush는... 많은 것들을 위해
• wp shell 쉘용 wpshell
• wp media regenerate 위한 썸네일 재생성
• wp search-replace 에 대한 검색 대체 DB
• wp export 위한 WordPress-CLI-Exporter
• wp import 위한 WordPress-CLI-Importer
• wp scaffold plugin-tests 위한 워드프레스 플러그인 테스트