Atualizar o Moodle sempre gera um frio na barriga, não é? Especialmente quando mudamos para uma versão tão significativa quanto a 5.1. Se você utiliza hospedagem compartilhada (como Hostgator ou Hostinger) e tem medo de enfrentar erros de banco de dados ou a temida tela de “página não encontrada”, este guia é para você.

No vídeo de hoje, Marcelo Claro ensina o passo a passo seguro para levar sua plataforma ao próximo nível, incluindo um script exclusivo para resolver problemas de hierarquia de pastas.

O Primeiro Passo: Backup e Versões Intermediárias

Nunca inicie uma atualização sem um backup completo. Da versão 4.5 para a 5.1, houve mudanças críticas no banco de dados e plugins.

Além disso, você não pode simplesmente “pular” de uma versão muito antiga direto para a 5.1. No vídeo, Marcelo demonstra que, estando na versão 4.1, é necessário primeiro saltar para a 4.3 antes de prosseguir para a 5.1.

Requisitos Técnicos: PHP e Ambiente

Antes de subir os arquivos, verifique o “Ambiente” no seu Moodle (Administração do site > Servidor > Ambiente). Para o Moodle 5.1, você precisará:

• PHP 8.2 ou superior (o ideal é já configurar para 8.3).

• Ajustes no arquivo php.ini para evitar avisos críticos, como o zend.exception_ignore_args.

O Mistério da Pasta “Public” no Moodle 5.1

Uma das maiores mudanças da versão 5.1 é a nova organização de arquivos, focada em segurança. Agora, os arquivos acessíveis pelo navegador ficam dentro de uma pasta chamada public, o que costuma causar erro 404 (página não encontrada) após a atualização.

Mudar o apontamento do servidor Apache nem sempre é possível em hospedagens compartilhadas. É aqui que entra o “pulo do gato” do Marcelo.

A Solução: Script “ajuste.php”

Para evitar configurações complexas de linha de comando ou terminais SSH, o vídeo fornece um script de ajuste.

1. Você coloca o arquivo ajuste.php na raiz do seu Moodle (onde fica o config.php).

2. Acessa o arquivo via navegador (ex: seusite.com.br/ajuste.php).

3. O script cria automaticamente um link simbólico, fazendo com que o servidor encontre os arquivos na nova estrutura sem quebrar o site.

——————————————————————————–

——————————————————————————–

Perguntas Frequentes (FAQ)

1. Posso atualizar direto da versão 4.1 para a 5.1? Não. O sistema exigirá que você passe por uma versão intermediária, como a 4.3, para garantir a integridade dos dados antes do salto final.

2. O que fazer se o meu Moodle estiver em uma subpasta (ex: /ead)? O script ajuste.php funciona perfeitamente! Você só precisa garantir que o colocou dentro da mesma pasta onde está o arquivo config.php da sua instalação.

3. O script de ajuste é seguro? Sim, ele apenas organiza a hierarquia de pastas para que o servidor encontre o Moodle 5.1. Marcelo recomenda que, após a atualização bem-sucedida, você apague o arquivo do servidor por segurança.

4. Por que o Moodle mudou a estrutura de pastas? A mudança foi feita para tornar a plataforma ainda mais segura, separando arquivos de configuração sensíveis daqueles que o usuário comum pode acessar pelo navegador.

O post LMS Moodle 5.1: como atualizar sem erros em hospedagem compartilhada (script grátis) apareceu primeiro em Madri Lab.