Como corrigir Undefined array key no PHP 8 do WordPress
O que é o aviso Undefined array key no PHP 8?
O Undefined array key no PHP 8 do WordPress é o aviso emitido quando o código acessa uma chave de array inexistente, como $_POST[‘campo’] sem que o campo tenha sido enviado, ou $opções[‘cor’] sem que essa opção exista no array. No PHP 7 isso gerava um notice mais discreto; no PHP 8.0 ele virou um Warning, mais visível. Não é fatal, então a página continua carregando, mas o aviso aparece e sinaliza que falta uma checagem de existência (isset ou null coalescing) antes de ler a chave.
Como identificar
- Mensagem “Warning: Undefined array key “nome_da_chave” in /caminho/arquivo.php on line N”, citando a chave, o arquivo e a linha.
- Variações com chave numérica, como “Warning: Undefined array key 0”, quando o código espera um item de array que não veio.
- Os avisos enchem o wp-content/debug.log e podem aparecer no topo de páginas, em formulários ou em telas de configuração de plugins.
- O problema apareceu logo após o host atualizar a versão do PHP do plano para 8.0 ou superior.
Como prevenir
- Sempre cheque chaves de $_POST, $_GET e de opções com isset() ou ?? antes de lê-las
- Mantenha plugins, tema e o core atualizados para versões compatíveis com o PHP 8
- Em produção, deixe WP_DEBUG_DISPLAY como false e acompanhe o debug.log
Causa
- Leitura de $_POST, $_GET ou $_REQUEST com uma chave que nem sempre é enviada (campo de formulário opcional ou ausente).
- Acesso a uma opção de plugin ou tema antes de ela existir no array salvo, comum na primeira execução após instalar.
- Plugin ou tema escrito para o PHP 7 que lia chaves inexistentes sem checar, o que só virou Warning no PHP 8.
- Resultado de uma função (como wp_parse_args ou shortcode_atts) acessado por uma chave que o array retornado não contém.
- WP_DEBUG e WP_DEBUG_DISPLAY ligados em produção, expondo os avisos ao visitante na tela.
Como resolver
- Localize a chave e o arquivo no aviso: a mensagem cita a chave entre aspas, o arquivo e a linha. Isso aponta exatamente qual acesso ao array está sem verificação.
- Atualize o plugin ou o tema responsável: se o arquivo citado é de um plugin ou tema, atualize-o. As versões compatíveis com o PHP 8 já protegem esses acessos a array.
- Proteja o acesso com isset ou coalescência nula: em código próprio, verifique a chave antes de ler, usando isset() ou o operador de coalescência nula com um valor padrão.
- Esconda os avisos do visitante em produção: no wp-config.php, registre os avisos no log mas não os exiba na tela enquanto corrige:
define('WP_DEBUG', true); define('WP_DEBUG_DISPLAY', false); define('WP_DEBUG_LOG', true); - Revise o debug.log após corrigir: depois de atualizar plugins e ajustar o código, confira o debug.log para confirmar que os avisos Undefined array key pararam de surgir.
// ANTES (dispara Warning: Undefined array key quando o campo nao vem):
$cidade = $_POST['cidade'];
// DEPOIS, opcao 1 — coalescencia nula com valor padrao:
$cidade = $_POST['cidade'] ?? '';
// DEPOIS, opcao 2 — checagem explicita antes de usar:
if ( isset( $_POST['cidade'] ) ) {
$cidade = sanitize_text_field( wp_unslash( $_POST['cidade'] ) );
} else {
$cidade = '';
}Perguntas frequentes
Undefined array key derruba o site?
Por que esse aviso só apareceu depois de atualizar o PHP?
Qual a diferença entre isset e o operador de coalescência nula?
O aviso vem de um plugin. Como corrijo?
Esconder o aviso com WP_DEBUG_DISPLAY resolve de vez?
Esse aviso pode indicar um bug de verdade?
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 Out of memory no PHP do WordPress
O erro out of memory no PHP do WordPress acontece quando um processo tenta alocar mais memória do que o limite do PHP ou a RAM do servidor têm disponível, e a execução para na hora. Costuma ser disparado por loops, consultas gigantes ou processos concorrentes em um servidor pequeno.
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 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.
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 atualizar a versão do PHP no WordPress com segurança
Atualizar a versão do PHP do WordPress deixa o site mais rápido e seguro, mas plugins ou temas antigos podem quebrar na versão nova. O caminho seguro é testar em uma cópia, conferir a compatibilidade e só então trocar a versão no painel da hospedagem, com como reverter à mão.
