A versão 5.2 já está batendo na porta, mas você já atualizou sua plataforma Moodle pelo menos para o Moodle 5.1?
Se você administra uma plataforma Moodle, provavelmente já está acostumado com atualizações de versão. Mas o Moodle 5.1, lançado em outubro de 2025, trouxe uma mudança estrutural que vai além das funcionalidades: a reorganização completa dos diretórios do servidor.
Isso traz um enorme risco: se você não se preparar antes de iniciar a atualização, sua plataforma pode parar de funcionar.
Neste post, vamos explicar o que mudou, por que mudou e o que você precisa fazer, de forma prática, para garantir uma atualização tranquila.
Esta não é apenas uma atualização de funcionalidades. É uma mudança de arquitetura que afeta diretamente a configuração do servidor web.
O que mudou: o novo diretório /public
A principal novidade estrutural do Moodle 5.1 é a criação de um novo diretório chamado /public. A partir dessa versão, o servidor web precisa apontar seu document root para essa pasta e não mais para a pasta raiz do Moodle como era feito anteriormente.
Por que essa mudança é importante? Porque ela segue boas práticas modernas de segurança: ao expor publicamente apenas o que está dentro de /public, arquivos de configuração, credenciais e outros recursos sensíveis ficam protegidos de acessos indevidos.
O que acontece se você não configurar o servidor corretamente?
Administradores que realizarem o upgrade sem ajustar a configuração do servidor web podem se deparar com dois problemas sérios:
O site exibe uma listagem de diretórios no lugar da plataforma
O site retorna mensagens de erro logo na página inicial
Em ambos os casos, a plataforma fica inacessível aos usuários, o que é especialmente crítico em ambientes de produção.
Quanto aos plugins instalados? Atenção redobrada!
Aqui está um ponto que merece atenção especial: os plugins instalados anteriormente à versão 5.1 ficam em suas localizações originais, que agora estão fora do diretório /public. Para que continuem funcionando corretamente, eles precisam ser movidos manualmente para os locais adequados dentro da nova estrutura.
Isso significa que antes de atualizar, você deve:
Fazer um levantamento de todos os plugins instalados na sua plataforma
Verificar a compatibilidade de cada plugin com o Moodle 5.1
Planejar a relocação dos arquivos antes da atualização
Testar em ambiente de homologação antes de aplicar em produção
Plugins populares como o tema Moove, desenvolvido pela Conecti.me, já estão compatíveis com o Moodle 5.1 e com a nova estrutura de diretórios. Mas sempre verifique a versão instalada antes de atualizar.
O novo Routing Engine: URLs mais limpas e navegação mais eficiente
Junto com a reestruturação de diretórios, o Moodle 5.0 introduziu um novo Routing Engine (MDL-82565), um mecanismo que melhora a forma como as requisições são processadas internamente. O resultado visível para os usuários são URLs mais limpas e uma navegação mais fluida dentro da plataforma.
O uso do novo Routing Engine é fortemente recomendado pela equipe do Moodle, mas não é obrigatório: uma camada de compatibilidade foi incluída para manter o funcionamento de configurações mais antigas. Ainda assim, recomendamos que você planeje a ativação do roteamento, especialmente se for uma nova instalação.
Passo a passo para uma migração segura
Para administradores que estão planejando a atualização para o Moodle 5.1, recomendamos o seguinte fluxo:
Faça backup completo da plataforma (arquivos e banco de dados)
Atualize o ambiente de homologação primeiro
Configure o document root do servidor web para apontar para /public
Mova os plugins para os locais corretos dentro de /public
Teste todas as funcionalidades críticas no ambiente de homologação
Execute a atualização em produção no horário de menor uso
Monitore logs nas primeiras 24 horas após a atualização
Conclusão
A migração para o Moodle 5.1 exige mais planejamento do que uma atualização comum, especialmente por conta da nova estrutura de diretórios e dos ajustes no servidor web. Mas os benefícios em segurança e na base técnica da plataforma compensam o esforço.
Se você tem dúvidas sobre como realizar essa migração com segurança, ou quer garantir que seus plugins e temas personalizados continuarão funcionando após o upgrade, a equipe da Conecti.me pode te ajudar. Somos Moodle Partner oficial no Brasil e temos experiência em migrações de todos os portes.
Entre em contato e vamos planejar a sua atualização juntos.