{"id":39281,"date":"2026-08-20T12:13:43","date_gmt":"2026-08-20T15:13:43","guid":{"rendered":"https:\/\/www.yogh.com.br\/blog\/?p=39281"},"modified":"2026-08-20T15:23:12","modified_gmt":"2026-08-20T18:23:12","slug":"alerta-de-erro-critico-incompatibilidade-entre-o-wordpress-7-1-e-o-wp-rocket-e-como-corrigir","status":"publish","type":"post","link":"https:\/\/www.yogh.com.br\/blog\/alerta-de-erro-critico-incompatibilidade-entre-o-wordpress-7-1-e-o-wp-rocket-e-como-corrigir\/","title":{"rendered":"Alerta de Erro Cr\u00edtico: Incompatibilidade entre o WordPress 7.1 e o WP Rocket (E como corrigir)"},"content":{"rendered":"\n

O rec\u00e9m-lan\u00e7ado WordPress 7.1<\/strong> trouxe diversas novidades para a plataforma. No entanto, se voc\u00ea utiliza a vers\u00e3o atual do plugin de cache WP Rocket (3.23.2.2)<\/strong>, \u00e9 preciso ter muita cautela antes de apertar o bot\u00e3o de atualizar!<\/p>\n\n\n\n

Muitos usu\u00e1rios est\u00e3o relatando que a atualiza\u00e7\u00e3o direta para o WordPress 7.1 em ambiente de produ\u00e7\u00e3o est\u00e1 causando um erro cr\u00edtico<\/strong>, tirando os sites do ar instantaneamente.<\/p>\n\n\n\n

Neste post, vamos explicar o que est\u00e1 acontecendo e como voc\u00ea pode aplicar uma corre\u00e7\u00e3o manual para resolver o problema enquanto aguardamos uma atualiza\u00e7\u00e3o oficial do WP Rocket.<\/p>\n\n\n\n

<\/span>Qual \u00e9 o problema?<\/span><\/h2>\n\n\n\n

O problema ocorre devido a uma mudan\u00e7a no core<\/em> do WordPress 7.1. Uma fun\u00e7\u00e3o interna que anteriormente lidava com chaves (keys<\/code>) no formato de string<\/em> (texto) agora est\u00e1 passando essas chaves como int<\/em> (n\u00fameros inteiros).<\/p>\n\n\n\n

O WP Rocket possui um m\u00e9todo espec\u00edfico (unregister_callback<\/code>) que utiliza a fun\u00e7\u00e3o nativa do PHP substr()<\/code>. Como a fun\u00e7\u00e3o substr()<\/code> espera receber uma string<\/em> e o WordPress 7.1 passou a enviar um int<\/em>, ocorre um erro fatal (Fatal Error) que derruba a aplica\u00e7\u00e3o.<\/p>\n\n\n\n

O problema j\u00e1 foi identificado pela comunidade e reportado no GitHub oficial do plugin (Pull Request #8744<\/a>).<\/p>\n\n\n\n

<\/span>Como corrigir o problema manualmente<\/span><\/h2>\n\n\n\n

A equipe do WP Rocket j\u00e1 est\u00e1 ciente e uma corre\u00e7\u00e3o oficial deve ser lan\u00e7ada em breve. Por\u00e9m, se o seu site j\u00e1 saiu do ar ou se voc\u00ea precisa muito fazer a atualiza\u00e7\u00e3o agora, existe um fix<\/em> manual bem simples que resolve a situa\u00e7\u00e3o.<\/p>\n\n\n\n

Tudo o que precisamos fazer \u00e9 for\u00e7ar o PHP a converter a vari\u00e1vel $key<\/code> para uma string<\/em> (processo conhecido como type casting<\/em>) antes de pass\u00e1-la para a fun\u00e7\u00e3o substr()<\/code>.Passo a passo:<\/p>\n\n\n\n

    \n
  1. Acesse os arquivos do seu site via FTP ou pelo Gerenciador de Arquivos da sua hospedagem.<\/li>\n\n\n\n
  2. Navegue at\u00e9 a pasta do WP Rocket (geralmente em wp-content\/plugins\/wp-rocket\/<\/code>).<\/li>\n\n\n\n
  3. Voc\u00ea precisar\u00e1 editar o arquivo onde a fun\u00e7\u00e3o unregister_callback<\/code> est\u00e1 definida (com base no erro reportado, procure pelo arquivo que gerencia as callbacks<\/em> de hooks, possivelmente relacionado a integra\u00e7\u00f5es como a do Cloudflare).<\/li>\n\n\n\n
  4. V\u00e1 at\u00e9 a linha exata (por volta da linha 559) onde voc\u00ea encontra o seguinte c\u00f3digo:<\/li>\n<\/ol>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    foreach ( $original_wp_filter[ $priority ] as $key => $config ) {\n    if ( substr( $key, -strlen( $method ) ) !== $method ) {\n        continue;\n    }\n<\/code><\/pre>\n\n\n\n
      \n
    1. Substitua<\/strong> esse trecho for\u00e7ando o $key<\/code> a ser lido como (string)<\/code>, ficando desta forma:<\/li>\n<\/ol>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      foreach ( $original_wp_filter[ $priority ] as $key => $config ) {\n    \/\/ PHP casts numeric-string array keys to int, so $key is not always a string.\n    if ( substr( (string) $key, -strlen( $method ) ) !== $method ) {\n        continue;\n    }\n<\/code><\/pre>\n\n\n\n
        \n
      1. Salve o arquivo.<\/li>\n<\/ol>\n\n\n\n
        Com essa simples modifica\u00e7\u00e3o de adicionar o (string)<\/code> antes do $key<\/code>, a vers\u00e3o 3.23.2.2 do WP Rocket voltar\u00e1 a funcionar perfeitamente com o WordPress 7.1 e o seu site voltar\u00e1 ao ar.<\/p>\n\n\n\n
        <\/span>Recomenda\u00e7\u00e3o de Seguran\u00e7a<\/span><\/h3>\n\n\n\n
        Como sempre, evite atualizar grandes vers\u00f5es do WordPress diretamente em produ\u00e7\u00e3o<\/strong>, especialmente nos primeiros dias de lan\u00e7amento. Sempre teste as atualiza\u00e7\u00f5es em um ambiente de homologa\u00e7\u00e3o (staging<\/em>) para garantir que os seus plugins e o seu tema s\u00e3o 100% compat\u00edveis com a nova vers\u00e3o.<\/p>\n\n\n\n
        Se voc\u00ea ainda n\u00e3o atualizou para o WP 7.1 e usa o WP Rocket, a melhor recomenda\u00e7\u00e3o \u00e9 aguardar<\/strong> at\u00e9 que uma nova vers\u00e3o corrigida do plugin seja lan\u00e7ada oficialmente no painel do WordPress.<\/p>\n\n\n\n
        Ficou com alguma d\u00favida ou n\u00e3o est\u00e1 conseguindo editar o arquivo? Deixe um coment\u00e1rio abaixo para que possamos ajudar!<\/em><\/p>\n
        \n