Fatal error: Cannot redeclare (function) no PHP – Como corrigir o Erro

Como corrigir o erro “Fatal error: Cannot redeclare (function)” no PHP, entendendo exatamente o que o erro significa e como podemos soluciona-lo em diversos ambientes.

Fatal error: Cannot redeclare (function)

Infelizmente se você deu de cara com erro “Fatal error: Cannot redeclare (function)” é por que você está com sérios problemas. Sendo um erro de categoria “Fatal”, a execução do código é interrompida.

Sem panico, a solução é simples.

O erro é auto-explicativo, simplesmente ocorre pois não é possível declarar 2 funções com o mesmo nome.

Como resolver?

Primeira pergunta, você atualizou o seu sistema? Seu site? Ou atualizou algum componente dele, como um módulo, plugin?

Se sim, é possível que essa atualização tenha duplicado a função, a forma mais fácil de corrigir esse problema é restaurando o código.

Infelizmente você não tem o backup original ou não sabe como reverter a atualização? Vamos tentar resolver na mão então..

Alterando código para resolver o problema

Analisando o erro completo com mais calma:

PHP Fatal error: Cannot redeclare funcao_duplicada() (previously declared in /home/paste/arquivo.php:16) in /home/paste/arquivo2.php on line 40 

1 – Qual função está duplicada: Cannot redeclare funcao_duplicada()

2 – Aonde está a sua primeira declaração: /home/paste/arquivo.php:16

3 – Aonde está a segunda declaração, que está ocasionando o erro: /home/paste/arquivo2.php on line 40 

Como objetivo é colocar o site/sistema para funcionar novamente, você deverá editar o arquivo aonde está a segunda declaração e remover/comentar o código, que no nosso exemplo é arquivo2.php na linha 40.

Antes de apagar a função, faça uma cópia dela e compare com a função que está no arquivo aonde ela foi declarada pela primeira vez.

Se ambas as funções foram exatamente iguais, você não terá nenhum problema em comentar a função no “arquivo2.php”

Caso elas sejam diferentes, você deverá buscar auxilio especializado para resolver a situação, pois mesmo comentando a segunda declaração, poderá ocorrer erros internos devido a dependência nela.

Eu sou um programador

Sendo você um desenvolver, você terá que alterar o nome da função para cessar o erro e localizar aonde ela está sendo chamada.

Uma vez localizado, basta altera para o novo nome. Essa tarefa pode ser bem complicada pois a função já existe no sistema, então com certeza, a sua versão original já está sendo chamada em outros arquivos.

Você deverá preservar as chamadas originais! Anteriores ao problema de duplicidade.

Como resolvo isso durante o desenvolvimento?

Antes de incluir uma função qualquer em um plugin/módulo que você está desenvolvendo, caso a mesma não esteja sendo isolada dentro de uma classe, utilize a função nativa ‘function_exists’:

if (!function_exists('minhaFuncao')) {
/* coloque a sua função aqui */}else{
  die('Não foi póssivel iniciar o módulo, por favor entre em contato com suporte, função "minhaFuncao" duplicada');
}

A função ‘function_exists’ irá verificar se a função já existe, retornando true / false.