From 70f6b89c1f7eff97ba6db46f14388c418e1fc092 Mon Sep 17 00:00:00 2001 From: mialichidev23 Date: Mon, 9 Nov 2026 16:33:04 -0300 Subject: [PATCH] Add files via upload --- .../current/main/guides/phpunit-testing.md | 90 +++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/phpunit-testing.md diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/phpunit-testing.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/phpunit-testing.md new file mode 100644 index 0000000000..46f93b652a --- /dev/null +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/phpunit-testing.md @@ -0,0 +1,90 @@ +--- +title: Executando PHPUnit com o Playground CLI +slug: /guides/phpunit-testing +description: Execute testes PHPUnit para plugins e temas do WordPress usando o Playground CLI — sem precisar de banco de dados e com um ambiente limpo a cada execução. +sidebar_class_name: navbar-build-item +--- + + +O [Playground CLI](/developers/local-development/wp-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: + +```bash +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/`: + +```bash +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: + +```bash +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: + +```bash +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 + + +- [Documentação da CLI do Playground](/developers/local-development/wp-playground-cli) — referência completa da CLI e opções de configuração + +- [Testes E2E com Playwright](/guides/e2e-testing-with-playwright) — testes de ponta a ponta executados no navegador para plugins e temas do WordPress