Instalar o Moodle 5 a partir do Softaculous

Desde a versão 5.1, o Moodle separa o que é publicado na web do resto do código. O que é público fica numa pasta public e o código, a configuração e as bibliotecas ficam um nível acima, onde nenhum visitante chega. O Softaculous resolve-o assim: instala o código na pasta acima da do domínio e usa a pasta do domínio como public.

Por isso, antes de instalar, a pasta do domínio tem de estar preparada para isso. Este guia explica como fazê-lo e o que verificar antes.

Requisitos

Além disso, o PHP tem de ter ativada a extensão sodium e max_input_vars em 5000 ou mais. O Moodle 5.3 é uma versão LTS, com atualizações de segurança até outubro de 2029. Os requisitos completos estão nas notas do Moodle 5.3.

Para saber que base de dados tem o seu servidor, entre no seu alojamento na área de cliente e abra Ficha técnica. O cartão Base de dados e SSL mostra a versão:

• 8.0: é MySQL 8.0 e o Moodle 5 não funciona com ela. Veja o que fazer se o seu servidor tiver MySQL 8.0.
• 11.4 ou superior: é MariaDB e admite qualquer versão do Moodle 5.

Defina o PHP 8.3 ou 8.4 para a conta ou apenas para a pasta onde vai ficar o Moodle. Não use o PHP 8.5: não está entre as versões que o Moodle 5.3 admite. No mesmo ecrã de PHP, ative sodium e aumente max_input_vars para 5000 se tiver menos.

Preparar o subdomínio

O mais simples é instalar o Moodle num subdomínio, como aula.oseudominio.com, com uma pasta própria que termine em /public:

1. Aceda ao cPanel e abra Domains.
2. Clique em Create a New Domain e escreva o subdomínio, por exemplo aula.oseudominio.com.
3. Desmarque Share document root se aparecer marcado.
4. Em Document Root, escreva aula.oseudominio.com/public. O cPanel criará a pasta /home/usuario/aula.oseudominio.com/public.
5. Clique em Submit.
6. Aguarde que o subdomínio tenha o seu certificado SSL antes de instalar: o Moodle é configurado com o endereço https://.

O Softaculous instalará o código em /home/usuario/aula.oseudominio.com e o site será servido a partir de public.

Se o subdomínio já existir, estiver vazio e a sua raiz for /home/usuario/aula.oseudominio.com, altere a sua raiz para aula.oseudominio.com/public. O mesmo vale para um domínio adicional com pasta própria.

Instalar o Moodle

1. No cPanel, abra Softaculous Apps Installer.
2. Procure Moodle, abra a sua ficha e clique em Install.
3. O primeiro menu pendente é o protocolo: escolha https://, sem www.. O segundo é o domínio: escolha o subdomínio que preparou.
4. Deixe vazio o campo Directory.
5. Em Data Directory, o Softaculous propõe /home/usuario/moodledata. Se já tiver outro Moodle na conta, use uma pasta diferente para cada instalação, por exemplo /home/usuario/moodledata-aula: duas instalações não a podem partilhar.
6. Escreva o nome do site, o utilizador administrador, uma palavra-passe única e o email de administração.
7. Clique em Install.

No fim, o Softaculous mostra o endereço da plataforma e o de administração. Guarde esses dados num gestor de palavras-passe.

Erro «Moodle files are already present»

Se o Softaculous responder:

It seems that the Moodle files are already present at /home/usuario location. Hence you can not install Moodle on this domain. Please try to install lower version of Moodle on this domain.

a raiz do domínio está diretamente na sua pasta pessoal, por exemplo /home/usuario/aula.oseudominio.com. O Softaculous quer instalar o código na pasta acima, que nesse caso é /home/usuario, e, como já tem ficheiros, recusa-se. Alterar o diretório de dados não o resolve: o que é preciso alterar é a raiz do domínio, como se explica em preparar o subdomínio.

A mensagem sugere instalar uma versão anterior, mas, se o seu servidor admitir o Moodle 5, não é necessário: a plataforma começaria com uma versão mais antiga e teria de a atualizar depois.

Moodle no domínio principal

O domínio principal é servido a partir de public_html, cuja pasta acima é também a sua pasta pessoal, e o cPanel não deixa alterar a sua raiz. Para o Moodle 5, use um subdomínio como aula.oseudominio.com ou um domínio adicional com a sua própria pasta terminada em /public. Se precisar que a plataforma fique no domínio principal, escreva-nos antes de instalar e vemos isso consigo.

Se o seu servidor tiver MySQL 8.0

O Moodle 5 precisa de MySQL 8.4 ou MariaDB, pelo que não pode ser instalado num servidor com MySQL 8.0. Escreva-nos antes de instalar e vemos consigo a opção que melhor se adequa: transferir a sua conta para um servidor com MariaDB 11.4 ou instalar o Moodle 4.5. O Moodle 4.5 é a versão LTS anterior e funciona com MySQL 8.0, mas só recebe atualizações de segurança até 4 de outubro de 2027.

Depois de instalar

• Entre no endereço da plataforma e no de administração e verifique que o certificado é válido.
• Agende o cron do Moodle a cada minuto com uma tarefa cron. No Moodle 5 o script não está em public: o caminho é /home/usuario/aula.oseudominio.com/admin/cli/cron.php. Use o binário da versão de PHP do seu Moodle, por exemplo /opt/alt/php83/usr/bin/php.
• Configure o envio de correio por SMTP para que os avisos e as recuperações de palavra-passe cheguem.
• Agende cópias de segurança dos ficheiros, do diretório de dados e da base de dados. A cópia de um curso feita no Moodle não substitui uma cópia de toda a instalação.