interface de linha de comando para WordPress

WP-CLI é a interface de linha de comando para o WordPress. Você pode atualizar plugins, configurar instalações multisite e muito mais, sem usar um navegador web.

a manutenção em curso é possível por:

a versão estável atual é a versão 2.4.0. Para anúncios, siga @wpcli no Twitter ou inscreva-se para atualizações de E-mail. Confira o roteiro para uma visão geral do que está planejado para os próximos lançamentos.

Status de Compilação tempo Médio para resolver um problema Percentagem de questões ainda em aberto

links Rápidos: a Utilização | Instalação | Suporte | Ampliação | Contribuir | Créditos

Uso de

WP-CLI fornece uma interface de linha de comando para muitas ações que você pode executar na administração do WordPress. Por exemplo, wp plugin install --activate (doc) permite que você instalar e ativar um plugin WordPress:

$ wp plugin install user-switching --activateInstalling 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 também inclui comandos para muitas coisas que você não pode fazer na administração do WordPress. Por exemplo, wp transient delete --all (doc) permite-lhe apagar um ou todos os transientes:

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

para uma introdução mais completa ao uso de WP-CLI, leia o Guia de Início Rápido. Ou, converse com os amigos shell para aprender sobre utilitários de linha de comando úteis.

já se sente confortável com o básico? Saltar para a lista completa de comandos para informações detalhadas sobre a gestão de temas e plugins, importação e exportação de dados, realizar operações de busca-substituição de banco de dados e muito mais.

instalar

descarregar o ficheiro Phar é o nosso método de instalação recomendado para a maioria dos utilizadores. Se precisar, consulte também a nossa documentação sobre métodos de instalação alternativos (compositor, Homebrew, Docker).

Antes de instalar o WP-CLI, por favor, certifique-se de que o seu ambiente atenda aos requisitos mínimos:

  • ambiente similar ao UNIX (OS X, Linux, FreeBSD, Cygwin); suporte limitado no ambiente Windows
  • PHP 5.6 ou mais tarde
  • WordPress 3.7 ou posterior. Versões mais antigas do que a versão mais recente do WordPress pode ter funcionalidade degradada

uma vez que você tenha verificado requisitos, baixar o WP-cli.phar arquivo usando wget ou curl:

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

em seguida, verifique o arquivo Phar para verificar se ele está funcionando:

php wp-cli.phar --info

Para usar o WP-CLI partir da linha de comando digitando wp, tornar o arquivo executável e movê-lo para algum lugar no seu CAMINHO. Por exemplo:

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

se o WP-CLI foi instalado com sucesso, deverá ver algo como isto quando executar wp --info:

$ wp --infoOS:Darwin 16.7.0 Darwin Kernel Version 16.7.0: Thu Jan 11 22:59:40 PST 2018; root:xnu-3789.73.8~1/RELEASE_X86_64 x86_64Shell:/bin/zshPHP binary: /usr/local/bin/phpPHP version: 7.0.22php.ini used: /etc/local/etc/php/7.0/php.iniWP-CLI root dir: /home/wp-cli/.wp-cli/vendor/wp-cli/wp-cliWP-CLI vendor dir: /home/wp-cli/.wp-cli/vendorWP-CLI packages dir: /home/wp-cli/.wp-cli/packages/WP-CLI global config: /home/wp-cli/.wp-cli/config.ymlWP-CLI project config:WP-CLI version: 2.4.0

actualizando

pode actualizar o WP-CLI com wp cli update (doc), ou repetindo os passos da instalação.

se WP-CLI pertence ao root ou a outro utilizador do sistema, terá de correr sudo wp cli update.Queres viver a vida no limite? Executar wp cli update --nightly para usar a última compilação nocturna de WP-CLI. A compilação noturna é mais ou menos estável o suficiente para você usar em seu ambiente de desenvolvimento, e sempre inclui as mais recentes e maiores características WP-CLI.

completações de Tabs

WP-CLI também vem com um script de completação de Tabs para Bash e ZSH. Faça o download do WP-completion.bash and source it from ~/.bash_profile:

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

não se esqueça de executar source ~/.bash_profile depois.

