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.
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