Converter PHP para EXE

Um programa Windows, quiosque ou distribuição offline pode exigir um .exe em vez de um servidor web e navegador. Empacotar a aplicação PHP como um executável permite que os usuários a iniciem no Windows sem instalar e configurar PHP, Apache ou Nginx separadamente.

O que é o formato PHP

.php identifica um arquivo de código-fonte PHP, não uma aplicação independente. Ele contém código PHP do lado do servidor e também pode conter templates HTML; a interface pode depender de CSS, JavaScript, imagens, arquivos de configuração, pacotes Composer, bancos de dados e extensões PHP separados.

Apache, Nginx ou outro servidor compatível normalmente encaminha arquivos PHP para o interpretador PHP. Portanto, aplicações desenvolvidas com Laravel, Symfony, WordPress e frameworks semelhantes exigem o ambiente completo do projeto, e não apenas um arquivo .php. Os desenvolvedores editam PHP com Visual Studio Code, PhpStorm ou outro editor de texto.

O que é o formato EXE

.exe é um executável do Windows, geralmente usando o formato Portable Executable. O Windows pode iniciá-lo como um programa desktop ou de linha de comando, sujeito à arquitetura, às permissões e às políticas de segurança.

Para projetos PHP, um EXE normalmente é um runtime e inicializador empacotados, e não PHP convertido em código de máquina nativo. O pacote pode conter o interpretador PHP para Windows, arquivos da aplicação, um servidor web local e um mecanismo de navegador incorporado. Isso permite ferramentas offline, utilitários internos, quiosques e interfaces no estilo desktop em computadores Windows sem um servidor PHP configurado separadamente.

Como empacotar PHP como EXE

Usar ExeOutput for PHP

ExeOutput for PHP é uma ferramenta comercial de empacotamento para Windows desenvolvida para transformar aplicações web PHP em aplicações desktop. Ela incorpora o runtime PHP e a interface do navegador; confirme se a versão atual é compatível com a versão do PHP e as extensões usadas pelo projeto.

1. Execute primeiro a aplicação em um ambiente local normal e verifique o roteamento, o acesso ao banco de dados, os uploads, a autenticação e as extensões PHP necessárias.
2. Crie um projeto no ExeOutput for PHP e selecione a raiz de documentos da aplicação e a página inicial, como index.php.
3. Adicione o código-fonte PHP, templates, CSS, JavaScript, imagens, dependências do Composer, arquivos de configuração e outros recursos necessários em runtime. Exclua arquivos usados apenas no desenvolvimento, como .git, testes, caches e secrets locais.
4. Selecione a versão incorporada do PHP e habilite todas as extensões necessárias do Windows, como mbstring ou pdo_mysql. Use builds de extensões compatíveis com o Windows, correspondentes à versão do PHP e à arquitetura de 32 ou 64 bits.
5. Configure a URL de inicialização, o nome da aplicação, o ícone, o comportamento da janela, os diretórios com permissão de escrita, as configurações do banco de dados e as opções do instalador; em seguida, use o comando de build ou compile do projeto.
6. Teste o executável gerado em um sistema Windows limpo. Verifique o tratamento de caminhos, a reescrita de URLs, as permissões de arquivos, a impressão, os certificados, as APIs externas, as conexões de banco de dados e o comportamento do antivírus ou do SmartScreen antes da distribuição.

Usar PHP Desktop

PHP Desktop é uma alternativa open source que combina um runtime PHP, um servidor web local e uma janela de navegador baseada no Chromium. As versões diferem quanto às versões compatíveis do PHP, Chromium e Windows; portanto, selecione uma versão mantida compatível com a aplicação.

1. Baixe a versão correspondente do PHP Desktop e copie a aplicação para o diretório web-root.
2. Defina a raiz de documentos, a página inicial, como index.php, as opções da janela e outras configurações em settings.json.
3. Copie os pacotes Composer, os recursos e as extensões PHP compatíveis para o bundle e teste-o em uma instalação limpa do Windows.
4. Distribua o diretório completo da aplicação ou crie um instalador com uma ferramenta como o Inno Setup. O PHP Desktop não é necessariamente um compilador de EXE de arquivo único.

Utilitários antigos, como o Bambalam PHP EXE Compiler, têm como alvo versões obsoletas do PHP. Use-os somente para código legado que tenha sido testado com seu runtime exato; eles não são opções padrão adequadas para PHP 8, frameworks atuais e aplicações que exigem extensões modernas.

Conversores online e alternativas

Não existe um conversor online geral de boa reputação que possa transformar de forma confiável uma aplicação web PHP em um EXE funcional para Windows. Um serviço precisaria da árvore completa do código-fonte, das dependências do Composer, das extensões PHP, da configuração do servidor e possivelmente dos dados do banco de dados; o upload desse material também expõe o código-fonte e as credenciais.

Serviços online de execução ou compilação de PHP são úteis para testar pequenos exemplos de código, não para produzir uma aplicação desktop distribuível. Use uma ferramenta local de empacotamento para Windows e remova secrets dos arquivos de configuração antes do build.

Limitações de compatibilidade

Essa conversão é empacotamento, não compilação nativa. O interpretador PHP ainda é executado em runtime, e o resultado continua específico do Windows. Módulos Apache, regras de reescrita do Nginx, tarefas cron, serviços Docker, comandos de shell do Linux, observadores de arquivos e workers em segundo plano gerenciados pelo servidor podem exigir uma reformulação.

As dependências do Composer e as extensões devem corresponder à versão incorporada do PHP e à arquitetura do Windows. Extensões do Linux não podem ser copiadas para um bundle do Windows. Substitua caminhos web codificados diretamente, separadores de caminho do Linux, variáveis de ambiente indisponíveis, suposições sobre reescrita do servidor e configurações inadequadas de conexão com o banco de dados.

Um EXE incorporado não garante a proteção do código-fonte: arquivos PHP e recursos da aplicação podem ser extraídos. Não incorpore senhas de banco de dados, secrets de API, chaves privadas ou outras credenciais em arquivos distribuíveis; use uma configuração protegida, um serviço remoto ou um armazenamento de credenciais do Windows quando apropriado.