se utilizar zsh para a sua shell, poderá ter de carregar e iniciar bashcompinit antes de se abastecer. Coloque o seguinte no seu .zshrc:

autoload bashcompinitbashcompinitsource /FULL/PATH/TO/wp-completion.bash

Support

WP-CLI’s maintainers and contributors have limited availability to address general support questions. A versão atual do WP-CLI é a única versão oficialmente suportada.

Quando à procura de apoio, por favor, primeiro procure a sua pergunta nesses locais:

  • Problemas comuns e suas correções
  • WP-CLI manual
  • Aberto ou fechado problemas na WP-CLI GitHub organização
  • Threads com a tag ‘WP-CLI” no WordPress.org fórum de suporte
  • Perguntas com a tag ‘WP-CLI’ no WordPress StackExchange

Se você não encontrar uma resposta em um dos locais acima, você pode:

  • Junte-se a #cli canal no WordPress.org de Folga para conversar com quem quer que possa estar disponível no momento. Esta opção é melhor para perguntas rápidas.
  • Post a new thread in the WordPress.org fórum de suporte e tag it ‘WP-CLI’ para que seja visto pela comunidade.

GitHub issues are meant for tracking enhancements to and bugs of existing commands, not general support. Antes de enviar um relatório de bug, por favor reveja nossas melhores práticas para ajudar a garantir que seu problema seja tratado em tempo hábil.

por favor, não faça perguntas de suporte no Twitter. O Twitter não é um local aceitável para apoio porque: 1) é difícil manter conversas em menos de 280 personagens, e 2) Twitter não é um lugar onde alguém com a mesma pergunta pode procurar uma resposta em uma conversa anterior.Lembre-se, libre != gratis; a licença open source concede-lhe a liberdade de usar e modificar, mas não compromissos do tempo de outras pessoas. Por favor, seja respeitoso, e defina suas expectativas em conformidade.

Extending

a command is the atomic unit of WP-CLI functionality. wp plugin install (doc) é um comando. wp plugin activate (doc) é outro.

WP-CLI suporta registar qualquer classe, função ou Fecho ligáveis como um comando. Ele lê detalhes de Uso do phpdoc do callback. WP_CLI::add_command() (doc) é usado tanto para registro de comandos internos como de terceiros.

/** * 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 vem com dezenas de comandos. É mais fácil do que parece criar um comando WP-CLI personalizado. Leia os comandos cookbook para saber mais. Navegue nos documentos internos da API para descobrir uma variedade de funções úteis que pode usar no seu comando WP-CLI personalizado.

contribuindo

agradecemos que tenha tomado a iniciativa de contribuir para WP-CLI. É por tua causa, e da Comunidade à tua volta, que o WP-CLI é um grande projecto.

contribuir não se limita apenas ao código. Nós encorajamos você a contribuir da maneira que melhor se adapta às suas habilidades, escrevendo tutoriais, dando uma demonstração em sua meetup local, ajudando outros usuários com suas perguntas de suporte, ou revisando nossa documentação.

leia as nossas orientações no manual para uma introdução completa sobre como se pode envolver. Seguir essas diretrizes ajuda a comunicar que você respeita o tempo de outros colaboradores no projeto. Por sua vez, eles farão o seu melhor para retribuir esse respeito ao trabalhar com você, através de fusos horários e ao redor do mundo.

Leadership

WP-CLI tem um responsável pelo projecto: schlessera.Às vezes, concedemos acesso por escrito a colaboradores que tenham demonstrado, ao longo de um período de tempo, que são capazes e investidos em fazer avançar o projecto.

leia o documento de governação no manual para mais detalhes operacionais sobre o projecto.

créditos

além das bibliotecas definidas no compositor.json, temos usado código ou ideias de projetos a seguir:

  • Drush para… um monte de coisas
  • wpshell para wp shell
  • Gerar Miniaturas para wp media regenerate
  • Pesquisa-Substituir-DB para wp search-replace
  • WordPress-CLI-Exportador para wp export
  • WordPress-CLI-Importador para wp import
  • wordpress-plugin-testes para wp scaffold plugin-tests