Pesquisa de site

Como instalar o Fórum Flarum no Debian 11

Nesta página

  1. Pré-requisitos
  2. Instalando o Apache2
  3. Instalando o servidor MariaDB
  4. Instalando pacotes PHP
  5. Instalando o Composer
  6. Criar novo banco de dados e usuário para Flarum
  7. Configuração do diretório do projeto Flarum
  8. Configurar host virtual do Apache
  9. Iniciar a instalação do Flarum
  10. Conclusão

Flarum é um software de fórum gratuito e de código aberto escrito em PHP, JavaScript e TypeScript. Originalmente, Flarum é uma fusão de dois projetos diferentes, o FluxBB e o esoTalk. O Flarum é um software de fórum de última geração projetado para ser mínimo com alta extensibilidade por meio de extensões.

Flarum é uma solução moderna para o software Forum, é rápido, simples e fácil de usar e instalar.

Este tutorial ensinará como instalar o Flarum no Debian 11 Bullseye. Este tutorial também aborda algumas configurações básicas do LAMP Stack e a instalação do PHP Composer para o aplicativo web Flarum.

Pré-requisitos

  • Um servidor Linux Debian 11 Bullseye.
  • Um usuário raiz ou não raiz com privilégios de raiz.
  • Um nome de domínio apontado para o servidor.

Instalando o Apache2

O primeiro passo será instalar o servidor web Apache2 em seu sistema Debian.

Verifique para atualizar seu índice de pacote de repositório usando o seguinte comando.

sudo apt update

Instale o pacote Apache2 usando o comando abaixo.

sudo apt install apache2 -y

Você obterá a saída:

Depois de instalar os pacotes Apache2, você pode iniciar o servidor apache2 e ativá-lo.

sudo systemcttl start apache2
sudo systemctl enable apache2

O serviço apache2 agora está em execução.

Agora execute o seguinte comando para abrir as portas HTTP e HTTPS no firewall. Neste exemplo, o servidor Debian está sendo executado com o firewall UFW.

sudo ufw allow "WWW Full"
sudo ufw reload

Verifique e verifique as regras de firewall do UFW.

sudo ufw status

Você obterá a seguinte saída.

Instalando o servidor MariaDB

Na próxima etapa, você instalará e configurará o banco de dados MariaDB no servidor Debian.

Instale os pacotes MariaDB usando o comando apt abaixo.

sudo apt install mariadb-server -y

Você obterá a seguinte saída:

Após a conclusão da instalação do MariaDB, inicie e habilite o serviço MariaDB usando o comando abaixo.

sudo systemctl start mariadb
sudo systemctl enable mariadb

Você obterá a saída abaixo:

O serviço MariaDB está em execução, agora você configurará a senha root do MariaDB.

Execute o comando mysql_secure_installation abaixo para iniciar a configuração da instalação do servidor MariaDB.

sudo mysql_secure_installation

Pressione ENTER para continuar configurando o servidor MariaDB.

Quando solicitado a alterar o método de autenticação para unix_socket, digite Y para confirmar.

Agora insira Y para confirmar e configurar a senha root para MariaDB. Em seguida, insira a nova senha para o usuário root do MariaDB e repita a senha.

Insira Y para remover o usuário anônimo padrão do servidor MariaDB.

Insira Y novamente para desabilitar o login remoto para o usuário root do MariaDB.

Insira Y para remover o teste de banco de dados padrão de sua instalação do MariaDB.

Por fim, insira Y novamente para recarregar todos os privilégios de tabelas no servidor MariaDB para aplicar novas configurações.

Instalando Pacotes PHP

Flarum é uma aplicação web escrita em PHP. Então agora você estará instalando os pacotes PHP em seu servidor Debian.

Instale pacotes PHP com extensões adicionais para Flarum usando o seguinte comando.

sudo apt install php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap php-tokenizer -y

Você obterá a saída:

Após a conclusão da instalação do PHP, edite o arquivo de configuração php.ini usando o editor nano.

sudo nano /etc/php/7.4/apache2/php.ini

Altere a configuração padrão do php.ini de acordo com as configurações a seguir.

memory_limit = 512M
upload_max_file_size = 150M
max_execution_time = 600
date.timezone = Europe/Paris

Salve o arquivo pressionando CTRL+X e confirme o salvamento digitando Y.

Agora, para aplicar as novas alterações no arquivo de configuração php.ini, reinicie o serviço Apache2 usando o comando abaixo.

sudo systemctl restart apache2

Instalando o Composer

Para instalar o Flarum, você precisará do Composer instalado em seu servidor Debian. O Composer é um gerenciador de dependências para PHP que permite gerenciar bibliotecas em seu aplicativo PHP.

Atualmente, o Composer é usado em frameworks PHP quase modernos, como Symfony e Laravel.

Baixe e verifique o instalador do Composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Se você vir a mensagem de saída \Instalador verificado\, o instalador do Composer é válido.

Agora execute o script do instalador para instalar o Composer. Quando a instalação estiver concluída, remova o script do instalador.

php composer-setup.php
php -r "unlink('composer-setup.php');"

O arquivo binário do Composer agora está disponível em seu diretório de trabalho com o nome composer.phar. Mova o arquivo para /usr/local/bin/composer para que todos os usuários no servidor possam executar o comando composer.

sudo mv composer.phar /usr/local/bin/composer

Em seguida, verifique a versão do Composer que você acabou de instalar em seu sistema usando o seguinte comando.

sudo -u www-data composer --version
sudo -u www-data composer -v

Você obterá a seguinte saída.

Criar novo banco de dados e usuário para Flarum

Antes de começar a pular e instalar o Flarum, agora você precisará criar um novo banco de dados MariaDB e um usuário para o Flarum.

Faça login no shell MariaDB como usuário root usando o comando abaixo.

sudo mysql -u root -p

Agora crie um novo banco de dados flarumdb e o usuário flarum com a senha flarumdbpassword para a instalação do Flarum.

CREATE DATABASE flarumdb;
CREATE USER ;
FLUSH PRIVILEGES;

Depois disso, digite exit para sair do shell do MariaDB ou pressione CTRL+D.

Diretório de Projetos de Configuração Flarum

Nesta etapa, você estará baixando e instalando o fonte Flarum usando o PHP Composer.

Primeiro, crie um novo diretório de projeto /var/www/flarum e /var/www/.cache usando o comando abaixo.

mkdir -p /var/www/{.cache,flarum}

O diretório principal do projeto Flarum será /var/www/flarum. E o diretório /var/www/.cache será usado para armazenar caches para o PHP Composer.

Em seguida, altere a propriedade dos diretórios flarum e .cache para o usuário www-data. Além disso, você precisará conceder permissão de leitura e gravação ao usuário www-data.

sudo chown -R www-data:www-data /var/www/{.cache,flarum}
sudo chmod u+rw /var/www/{.cache,flarum}

Agora mude seu diretório de trabalho para /var/www/flarum e instale o Flarum usando o comando Composer abaixo.

cd /var/www/flarum
sudo -u www-data composer create-project flarum/flarum .

Você obterá a seguinte saída:

O Composer instalará o Flarum e todas as dependências PHP adicionais necessárias para o Flarum.

Depois que todo o Flarum estiver instalado, você verá o código-fonte do Flarum disponível no diretório /var/www/flarum. E o diretório DocumentRoot para Flarum está disponível no diretório /var/www/flarum/public.

Configurar host virtual do Apache

Antes de iniciar o acesso à instalação do Flarum, você precisará criar uma nova configuração de host virtual Apache2 para o Flarum.

Vamos começar habilitando alguns módulos do Apache usando o seguinte comando.

sudo a2enmod ssl rewrite headers

Você obterá a seguinte saída.

Em seguida, crie um novo arquivo de configuração de host virtual /etc/apache2/sites-available/flarum.conf usando o editor nano.

sudo nano /etc/apache2/sites-available/flarum.conf

Cole a seguinte configuração de host virtual. Você precisará alterar algumas opções abaixo, como o nome do domínio e o caminho dos certificados SSL.

<VirtualHost *:80>
    ServerName example.io
    Redirect permanent / https://example.io/
</VirtualHost>

<VirtualHost *:443>
    ServerAdmin 
    DocumentRoot /var/www/flarum/public
    ServerName example.io

    Protocols h2 http/1.1

    SSLEngine On
    SSLCertificateFile /etc/letsencrypt/live/example.io/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.io/privkey.pem

     <Directory /var/www/flarum/public/>
          Options FollowSymlinks
          AllowOverride All
          Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined
    
     <Directory /var/www/flarum/public/>
            RewriteEngine on
            RewriteBase /
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteRule ^(.*) index.php [PT,L]
    </Directory>
</VirtualHost>

Salve o arquivo pressionando o botão CTRL+X e digitando Y para confirmar.

Agora, vamos ativar a configuração do host virtual flarum.conf usando o comando abaixo. Em seguida, verifique todas as configurações do Apache2.

sudo a2ensite flarum.conf
sudo apachectl configtest

Se você vir a mensagem de saída Syntax OK, todas as suas configurações do Apache2 são válidas.

Por fim, reinicie o serviço Apache2 usando o comando abaixo para aplicar as novas alterações em seu servidor web Apache2.

sudo systemctl restart apache2

Iniciar a instalação do Flarum

Para iniciar a instalação e configuração do Flarum, você precisa acessar seu Flarum através da URL https://seudominio.com/, e deverá obter a seguinte página.

Insira os detalhes da instalação do Flarum, como título do site e detalhes do banco de dados. Em seguida, insira o usuário administrador e a senha para Flarum.

Clique em Instalar Flarum para iniciar e confirmar a instalação do Flarum.

Quando a instalação estiver concluída, você receberá a mensagem de boas-vindas do Flarum conforme abaixo.

Se você acessar as configurações de administração do Flarum, verá as informações abaixo.

O Flarum v1.2.1 está instalado no servidor Debian 11 com PHP 7.4 e MariaDB 10.5.

Conclusão

Parabéns! Agora você instalou com sucesso o aplicativo web Flarum no Debian 11 Bullseye mais recente com o LAMP Stack. Agora você pode começar a adicionar algumas extensões para estender seu aplicativo web Flarum.

Artigos relacionados: