Pular para o conteúdo principal

Executando PHPUnit com o Playground CLI

O Playground CLI inclui um subcomando php que executa scripts PHP diretamente no ambiente do Playground. Ao montar seu plugin ou tema no sistema de arquivos do Playground, você pode executar o PHPUnit sem a necessidade de um banco de dados local. Cada execução começa com uma instalação limpa do WordPress, garantindo que os testes fiquem totalmente isolados.

Este guia pressupõe que seu plugin ou tema tenha o PHPUnit instalado via Composer (composer require --dev phpunit/phpunit). O caminho vendor/bin/phpunit utilizado abaixo considera uma configuração padrão do Composer.

Executando testes​

A partir do diretório do seu plugin ou tema, execute o seguinte comando. Substitua themes/THEME_NAME pelo caminho para o seu plugin ou tema:

npx @wp-playground/cli@latest php \
--auto-mount \
-- \
/wordpress/wp-content/themes/THEME_NAME/vendor/bin/phpunit \
-c /wordpress/wp-content/themes/THEME_NAME/phpunit.xml.dist

A opção --auto-mount detecta se o diretório atual é um plugin, um tema ou uma instalação do WordPress e o monta no caminho correto dentro de /wordpress/wp-content/. O -- separa as opções da CLI dos argumentos passados ao interpretador PHP, e você pode fornecer quaisquer argumentos compatíveis com sua configuração do PHPUnit.

Para um plugin, o caminho utilizaria plugins/:

npx @wp-playground/cli@latest php \
--auto-mount \
-- \
/wordpress/wp-content/plugins/MY_PLUGIN/vendor/bin/phpunit \
-c /wordpress/wp-content/plugins/MY_PLUGIN/phpunit.xml.dist

Você também pode usar --mount para mapear explicitamente um diretório local a um caminho dentro do sistema de arquivos do Playground:

npx @wp-playground/cli@latest php \
--mount=.:/wordpress/wp-content/plugins/MY_PLUGIN \
-- \
/wordpress/wp-content/plugins/MY_PLUGIN/vendor/bin/phpunit \
-c /wordpress/wp-content/plugins/MY_PLUGIN/phpunit.xml.dist

Escolha de versões do PHP e do WordPress​

Use as opções --php e --wp para executar testes com versões específicas:

npx @wp-playground/cli@latest php \
--auto-mount \
--php=8.1 \
--wp=6.5 \
-- \
/wordpress/wp-content/plugins/MY_PLUGIN/vendor/bin/phpunit \
-c /wordpress/wp-content/plugins/MY_PLUGIN/phpunit.xml.dist

As versões suportadas do PHP variam de 7.4 a 8.5. Para o WordPress, você pode utilizar um número de versão específico, latest, nightly ou beta.

Próximos passos​