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.