Operador @ em PHP: o que significa e como evitar armadilhas

O que está por trás do símbolo @ no PHP? Explicação para iniciantes

Se você já revisou código PHP de outras pessoas ou pesquisou no Stack Overflow, provavelmente já viu uma sintaxe estranha: @file_get_contents() ou @mysql_connect(). O que é esse "arroba" mágico antes da função? Para que serve e por que desenvolvedores experientes recomendam evitá-lo?

Neste artigo, vamos detalhar o operador de supressão de erros no PHP — o símbolo @. Você aprenderá como ele funciona, em quais situações pode ser usado e, principalmente, quais alternativas ao @ no PHP existem. Vamos lá!

O que o operador @ faz no PHP?

No PHP, o símbolo @ é o operador de controle de erros (error control operator). Sua única função é suprimir a exibição de erros que ocorrem durante a execução de uma expressão específica.

Quando o PHP encontra @ antes de uma função ou expressão, ele define temporariamente o nível de relatório de erros como zero para aquela chamada específica. Quaisquer avisos (warnings), notificações (notices) ou erros fatais não serão exibidos para o usuário.

Exemplo simples

<?php\n// Tentativa de abrir um arquivo inexistente\n$file = @file_get_contents('arquivo_inexistente.txt');\nif ($file === false) {\n    echo "Arquivo não encontrado, mas o erro foi ocultado!";\n}\n?>

Sem o @, o PHP exibiria:

Warning: file_get_contents(arquivo_inexistente.txt): failed to open stream: No such file or directory

Com o @ — silêncio total. O programa continua funcionando, e nós simplesmente recebemos false.

Como funciona o mecanismo de supressão de erros?

Internamente, o operador @ altera o valor de error_reporting para 0 durante a expressão atual. Após a execução, o nível é restaurado ao valor original.

É importante entender: o erro ainda ocorre. Ele simplesmente não é exibido. Além disso, se for um erro fatal (por exemplo, chamar uma função inexistente), o script ainda será encerrado, mas sem mensagem de erro — e você ficará sem saber o que deu errado.

<?php\n// Erro fatal — @ não vai salvar\n@funcao_inexistente(); // Chamada de função que não existe\necho "Este código não será executado";\n?>

Resultado: tela branca da morte (white screen of death). Nenhuma informação para depuração.

Onde o @ é mais comum?

O símbolo @ é frequentemente usado em código legado e projetos antigos. Cenários típicos:

\n
• Trabalho com arquivos — @fopen(), @unlink()
\n
• Conexão com banco de dados — @mysql_connect() (função obsoleta)
\n
• Requisições HTTP — @file_get_contents($url)
\n
• Gerenciamento de sessões — @session_start()
\n

Iniciantes costumam usar @ como uma "muleta" para não precisar lidar com as causas reais dos erros. Isso é uma má prática, e veja por quê.

Por que @ é prejudicial? 3 principais razões

1. Você perde o controle sobre os erros

Ao suprimir um erro, você se impede de corrigi-lo. Em vez de entender por que a função retornou false, você simplesmente ignora o problema. Com o tempo, esses erros "silenciosos" se acumulam e causam bugs inesperados.

2. Dificuldade na depuração

Imagine: seu script exibe uma página em branco. Você verifica todos os lugares possíveis, mas não há mensagens de erro. O motivo? O @ escondeu um erro fatal. Você perderá horas procurando exatamente onde está o "arroba".

3. Performance

O operador @ torna a execução do código mais lenta. O PHP precisa alternar os modos de relatório de erros e também processa