██████╗ ██╗ ██╗██████╗ ██████╗ ██████╗
██╔══██╗██║ ██║██╔══██╗██╔══██╗██╔═══██╗
██████╔╝███████║██████╔╝██████╔╝██║ ██║
██╔═══╝ ██╔══██║██╔══██╗██╔══██╗██║ ██║
██║ ██║ ██║██████╔╝██║ ██║╚██████╔╝
╚═╝ ╚═╝ ╚═╝╚═════╝ ╚═╝ ╚═╝ ╚═════╝
Your PHP Development Buddy
Ambiente portátil para desenvolvimento PHP contendo Apache, PHP e MySQL, sem necessidade de instalação como serviço do Windows. O PHBro foi criado para permitir alternar facilmente entre versões do PHP, iniciar e parar todo o ambiente através de um único comando e manter tudo isolado dentro da pasta do projeto.
- Apache 2.4
- PHP com múltiplas versões
- MySQL
- Ambiente portátil (não instala serviços no Windows)
- Seleção dinâmica e automática da versão do PHP
- Inicialização automatizada do banco de dados (
datadir) - Checklist de status dos serviços e portas em tempo real
- Reinicialização rápida do ambiente
- Reset completo do banco de dados via CLI
- Script único em lote (
.bat) para gerenciamento completo
Para conseguir executar o comando bro a partir de qualquer pasta no seu terminal (Prompt de Comando ou PowerShell), você pode adicionar a pasta raiz do PHBro às Variáveis de Ambiente do Windows:
- Copie o caminho completo da pasta onde o arquivo
bro.batestá localizado (ex:C:\Desenvolvimento\PHBro). - Pressione a tecla
Windows, digite "variáveis de ambiente" e selecione "Editar as variáveis de ambiente do sistema". - Clique no botão "Variáveis de Ambiente...".
- Na seção Variáveis do sistema (subindo ou descendo a lista), localize a variável
Pathe clique em "Editar...". - Clique em "Novo" e cole o caminho completo da pasta do PHBro.
- Clique em "OK" em todas as janelas para salvar.
- Abra um novo terminal e use o comando diretamente de onde quiser:
bro --status
PHBro/
│
├── bro.bat
├── www/
│
└── bin/
├── apache/
│
├── php/
│ ├── php8.2/
│ ├── php8.3/
│ └── php8.4/
│
├── mysql/
│
├── data/
│
├── logs/
│
├── my.ini
│
└── .php_version
- Windows 10 ou superior
- CMD (Prompt de Comando) ou PowerShell
- Não é necessário ter Apache, PHP ou MySQL previamente instalados ou configurados globalmente no sistema.
💡 Nota: Os passos de download abaixo são totalmente opcionais! O repositório do PHBro já vem configurado e acompanhado das versões mais recentes e estáveis dos binários do Apache, PHP e MySQL prontos para uso. Recorra a esta seção apenas se quiser adicionar novas versões por conta própria ou atualizar o ambiente manualmente.
Baixe a versão Win64 do Apache em: apachelounge.com/download/
Extraia para: bin/apache/httpd-2.4.xx/Apache24 (Exemplo: bin/apache/httpd-2.4.68/Apache24).
Caso mude o padrão da pasta, altere a variável APACHE_HOME dentro do bro.bat.
Baixe qualquer versão Thread Safe em: windows.php.net/download/
Extraia cada versão em uma pasta dedicada dentro de bin/php/ (ex: bin/php/php8.5).
Cada pasta deve conter diretamente os arquivos php.exe, php.ini e a pasta ext/.
Baixe o ZIP do MySQL Community Server em: dev.mysql.com/downloads/
Extraia o conteúdo em: bin/mysql. A estrutura deve manter o caminho bin/mysql/bin/mysqld.exe.
Abra o terminal na pasta do projeto (ou em qualquer local caso tenha configurado o Acesso Global) e execute:
bro --start
Na primeira execução, o PHBro irá automaticamente:
- Detectar as versões do PHP disponíveis em
bin/php/. - Solicitar qual delas você deseja utilizar (caso haja mais de uma) e salvar a escolha.
- Criar e inicializar o diretório de dados (
datadir) do MySQL de forma segura. - Subir os serviços do Apache e do MySQL em segundo plano.
Sempre que desejar alternar a versão do PHP que está rodando no ecossistema:
bro --php-select
A escolha será salva no arquivo oculto bin/.php_version e usada de forma automática em todas as inicializações seguintes.
bro --start
Inicia o Apache e o MySQL usando as configurações portáteis.
bro --start-clean
Força o encerramento de processos travados do Apache/MySQL na memória, limpa os arquivos de log antigos e inicia o ecossistema do zero. Ideal para quando o ambiente foi fechado incorretamente.
bro --stop
Encerra com segurança os servidores Apache e MySQL, liberando as portas do sistema.
bro --restart
Executa a rotina de parada completa, aguarda a liberação das portas pelo Windows e inicia o ambiente novamente.
bro --status
Valida se os processos estão ativos e realiza testes de conexão nas portas 8080 (Apache) e 3306 (MySQL).
bro --version
Retorna de forma limpa as versões atuais do script PHBro, do PHP ativo, do Apache e do MySQL.
bro --wipe-data
bin/data/. Todos os bancos de dados criados localmente serão permanentemente perdidos. Na próxima inicialização (--start), o MySQL recriará a estrutura limpa de fábrica.
bro --help
ou bro --h exibe o menu interativo com a listagem rápida de comandos diretamente no terminal.
- URL: http://localhost:8080
- Onde ficam meus projetos? Todos os seus arquivos
.phpe diretórios de projetos devem ser colocados dentro da pastawww/na raiz do PHBro.
- Host:
127.0.0.1 - Porta:
3306 - Usuário:
root - Senha: Sem senha por padrão (O banco é inicializado sem credenciais; sinta-se livre para definir uma senha posteriormente via Client SQL).
- Apache não inicia: Verifique se a porta
8080já está em uso por outra aplicação. Executebro --statuspara diagnosticar. - MySQL não inicia: Confirme se você já não possui uma instância global do MySQL ou MariaDB rodando nativamente na porta
3306. - Ambiente travado ou corrompido: Tente rodar o comando de inicialização limpa:
bro --start-clean.
Willian Juliate * GitHub: github.com/willianjuliate/PHBro
- Contato: contato@76sys.com.br
Este projeto é distribuído sob a Licença MIT. Sinta-se livre para utilizar, modificar e distribuir o PHBro da forma que melhor atender o seu fluxo de desenvolvimento local!