Erro: Maximum execution time exceeded — Tempo limite de execução

Tipo Erros fatais

Nome do erro Erro: Maximum execution time exceeded — Tempo limite de execução

Severidade Crítico

Desde WordPress 1.0

Descrição Fatal error: Maximum execution time of 30 seconds exceeded. Ocorre em scripts longos como importações, processamentos em lote ou loops infinitos.

Causa

O PHP tem um limite padrão de 30 segundos para execução de scripts. Operações pesadas em page load, como importar CSVs ou processar imagens em lote, excedem esse limite.

Como resolver

Para tarefas longas, use o sistema de filas do WordPress (WP Cron + Action Scheduler). Se imprescindível aumentar o tempo, use set_time_limit() com cautela apenas em scripts CLI.

PHP

<?php
// ❌ ERRADO — processa tudo de uma vez em um request HTTP
function importar_csv_errado(string $arquivo): void {
    $linhas = file($arquivo); // pode ter 100k linhas
    foreach ($linhas as $linha) {
        // processar cada linha...
        wp_insert_post([/* ... */]);
    }
}

// ✅ CORRETO — processa em lotes usando WP Cron
function importar_csv_em_lotes(string $arquivo): void {
    $linhas    = file($arquivo);
    $total     = count($linhas);
    $lote_size = 50;

    for ($i = 0; $i < $total; $i += $lote_size) {
        $lote = array_slice($linhas, $i, $lote_size);
        // Agenda processamento do lote
        as_schedule_single_action(
            time() + ($i / $lote_size) * 5, // a cada 5s
            'processar_lote_csv',
            ['lote' => $lote, 'offset' => $i]
        );
    }
}

// ✅ Para WP-CLI onde faz sentido aumentar o limite
if (defined('WP_CLI') && WP_CLI) {
    set_time_limit(0);
    // processar em lote...
}

Erro: Allowed memory size exhausted — Memória PHP esgotada

Fatal error: Allowed memory size of X bytes exhausted. Ocorre quando o PHP tenta alocar mais memória do que o limite configurado no servidor.

Erro: Call to undefined function — Função não encontrada

Fatal error: Call to undefined function nome_da_funcao(). Ocorre quando uma função é chamada antes de ser definida ou quando um plugin/tema necessário não está ativo.

Pro

Erro: Allowed memory size exhausted — Memória esgotada

Fatal error: Allowed memory size of X bytes exhausted. Ocorre quando o PHP tenta alocar mais memória do que o limite configurado.

Parse error: syntax error — Erro de sintaxe no WordPress

Erro de sintaxe PHP que impede o carregamento do site. Ocorre quando um comando não é escrito corretamente no código.

Erro: Headers already sent — Cabeçalho já enviado

Warning: Cannot modify header information - headers already sent. Impede redirecionamentos e definição de cookies após qualquer saída de texto.

Erro: White Screen of Death — Tela branca no WordPress

Página em branco sem qualquer erro visível. Geralmente indica um erro PHP fatal que está sendo suprimido pela configuração de exibição de erros do servidor.