Post actualizado el día octubre 29, 2026 by DeiviSanzPlay
XAMPP: por que falha e como corrigi-lo sem perder a cabeça
O XAMPP é o ambiente de desenvolvimento local mais difundido para testar sites PHP e bancos de dados MySQL. Sua popularidade não o livra de contratempos: portas ocupadas, serviços que não iniciam, permissões de pastas ou versões de PHP desalinhadas são os culpados habituais. Este guia repassa as falhas mais frequentes e oferece passos concretos para resolvê-las.
O Apache não inicia: o clássico conflito de portas
O sintoma mais comum é a mensagem que indica que o Apache parou inesperadamente. Quase sempre por trás está a porta 80 ocupada pelo Skype, IIS ou o serviço World Wide Web Publishing. Para confirmá-lo, abra um console e execute netstat -ano | findstr :80 no Windows; no macOS ou Linux use lsof -i :80. Se aparecer um processo alheio, feche-o ou altere a porta de escuta em httpd.conf (linha Listen 80) para 8080. Lembre-se de atualizar também ServerName localhost:8080 e acessar http://localhost:8080.
O MySQL/MariaDB se recusa a iniciar
Quando o painel mostra o MySQL em vermelho, verifique o arquivo mysql_error.log dentro de xampp/mysql/data. Duas causas se destacam: outra instância do MySQL já instalada no sistema ou um arquivo ibdata1 corrompido após um desligamento brusco. No primeiro caso, pare o serviço em services.msc. No segundo, renomeie a pasta data e execute novamente mysql_install_db a partir do console do XAMPP; você perderá os bancos de dados, então antes copie a pasta para um local seguro.
Erro 403 Forbidden ou acesso negado ao phpMyAdmin
A configuração de segurança do XAMPP restringe o acesso remoto. Abra xampp/apache/conf/extra/httpd-xampp.conf e localize o bloco <Directory «C:/xampp/phpMyAdmin»>. Altere Require local para Require all granted somente se você trabalhar em uma rede de confiança. Salve e reinicie o Apache. Se o problema persistir, verifique se o caminho real coincide com o declarado, especialmente quando você instalou o XAMPP em outra unidade.
O PHP não carrega extensões ou mostra a versão errada
Editar o php.ini sem reiniciar o Apache é um erro frequente: as alterações não surtem efeito. Verifique o caminho ativo com phpinfo() e certifique-se de modificar o arquivo correto (no Windows, xampp/php/php.ini). Se uma extensão como mysqli ou curl não aparecer, remova o ponto e vírgula inicial da linha correspondente. Para conviver com várias versões de PHP, utilize o seletor do painel de controle, que ajusta automaticamente o módulo do Apache.
Permissões e caminhos com caracteres especiais
Instalar o XAMPP dentro de «Arquivos de programa» ou em uma pasta com acentos provoca falhas silenciosas em scripts que gravam arquivos. A recomendação é um caminho simples, por exemplo C:xampp. No Linux, execute chmod -R 755 /opt/lampp/htdocs e certifique-se de que seu usuário pertence ao grupo proprietário da pasta para evitar erros de escrita ao enviar imagens ou gerar caches.
O painel de controle não responde
Se a janela do XAMPP congelar, feche todos os processos pelo gerenciador de tarefas (xampp-control.exe, httpd.exe, mysqld.exe) e abra-a novamente com permissões de administrador. Em alguns equipamentos com antivírus agressivo, adicionar a pasta de instalação às exclusões evita bloqueios intermitentes dos binários.
Verificação final
Após cada ajuste, reinicie os módulos pelo painel e visite http://localhost/dashboard. Se a página carregar e o phpMyAdmin abrir sem avisos, o ambiente está operacional. Documente as alterações realizadas em httpd.conf e php.ini: isso evitará repetir o diagnóstico na próxima atualização.