Como corrigir Failed opening required no WordPress
O que é o erro Failed opening required?
O Failed opening required no WordPress é o erro fatal que o PHP emite quando uma instrução require ou require_once aponta para um arquivo que ele não consegue abrir: o caminho está errado, o arquivo foi apagado, a permissão impede a leitura ou um caminho absoluto de outro servidor sobrou após uma migração. Como o require é obrigatório (diferente do include), o PHP encerra o script imediatamente quando o arquivo falta, derrubando a página ou o site inteiro.
Como identificar
- Mensagem “Warning: require(/caminho/arquivo.php): Failed to open stream: No such file or directory” seguida de “Fatal error: Failed opening required ‘/caminho/arquivo.php'”.
- O caminho citado no erro aponta para um diretório de outro servidor (ex.: /home/usuário_antigo/…), sinal de migração mal resolvida.
- O erro surge após mover o site de hospedagem, atualizar um plugin que foi interrompida, ou excluir uma pasta de plugin/tema pela metade.
- A variação “Failed to open stream: Permission denied” aparece quando o arquivo existe, mas a permissão impede a leitura pelo PHP.
Como prevenir
- Use sempre ABSPATH, plugin_dir_path() e get_template_directory() em vez de caminhos absolutos fixos
- Após migrar de host, navegue pelo wp-admin e pelas páginas principais conferindo se nada quebrou
- Não interrompa atualizações de plugin pela metade e mantenha as permissões padrão (644/755)
Causa
- Arquivo incluído por require foi apagado, renomeado ou não foi copiado na migração para o novo servidor.
- Caminho absoluto fixo no código apontando para a estrutura de pastas do servidor antigo (ex.: /home/usuário/public_html), inválido no novo host.
- Atualização ou exclusão de plugin interrompida que deixou referências a arquivos que já não existem.
- Permissões erradas no arquivo ou na pasta, impedindo o PHP de ler o arquivo (Permission denied).
- ABSPATH ou o caminho do tema/plugin mal definido após mudar o domínio ou o diretório de instalação.
Como resolver
- Leia o caminho do arquivo no erro: a mensagem cita o caminho exato que o PHP tentou abrir. Veja se esse arquivo existe via FTP e se o caminho corresponde ao servidor atual, não ao antigo.
- Identifique o plugin ou tema dono do arquivo: o caminho normalmente fica dentro de wp-content/plugins ou wp-content/themes. Isso diz qual extensão está chamando o arquivo que falta.
- Reinstale o plugin ou tema afetado: se o arquivo faltante é de um plugin, desative-o via FTP renomeando a pasta, apague e reinstale a versão limpa. A reinstalação repõe os arquivos ausentes.
- Corrija caminhos absolutos da migração: se o caminho aponta para o servidor antigo, troque caminhos fixos por constantes do WordPress como ABSPATH, plugin_dir_path() ou get_template_directory().
- Ajuste as permissões do arquivo: se o erro for Permission denied, aplique as permissões padrão para o PHP conseguir ler:
chmod 644 para arquivos chmod 755 para pastas
// ERRADO: caminho absoluto fixo que quebra apos migrar de servidor
require_once '/home/usuario_antigo/public_html/wp-content/plugins/meu-plugin/lib.php';
// CERTO: caminho relativo a propria pasta do plugin, valido em qualquer host
require_once plugin_dir_path( __FILE__ ) . 'lib.php';
// Para arquivos do tema, use a funcao equivalente:
require_once get_template_directory() . '/inc/funcoes.php';Perguntas frequentes
O que significa No such file or directory no erro?
O erro cita o caminho do servidor antigo. Como resolvo?
Qual a diferença de Failed opening required para include?
Apareceu Permission denied em vez de No such file. O que muda?
Reinstalar o plugin apaga minhas configurações?
Posso corrigir sem mexer em FTP?
Como corrigir Call to undefined function no WordPress
O Call to undefined function é um erro fatal de PHP que aparece quando o código chama uma função que não existe naquele ponto: ou o nome está errado, ou a extensão que a fornece está desativada, ou a função do WordPress foi chamada cedo demais. O site cai com erro fatal na página afetada.
Como corrigir erro de timezone no PHP do WordPress
O erro de timezone no PHP do WordPress acontece quando a diretiva date.timezone não está definida no servidor, gerando avisos e horários incorretos em posts e agendamentos. O ajuste de fuso do site é feito nas configurações do WordPress, não com funções de timezone no PHP.
Como corrigir Headers already sent no WordPress
O headers already sent é um erro de PHP que aparece quando o WordPress tenta enviar um cabeçalho HTTP (um redirecionamento, um cookie de login) depois que algum conteúdo já foi enviado ao navegador. A causa quase sempre é um espaço em branco ou um echo antes ou depois das tags do PHP em um arquivo como o wp-config.php ou o functions.php.
Como corrigir a incompatibilidade do Tutor LMS com PHP 8.3
A incompatibilidade do Tutor LMS com PHP 8.3 acontece quando uma versão do plugin escrita para PHP 7.4 roda num servidor já no PHP 8.3, gerando avisos de Deprecated e, em alguns casos, erro fatal ao salvar cursos ou abrir o construtor de quiz. A documentação oficial homologa o plugin a partir do PHP 7.4.
Como corrigir Cannot redeclare function
O erro Cannot redeclare function é um erro fatal de PHP que ocorre quando a mesma função é definida duas vezes na execução. No WordPress, costuma surgir ao colar um snippet repetido no functions.php ou ao ativar dois plugins que declaram uma função com o mesmo nome.
Como ativar o modo de depuração (WP_DEBUG)
O WP_DEBUG é a constante do WordPress que liga o modo de depuração e faz o PHP exibir ou registrar os erros, avisos e notices que normalmente ficam escondidos. Ativá-lo é o primeiro passo para diagnosticar tela branca, erro fatal e conflitos de plugin, porque revela o arquivo e a linha exatos da falha.
