Como Instalar o PyroCMS no Servidor Ubuntu 24.04

PyroCMS é um CMS de código aberto baseado nos frameworks web PHP e Laravel. É um sistema de gerenciamento de conteúdo poderoso com MySQL/MariaDB como banco de dados e também fornece uma administração web intuitiva e simples para facilitar o gerenciamento.

Neste tutorial, vamos guiá-lo pela instalação do PyroCMS no Ubuntu 24.04 com a Pilha LEMP (Linux, Nginx, MySQL/MariaDB e PHP-FPM) e Composer.

Pré-requisitos

Antes de começar, certifique-se de que você possui o seguinte:

Um servidor Ubuntu 24.04.
Um usuário não-root com privilégios de administrador.
Um nome de domínio apontado para o endereço IP do servidor.

Instalando dependências

PyroCMS é um sistema de gerenciamento de conteúdo baseado em Laravel com MySQL/MariaDB como banco de dados. Antes de instalar o PyroCMS, você instalará a Pilha LEMP (Linux, Nginx, MySQL/MariaDB e PHP-FPM) e o Composer em seu sistema Ubuntu.

Primeiro, execute o seguinte comando apt para atualizar seu índice de pacotes e instalar a Pilha LEMP (Linux, Nginx, MySQL/MariaDB e PHP-FPM) e o Composer.

sudo apt update sudo apt install nginx mariadb-server composer php-cli php-fpm php-mysql php-curl php-sqlite3 php-mbstring php-gd php-xml

Digite Y para confirmar a instalação.

instalar deps

Após a instalação, verifique os serviços da Pilha LEMP para garantir que esses serviços estão em execução.

Verifique o servidor web Nginx com o comando systemctl abaixo.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Agora verifique o status do servidor MariaDB com o seguinte:

verificar nginx

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

verificar mariadb

Em seguida, execute o seguinte comando para verificar o serviço PHP-FPM.

sudo systemctl is-enabled php8.3-fpm  
sudo systemctl status php8.3-fpm

verificar php-fpm

Por último, verifique a versão do Composer usando o comando abaixo. Você verá que o Composer 2.4.7 está instalado.

sudo -u www-data composer --version

Configurando PHP-FPM

Depois de instalar as dependências, você configurará o PHP-FPM alterando algumas configurações padrão através do arquivo php.ini e reiniciando o serviço PHP-FPM.

Abra o arquivo php.ini para PHP-FPM com o editor nano.

sudo nano /etc/php/8.3/fpm/php.ini

Altere a configuração padrão com o seguinte e ajuste as opções date.timezone e memory_limit de acordo com seu ambiente atual.

date.timezone = Europe/Amsterdam  
max_execution_time = 130  
memory_limit = 256M  
allow_url_fopen = On  
allow_url_include = Off  
post_max_size = 128M  
upload_max_filesize = 128M  
max_input_vars = 5000

Quando terminar, salve o arquivo e saia do editor.

Agora execute o comando systemctl abaixo para reiniciar o serviço PHP-FPM e aplicar suas alterações no php.ini.

sudo systemctl restart php8.3-fpm

Configurando o servidor MariaDB

Agora que você configurou o PHP-FPM, você irá proteger a instalação do servidor MariaDB e criar um novo banco de dados e usuário para o PyroCMS.

Proteja a instalação do seu servidor MariaDB com o comando mariadb-secure-installation abaixo.

sudo mariadb-secure-installation

Você será questionado sobre as seguintes configurações:

Mudar para autenticação unix_socket? Digite n e pressione ENTER.
O usuário root padrão do MariaDB já está protegido. Opcionalmente, você também pode habilitá-lo digitando y para sim.
Mudar a senha do root. Digite y para confirmar e configure sua nova senha de root do MariaDB.
Remover usuários anônimos? Digite y para confirmar.
Proibir login remoto do root? Digite y para confirmar. Apenas a conexão local será permitida se você estiver usando o MariaDB.
Remover o banco de dados de teste e acessá-lo. Digite y para confirmar e remover o banco de dados padrão ‘test’.
Por último, digite y novamente para recarregar todos os privilégios de tabela em seu servidor MariaDB e aplicar novas alterações.

Depois de configurar o MariaDB, você criará um novo banco de dados e usuário para o PyroCMS.

Faça login no servidor MariaDB com o comando mariadb abaixo. Digite sua senha de root quando solicitado.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados pyrocmsdb, um novo usuário pyrocms@localhost, e a senha é passw0rd. Altere os detalhes do nome do banco de dados, nome de usuário e senha conforme necessário.

CREATE DATABASE pyrocmsdb;  
GRANT ALL PRIVILEGES ON pyrocmsdb.* TO pyrocms@localhost IDENTIFIED BY 'passw0rd';  
FLUSH PRIVILEGES;

criar banco de dados e usuário

Em seguida, execute a consulta abaixo para verificar os privilégios do usuário pyrocms@localhost. Você verá que o banco de dados pyrocmsdb é acessível com o usuário pyrocms@localhost.

SHOW GRANTS FOR pyrocms@localhost;

Por último, digite quit para sair do servidor MariaDB.

mostrar privilégios db

Baixando o código-fonte do PyroCMS

Crie novos diretórios para o Composer e PyroCMS, vá para o /var/www/pyrocms, e então mude a propriedade dos novos diretórios para o usuário www-data. Neste caso, o /var/www/pyrocms será usado como o diretório raiz do documento para o PyroCMS.

mkdir -p /var/www/{.config,.cache,pyrocms}; cd /var/www/pyrocms  
sudo chown -R www-data:www-data /var/www/{.config,.cache,pyrocms}

Agora execute o comando composer abaixo para baixar o código-fonte do PyroCMS e instalar e atualizar as dependências do PHP.

sudo -u www-data composer create-project pyrocms/pyrocms .  
sudo -u www-data composer update

Abaixo você pode ver a instalação do PyroCMS através do comando composer:

baixar e instalar dependências do pyrocms

Após a instalação ser concluída, passe para a próxima seção.

Configurando o bloco do servidor Nginx

Nesta seção, você criará uma nova configuração de bloco de servidor Nginx para a instalação do PyroCMS. Portanto, certifique-se de que você tem um nome de domínio apontado para o endereço IP do seu servidor Ubuntu. Neste exemplo, você usará um nome de domínio howtoforge.local.

Crie um novo bloco de servidor Nginx /etc/nginx/sites-available/pyrocms.conf com o editor nano.

sudo nano /etc/nginx/sites-available/pyrocms.conf

Copie e cole a seguinte configuração e certifique-se de alterar o server_name para o seu nome de domínio.

server {  
 listen 80;  
 server_name howtoforge.local;  
  
 index index.php index.html;  
 root /var/www/pyro/public;  
   
 location / {  
  try_files $uri $uri/ /index.php?$args;  
 }  
  
 location ~ \.php$ {  
  include fastcgi_params;  
  fastcgi_pass unix:/run/php/php-8.3-fpm.sock;  
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
  fastcgi_index index.php;  
 }  
}

Quando terminar, salve e saia do arquivo.

Agora execute o comando abaixo para criar um symlink do arquivo pyrocms.conf para o diretório /etc/nginx/sites-enabled e verifique sua sintaxe Nginx.

sudo ln -s /etc/nginx/sites-available/pyrocms.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Se você tiver uma sintaxe Nginx adequada, verá uma saída test is successful - syntax is ok.

configurar nginx

Por último, execute o seguinte comando systemctl para reiniciar o servidor web Nginx e aplicar suas alterações.

sudo systemctl restart nginx

Protegendo o PyroCMS com HTTPS através do Letsencrypt

Para proteger o PyroCMS, você implementará HTTPS através do Letsencrypt. Para isso, você deve instalar o Certbot para gerar certificados SSL/TLS e implementar automaticamente o HTTPS em sua instalação do PyroCMS.

Instale os pacotes certbot e python3-certbot-nginx com o seguinte comando. Digite Y para confirmar a instalação.

sudo apt install certbot python3-certbot-nginx

Agora execute o comando certbot abaixo para gerar certificados SSL e proteger o PyroCMS com HTTPS.

sudo certbot --nginx --agree-tos --no-eff-email --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Após o processo ser concluído, você encontrará seus certificados no diretório /etc/letsencrypt/live/domain.com, e seu PyroCMS agora está protegido com HTTPS.

Instalando o PyroCMS usando o instalador web

Abra seu navegador e visite seu nome de domínio, como https://howtoforge.local/. Agora você verá uma única página de instalação do PyroCMS:

Selecione Eu Concordo para aceitar a licença para a instalação do PyroCMS.
Digite seu nome de banco de dados, usuário e senha.
Digite um novo usuário administrador, endereço de e-mail e senha para seu PyroCMS.
Digite os detalhes do site para sua instalação, como nome de domínio, idioma e fuso horário.
Clique em Instalar para confirmar a instalação.

instalar pyrocms

Após a instalação ser concluída, você verá a seguinte página:

instalação completa

Clique em Ver Site para acessar a página inicial do PyroCMS. Abaixo você pode ver a página de índice padrão do PyroCMS.

página inicial

Clique em Login para acessar a tela de login do PyroCMS. Digite seu usuário administrador e senha, e então clique em Login.

Se bem-sucedido, você verá o painel de administração do PyroCMS como o seguinte:

painel

Conclusão

Parabéns! Você completou a instalação do PyroCMS no servidor Ubuntu 24.04. Você tem o PyroCMS instalado com a Pilha LEMP (Linux, Nginx, MySQL/MariaDB e PHP-FPM). Você também baixou o PyroCMS com o Composer e protegeu o PyroCMS com HTTPS através do Certbot e Letsencrypt.