Post actualizado el día octubre 29, 2026 by DeiviSanzPlay
O XAMPP tornou-se o ambiente de desenvolvimento local mais utilizado para testar sites em PHP e MySQL. A sua instalação simples esconde, no entanto, uma realidade: quando algo falha, as mensagens que o Apache ou o MySQL mostram raramente explicam a causa real. Este guia reúne as falhas mais comuns e como resolvê-las sem reinstalar tudo do zero.
O Apache não arranca: a porta 80 está ocupada
É o problema mais frequente. O Skype, o IIS, alguns serviços de impressão ou até outro servidor web podem estar a usar a porta 80. Para confirmar no Windows, abre o símbolo do sistema como administrador e executa netstat -ano | findstr :80. A última coluna mostra o PID do processo que a ocupa. Se não precisares dele, fecha-o a partir do Gestor de Tarefas.
Se preferires manter ambos os serviços, edita o ficheiro httpd.conf dentro da pasta xampp/apache/conf e altera Listen 80 para Listen 8080. Faz o mesmo com ServerName localhost:8080. Depois, acede a http://localhost:8080.
O MySQL para imediatamente
Quando o painel de controlo mostra o MySQL a vermelho, verifica o ficheiro mysql_error.log em xampp/mysql/data. As causas típicas são:
- Porta 3306 ocupada por outra instância de MySQL ou MariaDB. Altera a porta em my.ini e reinicia.
- Ficheiros de dados corrompidos após um encerramento abrupto. Executa mysqld –innodb-force-recovery=1 a partir da consola para recuperar tabelas InnoDB.
- Permissões insuficientes na pasta data. No Windows, executa o XAMPP como administrador.
Erro «Access denied for user ‘root’@’localhost’»
Ocorre quando a palavra-passe de root mudou ou se perdeu. Para o MySQL, abre uma consola em xampp/mysql/bin e lança mysqld –skip-grant-tables. Noutra janela, entra com mysql -u root e executa ALTER USER ‘root’@’localhost’ IDENTIFIED BY »; seguido de FLUSH PRIVILEGES;. Reinicia o serviço e volta ao phpMyAdmin.
A página mostra código PHP em vez de o executar
Se o navegador mostra o código-fonte, o Apache não está a interpretar o PHP. Verifica que em httpd.conf exista a linha LoadModule php_module com o caminho correto para php8.x.x/php8apache2_4.dll. Verifica também que o bloco AddType application/x-httpd-php .php está presente. Um erro tipográfico no caminho quebra toda a execução.
O phpMyAdmin devolve erro 403 ou 404
Verifica o alias em xampp/apache/conf/extra/httpd-xampp.conf. Deve apontar para a pasta real do phpMyAdmin. Se alteraste a palavra-passe de root, atualiza o config.inc.php com as credenciais novas; caso contrário, verás um erro de autenticação que parece uma falha do servidor.
Erros de extensões: «PHP Startup: Unable to load dynamic library»
Ao ativar extension=gd ou extension=zip no php.ini, o caminho deve coincidir com a pasta ext. Verifica que a linha extension_dir aponta para xampp/php/ext com barras corretas. Se a DLL não existir, a solução passa por descarregar a versão exata do PHP ou desativar a extensão.
Conselhos para prevenir falhas futuras
Para o Apache e o MySQL a partir do painel antes de desligar o equipamento. Evita mover a pasta xampp para outro caminho depois de a instalar; se o fizeres, atualiza os caminhos nos ficheiros de configuração. Realiza cópias periódicas do htdocs e das bases de dados com mysqldump. E quando algo falhar, consulta sempre os logs antes de mexer nas configurações: apache/logs/error.log, mysql/data/mysql_error.log e php/logs/php_error_log contêm a pista exata.