Começando com o Zinnector®, a CLI para desenvolvedores

Zinnector® é a ferramenta de linha de comando gratuita e licenciada sob a licença MIT da Zinn Digital® para desenvolvedores do WordPress. Ela estrutura um site, executa um WordPress real na sua própria máquina sem nada instalado além do Node — sem Docker, sem MAMP, sem PHP no seu PATH — em seguida, verifica o que você construiu em relação ao espaço de hospedagem para o qual você está prestes a fazer o deploy e o envia. Este guia o leva do zero a um site em funcionamento em cerca de dois minutos e indica como é o sucesso em cada etapa para que você saiba quando algo deu errado.

O que você precisa

Node 24 ou mais recente. Execute node --version; deve retornar v24 ou superior. Instale o LTS atual em nodejs.org — no Windows winget install OpenJS.NodeJS.LTS, no macOS brew install node@24.
npm, que vem junto com o Node. O Zinnector® o usa uma vez para baixar o ambiente de execução do WordPress para o seu próprio cache.
git, apenas para zinnector push — os deploys são acionados a partir do seu repositório.
Docker, apenas se você solicitá-lo com --runtime docker. O ambiente de execução padrão não precisa de nenhum.

Nada abaixo exige uma conta. Uma chave de API só é necessária quando você alcança um espaço de hospedagem, em Deploying with Zinnector®.

Etapa 1 — instalá-lo

npm install -g zinnector

Se o npm exibir npm WARN EBADENGINE, sua versão do Node é anterior à >=24.18.1 declarada pelo pacote. A instalação é concluída mesmo assim, mas a CLI se recusará a ser executada. Atualize o Node primeiro e, em seguida, instale novamente.

Etapa 2 — verificar a versão

zinnector --version

Sucesso: um número de versão, por exemplo, 0.1.2. Se você vir "Zinnector® needs Node 24 or newer — this is Node 20.x", o binário está instalado, mas a sua versão do Node é muito antiga; o comando é encerrado com o código 78 em vez de realizar qualquer ação.

Etapa 3 — ler a ajuda

zinnector --help

Sucesso: um banner que nomeia os cinco comandos do fluxo (new, dev, link, check, push) e, em seguida, cada comando com um propósito de uma linha. Cada comando também aceita seu próprio --help — zinnector dev --help lista os sinalizadores de ambiente de execução, PHP e porta. A lista completa, com exemplos, está na command reference.

Etapa 4 — estruturar um site

zinnector new my-site

Sucesso: um cabeçalho Created my-site e uma lista dos arquivos gerados — zinnector.json, uma árvore wp-content com plugins/, themes/ e um auxiliar mu-plugins/, um .gitignore e um README — seguidos pelos próximos comandos a serem executados. Nada nele é um espaço reservado; o projeto inicializa tal como está. --template plugin ou --template theme estruturam um plugin ou um tema de blocos que é ativado no momento em que é criado.

Etapa 5 — executá-lo

cd my-site
zinnector dev

Na primeira vez, o Zinnector® pergunta uma vez antes de baixar o ambiente de execução do WordPress — cerca de 570 MB, pois ele carrega todas as compilações do PHP de 5.2 a 8.5 — para o seu próprio diretório de cache, nunca para o seu projeto. Responda Y, ou passe --yes para ignorar a pergunta. No Node 26 ou mais recente, ele também busca um Node 24 exclusivamente para o ambiente de execução (cerca de 30 MB, verificado em relação às somas de verificação de nodejs.org), porque o módulo nativo do ambiente de execução possui binários pré-compilados apenas para o Node 24 e 25; você não precisa de um compilador ou do Visual Studio.

Sucesso: um bloco que nomeia o projeto, a versão do PHP e a versão do WordPress, seguido de:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

Etapa 6 — abri-lo

Acesse http://127.0.0.1:9400 em um navegador. Sucesso: um site do WordPress recém-criado intitulado My WordPress Website, servido pela versão do PHP solicitada. http://127.0.0.1:9400/wp-admin abre o painel já conectado. Insira um plugin em wp-content/plugins/ ou um tema em wp-content/themes/ e ele estará lá na próxima atualização — o ambiente de execução serve esses diretórios diretamente do seu projeto.

Pressione Ctrl-C para parar. zinnector dev --once inicializa o ambiente de execução, imprime o que está efetivamente rodando (versão do PHP, versão do WordPress, extensões carregadas) e para — útil quando você quer uma comprovação em vez de uma promessa.

Para onde ir a seguir

Local development with zinnector dev — os dois ambientes de execução, escolha das versões do PHP e do WordPress, e o que é servido a partir de onde.
Deploying with Zinnector® — entrar, vincular o projeto a um espaço, realizar a verificação pré-voo, enviar.
The command reference — todos os comandos, sinalizadores e exemplos.
Troubleshooting — os erros que as pessoas realmente encontram e a correção para cada um.

A mesma documentação está no README do pacote em npm e no GitHub, onde problemas e pull requests são bem-vindos.