Call to undefined function no WordPress: como corrigir

Tipo Erro de PHP

Nome do erro Call to undefined function EN: Call to undefined function

Severidade Grave

Descrição 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.

O que é o erro Call to undefined function?

O Call to undefined function no WordPress é o erro fatal que o PHP emite quando tenta executar uma função que não foi declarada no momento da chamada. Isso acontece quando um plugin ou tema usa uma função de outro plugin que está inativo, quando uma extensão do PHP (como mysqli, gd ou curl) não está instalada, ou quando o código chama uma função nativa do WordPress antes do core carregar. Como o PHP não encontra a função, ele para o script na hora e a página não abre.

Como identificar

Mensagem “Fatal error: Uncaught Error: Call to undefined function nome_da_função() in /caminho/arquivo.php on line N”, citando a função, o arquivo e a linha.
Variações citando funções do core como “Call to undefined function wp_get_current_user()” ou “Call to undefined function get_header()” quando um arquivo é acessado direto, fora do WordPress.
Variações citando extensões como “Call to undefined function mysqli_connect()” ou “Call to undefined function curl_init()”, indicando extensão do PHP ausente.
O erro surge logo após ativar ou desativar um plugin, atualizar o PHP do servidor ou colar um snippet no functions.php.

Antes de começar: Faça backup do functions.php e do wp-config.php antes de editar. Nunca instale uma extensão do PHP ou troque a versão do PHP em produção sem testar antes em homologação: uma extensão ausente pode derrubar outros plugins ao mesmo tempo.

Como prevenir

Declare dependências entre plugins e nunca desative um plugin do qual outro depende sem testar
Confira em Saúde do site se todas as extensões do PHP exigidas estão ativas após migrar de host ou trocar a versão do PHP
Envolva chamadas a funções de plugins opcionais em function_exists() nos seus snippets do functions.php

Causa

Plugin que fornece a função está desativado, enquanto outro plugin ou o tema ainda tenta chamá-la.
Extensão do PHP necessária (mysqli, gd, curl, mbstring, intl) não está instalada ou foi desativada no servidor.
Função nativa do WordPress chamada antes do core carregar, por acessar um arquivo PHP direto pela URL em vez de pelo fluxo do wp-load.
Nome da função digitado errado ou função que foi removida em uma versão mais nova do plugin/tema.
Snippet colado no functions.php que depende de um plugin que não está instalado naquele site.

Como resolver

Leia o nome da função e o arquivo no erro: a mensagem cita a função exata e o arquivo que a chamou (ex.: wc_get_product em wp-content/plugins/...). Esse nome diz de onde vem a dependência.
Reative o plugin que fornece a função: se a função é de outro plugin (ex.: funções com prefixo wc_ são do WooCommerce), reative esse plugin. O fatal some quando a dependência volta a estar ativa.
Confirme a extensão do PHP: se o erro cita mysqli_, curl_, gd_, mb_ ou intl, a extensão do PHP está faltando. Verifique em Ferramentas > Saúde do site > Info, ou peça ao host para ativar a extensão no painel.
Reverta a última edição do functions.php: se o erro surgiu após colar um snippet, remova o trecho adicionado por último via FTP. O código que rodava antes volta a funcionar.
Proteja chamadas opcionais com function_exists: para snippets que dependem de plugins que podem estar inativos, envolva a chamada em uma checagem para não derrubar o site quando a função não existir.

PHP

// Protege a chamada quando a funcao pode nao existir (plugin opcional inativo).
// Em vez de chamar direto e arriscar o fatal:
if ( function_exists( 'wc_get_product' ) ) {
    $produto = wc_get_product( $id );
} else {
    // WooCommerce inativo: segue sem quebrar o site
    $produto = null;
}

// Para extensoes do PHP, cheque a extensao antes de usar a funcao:
if ( extension_loaded( 'curl' ) ) {
    $ch = curl_init();
}

Perguntas frequentes

Por que o erro cita uma função do WordPress como get_header?

Quase sempre porque um arquivo PHP do tema ou plugin foi acessado direto pela URL, fora do fluxo do WordPress. Nesse caso o core não carregou e funções nativas não existem ainda. Acesse o site pela home, não pelo caminho do arquivo.

Call to undefined function mysqli_connect significa o quê?

Que a extensão mysqli do PHP não está instalada ou foi desativada no servidor. É comum após uma migração ou troca de versão do PHP. Ative a extensão mysqli no painel da hospedagem ou peça ao suporte do host.

Desativei um plugin e apareceu Call to undefined function. Por quê?

Outro plugin ou o tema dependia de uma função fornecida pelo plugin que você desativou. Reative-o, ou ajuste o código dependente para checar a função com function_exists() antes de chamá-la.

Como descubro de qual plugin é a função do erro?

O prefixo costuma denunciar a origem: wc_ é WooCommerce, edd_ é Easy Digital Downloads, et_ é Divi. Busque o nome da função no diretório wp-content/plugins via FTP para achar o arquivo que a declara.

O erro apareceu depois de atualizar o PHP. O que mudou?

Versões novas do PHP podem não carregar extensões antigas por padrão, ou o plugin pode usar uma função removida. Confira as extensões em Saúde do site e atualize plugins e tema para versões compatíveis com a nova versão do PHP.

Posso resolver sem mexer em FTP?

Se a causa é um plugin desativado, basta reativá-lo pelo wp-admin. Se for extensão do PHP, o ajuste é no painel da hospedagem. Só quando o erro vem de um snippet no functions.php é que costuma ser preciso editar o arquivo via FTP.

Grave

Como corrigir a incompatibilidade do Astra Pro com PHP 8.3

O erro de compatibilidade do Astra Pro com o PHP 8.3 acontece quando uma versão antiga do addon roda num servidor já no PHP 8.3, disparando avisos de deprecated ou um fatal error que derruba o front-end ou o Personalizar. A correção é alinhar tema, plugin Astra Pro e licença na versão mais recente.

Crítico

Como corrigir Parse error / syntax error no PHP

O parse error (syntax error) é um erro fatal de PHP que aparece quando há um erro de digitação no código, como uma chave, ponto e vírgula ou parêntese faltando. No WordPress, ele costuma surgir logo após editar o functions.php ou colar um snippet, e derruba a página exata onde o PHP não consegue interpretar o código.

Atenção

Como corrigir avisos de Deprecated no PHP 8 do WordPress

Os avisos de Deprecated no PHP 8 aparecem quando um plugin ou tema usa um recurso da linguagem que ainda funciona, mas foi marcado para remoção em versões futuras. Não derrubam o site, mas poluem a tela e os logs e indicam código desatualizado que pode quebrar de vez em um PHP mais novo.

Grave

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.

Grave

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.

Grave

Como corrigir Allowed memory size exhausted

O erro allowed memory size exhausted é um erro fatal de PHP que aparece quando um script do WordPress tenta usar mais memória do que o limite definido no servidor. O resultado é uma página em branco ou um aviso de erro fatal, geralmente disparado por um plugin pesado, importação de dados ou limite memory_limit baixo demais.

Setores

Extensões

Integrações

Como corrigir Call to undefined function no WordPress

O que é o erro Call to undefined function?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir a incompatibilidade do Astra Pro com PHP 8.3

Como corrigir Parse error / syntax error no PHP

Como corrigir avisos de Deprecated no PHP 8 do WordPress

Como corrigir a incompatibilidade do Tutor LMS com PHP 8.3

Como corrigir Headers already sent no WordPress

Como corrigir Allowed memory size exhausted

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos