O XAMPP é uma plataforma útil para desenvolvedores WordPress que estão procurando uma solução local. No entanto, alguns problemas podem aparecer quando você estiver usando esta ferramenta. Estes erros podem atrasar seu fluxo de trabalho e deixar você inseguro sobre como colocar o XAMPP em funcionamento novamente, especialmente porque tudo pode parecer estar em ordem na superfície.
Felizmente, uma vez identificada a razão pela qual o XAMPP não está começando para você, muitas vezes são necessários apenas alguns ajustes para corrigir. Você pode então voltar imediatamente ao trabalho em seu último projeto de desenvolvimento.
Neste artigo, daremos uma breve visão geral do que o XAMPP é para aqueles que são novos na plataforma. Depois mostraremos como verificar seus registros de erros e resolver três problemas comuns que podem impedir que seu servidor local inicie. Vamos mergulhar!
Uma breve introdução ao XAMPP
O XAMPP é uma ferramenta de desenvolvimento local gratuita. Ele funciona essencialmente como um servidor em seu computador que você pode usar para hospedar sites – tal como DevKinsta, o nosso próprio aplicativo de desenvolvimento local gratuita.
Note que estes sites não estão disponíveis publicamente para os usuários na Internet aberta. Ao contrário, eles devem ser usados localmente para fins de desenvolvimento e testes. Se você desejar, você pode migrar cada projeto para um servidor ao vivo uma vez terminado.
O XAMPP é uma solução útil porque impede que os visitantes encontrem seu projeto enquanto ele ainda está em andamento. Além disso, como o site está hospedado em seu computador, seu desempenho deve ser excelente e você pode trabalhar off-line.
Você pode usar o XAMPP em qualquer Sistema Operacional (SO) principal, incluindo Windows, MacOS e Ubuntu Linux. Ele usa o servidor Apache de código aberto e MySQL, e vem com várias ferramentas embutidas como phpMyAdmin e FileZilla.
Quando se trata do WordPress em particular, o XAMPP é uma das principais soluções locais porque atende a todos os requisitos do Content Management System (CMS’s). Estes incluem:
- PHP 7.4
- MySQL 5.6
- Suporte HTTPS
- Servidor Apache ou NGINX
Se você estiver interessado em instalar o XAMPP, você pode conferir nosso tutorial de instalação do WordPress localmente, que inclui instruções para esta tarefa.
Como verificar seu log de erros PHP do XAMPP
Caso você esteja desenvolvendo um site WordPress localmente usando XAMPP e não consiga iniciar a plataforma, seu primeiro passo deve ser verificar seus registros de erros. Isto pode apontar para a direção da causa do problema.
Se você sabe porque o problema está ocorrendo, você deve ser capaz de resolvê-lo muito mais rápido do que solucioná-lo por tentativa e erro. Os logs são acessados por diferentes caminhos, dependendo do seu sistema operacional e versão. Felizmente, há uma maneira simples de encontrar o caminho para sua configuração.
No Windows, o registro de atividades do XAMPP aparece na metade inferior da caixa de diálogo do painel de controle. Você também pode acessar o log de erros clicando no botão Logs ao lado do botão Config do Apache:
Em macOS, clique na aba Log no painel de controle para ver o log de atividades:
Você pode então dar uma olhada em seus registros para ver se há algo suspeito e seguir quaisquer diretrizes fornecidas para resolver o(s) problema(s).
Em alguns casos pode ser benéfico ter acesso a seu log PHP também, embora isso seja normalmente mais útil para solucionar erros do WordPress do que os erros do Apache ou MySQL.
Para localizar seus registros de erros PHP, abra o painel do XAMPP digitando http://localhost na barra de endereços do seu navegador. Lá, clique em PHPInfo na parte superior da tela:
Em seguida, procure por “error_log”. Isto revelará o caminho que você precisa entrar em sua barra de endereço para visualizar o log:
Você deve ser capaz de simplesmente digitar este caminho em seu navegador após http://localhost para visualizar o log PHP.
Acessando seus logs PHP XAMPP-VM no Mac
Existem na verdade duas versões do XAMPP para usuários Mac – “XAMPP para MacOS” e “XAMPP-VM“. Esta última permite executar o XAMPP para Linux em seu Mac, usando uma máquina virtual.
É importante saber qual versão você está usando porque ela determina como você acessa os arquivos-chave que estaremos referenciando ao longo deste artigo. Por exemplo, se você estiver usando XAMPP para OS X, você pode simplesmente abrir o Finder, ir para Aplicativos > XAMPP, e procurar a pasta de logs para encontrar seu log PHP.
Entretanto, se você estiver usando XAMPP-VM, primeiro você precisa abrir o painel de controle do XAMPP, clicar na aba Volumes e selecionar Montar:
Em seguida, ao iniciar o Finder, clique em seu endereço IP no menu do lado esquerdo e abra a pasta de lampp. É aqui que você encontrará todos os seus arquivos XAMPP, incluindo seus logs de erros PHP.
Como corrigir o XAMPP se não estiver funcionando (3 soluções comuns)
Se seus registros de erros não estiverem disponíveis sobre a causa do problema, você pode tentar estas soluções para fazer o XAMPP funcionar novamente. Estas dicas também elaboram algumas das instruções que seu registro de erros pode estar mostrando.
1. Resolver conflitos na porta no Apache
Se o Apache não puder iniciar, você não poderá acessar seu painel de controle do XAMPP ou quaisquer sites que você tenha instalado na plataforma. Um conflito de portas pode ser o problema subjacente.
Por padrão, o Apache se conecta através da porta 80. Se você vir uma mensagem de erro que diz que esta porta já está em uso, outro aplicativo está bloqueando a conexão (o Skype é um infrator freqüente).
Se você clicar no botão Netstat no painel de controle do XAMPP, ele deverá mostrar todas as portas que estão em uso no momento, e quais aplicativos estão usando-as. Você pode querer verificar isto se o Apache do XAMPP não estiver iniciando:
Se você sabe qual programa é o problema e pode desbloquear a porta removendo o aplicativo que está no caminho, isto resolverá o problema imediatamente. Entretanto, você também pode mudar a porta de escuta Apache para XAMPP, de modo que você se conecte enquanto deixa suas outras plataformas intactas.
Primeiro, você precisará encontrar seu arquivo httpd.conf. Este processo é ligeiramente diferente dependendo do seu sistema operacional e de qual versão do XAMPP você está usando.
Mudando sua porta Apache do XAMPP no Windows
No Windows, abra o painel de controle do XAMPP e clique no botão Config:
Em seguida, selecione httpd.conf. Procure neste arquivo a linha que diz “Listen 80”, e mude-a para “Listen 8080”. Isto permitirá que você se conecte ao Apache pela porta 8080, ao invés da opção padrão.
Você também precisará procurar a linha que lê ServerName localhost:80, e mudar isto para ServerName localhost:8080. Salve e feche o arquivo.
Em seguida, tente iniciar o Apache novamente. Se este fosse seu único problema, a plataforma deveria funcionar como pretendido. Entretanto, observe que se você tiver uma instalação WordPress hospedada via XAMPP, você precisará encontrar e substituir todas as menções de “localhost” por “localhost:8080”, incluindo aquelas em seu banco de dados.
Mudando sua porta Apache XAMPP no Mac
Se você estiver executando XAMPP para macOS, você pode encontrar seu arquivo httpd.conf acessando Aplicativos > XAMPP no Finder. Uma vez encontrado o arquivo, você pode executar os mesmos passos para mudar sua porta que descrevemos para os usuários do Windows.
Para aqueles que utilizam o XAMPP-VM, role até a seção onde explicamos como acessar seus registros de erros para aprender como encontrar seus arquivos XAMPP. Uma vez que você acesse o diretório lampp, você encontrará httpd.conf em apache2 > conf.
2. Inclua a porta de escuta no endereço ao acessar o Localhost
Normalmente, você pode simplesmente digitar http://localhost na barra de endereços do seu navegador para acessar seus sites ou painel de controle hospedados no XAMPP. A plataforma se conecta automaticamente ao Apache sobre sua porta de escuta padrão, 80.
Entretanto, se você mudou a porta de escuta da sua instalação XAMPP (ou alguém com acesso ao seu computador o fez), ele não será capaz de se conectar. Você também pode ver isso ocorrer se houver um conflito de portas Apache, como descrito acima.
Este problema pode ser bastante confuso porque o painel de controle do XAMPP pode mostrar que o Apache e o MySQL estão ambos em execução. Entretanto, você não poderá acessar seu site ou ferramentas como PHPInfo ou phpMyAdmin.
Este erro pode assumir algumas formas diferentes. Se você estiver tentando acessar seu site WordPress local, você pode ver uma página de erro 404. Os usuários cromados podem ver ERR_CONNECTION_REFUSED em seu lugar:
Felizmente, a solução é bastante simples. Basta anexar a porta de escuta ao endereço. Por exemplo, se você estiver usando a porta alternativa mais comum, você entraria em http://localhost:8080 ao invés de apenas http://localhost.
No entanto, se você gostaria de poder simplesmente entrar no local, mesmo que tenha mudado sua porta de escuta Apache, você pode fazer isso.
Mudando a porta padrão no Windows
Os usuários do Windows mudam a porta padrão do Apache XAMPP para sua nova porta de escuta para que você não tenha que especificá-la na barra de endereços. Para fazer isso, clique em Config > Service and Port Settings > Apache no painel de controle do XAMPP:
Em seguida, substitua o valor da porta principal pela nova porta Apache que você configurou e salve suas alterações.
Configuração do encaminhamento de portas no MacOS
Em macOS, o processo é bem diferente. Em seu painel de controle, clique na aba Rede. Aqui você pode configurar as regras de encaminhamento de portas:
Você vai querer adicionar uma nova regra que redireciona o tráfego para a porta padrão para sua nova porta de escuta Apache. Se você clicar em Adicionar, você poderá inserir estes valores nos campos relevantes:
Selecione a regra da lista e clique no botão Ativar para começar a usá-la.
3. Mude sua porta MySQL
Finalmente, às vezes o XAMPP não está funcionando devido a um problema com o MySQL, ao invés do Apache. Entretanto, o problema ainda é muitas vezes um conflito portuário, o que significa que até agora você já deve ter uma boa idéia de como resolvê-lo.
Neste caso, você precisará acessar seu arquivo php.ini ao invés do seu arquivo de configuração. Navegando até seu painel do XAMPP e clicando em PHPInfo como descrito anteriormente neste artigo, você poderá encontrar o caminho para este arquivo para sua instalação:
Alternativamente, se você estiver usando XAMPP para Windows, você pode acessar este arquivo do painel de controle clicando em Config > PHP (php.ini):
Quando encontrar e abrir o php.ini, procure as linhas que lêem a port = 3306, e troque-as para ler a port = 3307. Salve e feche o arquivo, e então reinicie o MySQL.
Resumo
O XAMPP é uma ferramenta útil para ter em seu canto, mas pode ser frustrante para resolver certos erros que o impedem de acessar seu site WordPress local. Felizmente, estes são frequentemente conflitos de portas para os quais você pode implementar rapidamente soluções de trabalho.
Neste artigo, mostramos o que fazer se o XAMPP não estiver funcionando devido a um problema com o Apache ou o MySQL:
- Resolva os conflitos de portas no Apache mudando sua porta de escuta para 8080.
- Incluir a porta de escuta no endereço ao acessar o localhost.
- Mude sua porta MySQL para 3307 se outro aplicativo estiver bloqueando a porta padrão 3306.
Não deixe de verificar o DevKinsta como alternativa ao XAMPP.
