Como Instalar Prestashop com Apache e SSL Let's Encrypt Gratuito no Debian 12

Prestashop é uma solução de e-commerce gratuita e de código aberto escrita em PHP. Ela permite que você hospede e crie lojas online por conta própria e faça crescer seu negócio online. Prestashop é uma solução de e-commerce totalmente personalizável e rica em recursos que permite criar sites de e-commerce abrangentes. Prestashop é agora usado por mais de 250.000 lojas online em todo o mundo e está disponível em 65 idiomas.

Neste tutorial, eu vou guiá-lo passo a passo pela instalação do PrestaShop em um servidor Debian 12. Você instalará o PrestaShop com a pilha LAMP (Apache2, MariaDB e PHP) e, em seguida, protegerá sua instalação do PrestaShop com certificados SL/TLS via Letsencrypt.

Pré-requisitos

Antes de começar, tenha o seguinte pronto:

Um servidor Debian 12.
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

PrestaShop é uma plataforma de código aberto para criar uma loja online escrita em PHP com MariaDB/MySQL como banco de dados. No passo seguinte, você instalará as dependências para o PrestaShop, que incluem pacotes da pilha LAMP (Apache2, MariaDB e PHP) com algumas extensões PHP adicionais. Você instalará especificamente o PHP 8.1 via um repositório de terceiros porque o PrestaShop atual ainda não suporta o PHP 8.2.

Primeiro, execute o seguinte comando para adicionar um repositório PHP de terceiros e a chave GPG ao seu sistema Debian.

sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg  
sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'

Atualize e atualize o índice de pacotes do Debian executando o seguinte comando apt.

sudo apt update

Uma vez que o repositório esteja atualizado, instale as dependências para o PrestaShop usando o seguinte comando. Isso instalará pacotes da Pilha LAMP (Apache2, MariaDB, PHP 8.1), Certbot, plugin Certbot Apache e extensões PHP adicionais que são necessárias pelo PrestaShop.

sudo apt install apache2 mariadb-server certbot python3-certbot-apache php8.1 php8.1-curl php8.1-xmlrpc php8.1-soap php8.1-intl php8.1-zip php8.1-cli php8.1-mysql php8.1-common php8.1-opcache php8.1-memcached php8.1-bcmath php8.1-gd php8.1-mbstring php8.1-xml php8.1-gmp php8.1-imagick unzip

Digite y para prosseguir com a instalação.

instalar deps

Após as dependências serem instaladas, verifique cada dependência usando o seguinte comando.

Verifique o serviço apache2 para garantir que o serviço está em execução executando o comando systemctl abaixo.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

O seguinte resultado será exibido, confirmando que o serviço apache2 está em execução e habilitado.

verificar apache2

Agora verifique o serviço mariadb usando o seguinte comando.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

A saída exibida abaixo confirma que o serviço mariadb está em execução e habilitado.

verificar mariadb

Por último, execute o seguinte comando para verificar sua versão do PHP e listar as extensões habilitadas.

php -v  
php -m

Você deve ver que PHP 8.1 está instalado em sua máquina Debian com a lista de extensões habilitadas.

verificar php

Configurando o Servidor MariaDB

Agora que você instalou as dependências para o PrestaShop, o próximo passo é proteger sua instalação do Servidor MariaDB via a utilidade mariadb-secure-installation. Em seguida, você precisará criar um novo banco de dados e usuário para o PrestaShop.

Execute o comando mariadb-secure-installation abaixo para proteger sua instalação do Servidor MariaDB.

sudo mariadb-secure-installation

Digite Y para confirmar e aplicar a nova configuração, ou n para Não, e rejeitá-la. Abaixo estão as configurações do Servidor MariaDB que você será solicitado:

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 configurar sua nova senha de root do MariaDB.
Remover usuário anônimo?. Digite y para confirmar.
Proibir login root remotamente? Digite y para confirmar. Apenas conexões locais serão permitidas se você estiver usando o usuário root do MariaDB.
Remover banco de dados de teste e acesso a ele?. Digite y para confirmar e remover o banco de dados padrão ‘test’.
Por último, digite y novamente para recarregar todos os privilégios das tabelas em seu servidor MariaDB e aplicar novas alterações.

Em seguida, execute o comando do cliente mariadb abaixo para fazer login no Servidor MariaDB. Digite sua senha de root do MariaDB quando solicitado.

sudo mariadb -u root -p

Uma vez logado, execute as seguintes consultas para criar um novo banco de dados prestashopdb, um usuário prestashop, com a senha password. O novo banco de dados e usuário do MariaDB aqui serão o usuário para a instalação do PrestaShop.

CREATE DATABASE prestashopdb;  
GRANT ALL PRIVILEGES ON prestashopdb.* TO 'prestashop'@'localhost' IDENTIFIED BY 'password';  
FLUSH PRIVILEGES;

Em seguida, execute a seguinte consulta para verificar o usuário MariaDB prestashop.

SHOW GRANTS FOR 'prestashop'@'localhost';

A saída exibida abaixo revela que o usuário MariaDB prestashop tem permissão para acessar o banco de dados prestashopdb.

verificar privilégios do usuário

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

Configurando o PHP

Após configurar o Servidor MariaDB, você configurará sua instalação do PHP modificando o arquivo php.ini. Em seguida, você também verificará seu ambiente para garantir que tudo relacionado à configuração do PHP atenda aos requisitos do PrestaShop.

Abra a configuração padrão do PHP /etc/php/8.1/apache2/php.ini usando o seguinte comando do editor nano.

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

Altere a configuração abaixo e certifique-se de ajustar os parâmetros date.timezone e memory_limit com seu ambiente de servidor.

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

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o seguinte comando systemctl para reiniciar o serviço apache2 e aplicar as alterações.

sudo systemctl restart apache2

Agora que você configurou o PHP, você verificará se seu ambiente de servidor está pronto para a instalação do PrestaShop. Isso pode ser feito usando o verificador de ambiente fornecido pelo PrestaShop.

Mova para o diretório /var/www/html e baixe o script de verificação de ambiente via o comando wget abaixo. Você verá o arquivo v1.1.tar.gz em seu diretório de trabalho atual.

cd /var/www/html  
wget https://github.com/PrestaShop/php-ps-info/archive/refs/tags/v1.1.tar.gz

Extraia o arquivo v1.1.tar.gz e renomeie o diretório extraído para check-ps.

tar -xf v1.1.tar.gz  
mv php-ps-info-1.1 check-ps

Por último, abra seu navegador da web e visite o endereço IP do servidor seguido do caminho check-ps para acessar o script de verificação de ambiente do PrestaShop, como http://192.168.10.15/check-ps/phppsinfo.php.

Digite o nome de usuário padrão prestashop e a senha prestashop, em seguida, clique em Entrar.

Certifique-se de que suas dependências, configurações PHP e extensões PHP atendem aos requisitos do PrestaShop. Se não, você pode ajustar suas configurações com base nas recomendações na página.

verificador ps

Baixando Prestashop

Agora que o Servidor MariaDB e o PHP estão configurados, o próximo passo é baixar o código-fonte do PrestaShop e configurar o diretório de instalação com as permissões e propriedade adequadas.

Mova seu diretório de trabalho para /var/www/ e baixe o código-fonte do PrestaShop via o comando wget abaixo. Certifique-se de verificar a página de lançamentos do PrestaShop para obter a versão mais recente do PrestaShop.

cd /var/www/  
wget https://github.com/PrestaShop/PrestaShop/releases/download/8.1.2/prestashop_8.1.2.zip

Agora extraia o código-fonte do PrestaShop via o comando unzip abaixo. Você deve ver o código-fonte do PrestaShop dentro do arquivo zip prestashop.zip.

unzip prestashop_8.1.2.zip

Extraia o arquivo prestashop.zip usando o comando unzip abaixo para o diretório de destino /var/www/prestashop. O código-fonte do PrestaShop será extraído para o diretório prestashop, então seu diretório de instalação do Prestashop deve ser /var/www/prestashop.

unzip prestashop.zip -d /var/www/prestashop

Por último, execute o seguinte comando para configurar a propriedade e permissão adequadas para o diretório de instalação do PrestaShop /var/www/prestashop. A propriedade deve usar www-data com a permissão u+rw, o que significa que o proprietário pode ler e escrever no diretório de destino.

sudo chown -R www-data:www-data /var/www/prestashop  
sudo chmod u+rw /var/www/prestashop

Configurando o Host Virtual do Apache2

No passo seguinte, você criará uma nova configuração de host virtual do Apache2 que será usada para executar o PrestaShop. Então, antes disso, certifique-se de que seu nome de domínio esteja apontado para um endereço IP do servidor.

Para começar, execute o seguinte comando para habilitar o módulo rewrite para o Apache.

sudo a2enmod rewrite

habilitar rewrite

Em seguida, crie uma nova configuração de host virtual /etc/apache2/sites-available/prestashop.conf usando o comando do editor nano.

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

Insira a seguinte configuração e certifique-se de alterar o nome de domínio dentro do parâmetro ServerName.

  
    
    ServerAdmin [email protected]  
    DocumentRoot /var/www/prestashop  
    ServerName howtoforge.local  
    
      
        # habilitar as reescritas .htaccess  
        AllowOverride All  
        Options +Indexes  
        Require all granted  
       
        # Desativar token do back office  
        # SetEnv _TOKEN_ disabled  
      
    
    ErrorLog /var/log/apache2/prestashop.error.log  
    CustomLog /var/log/apache2/prestashop.access.log combined

Salve e feche o arquivo quando terminar.

Em seguida, execute o seguinte comando para ativar o arquivo de host virtual prestashop.conf e verificar sua configuração do Apache.

sudo a2ensite prestashop.conf  
sudo apachectl configtest

Se você tiver uma configuração adequada do Apache, a saída Syntax OK será exibida.

configurar vhost

Agora execute o comando systemctl abaixo para reiniciar o serviço apache2 e aplicar as alterações.

sudo systemctl restart apache2

Por último, gere os certificados SSL/TLS para seu nome de domínio do PrestaShop executando o seguinte comando certbot. Certifique-se de alterar o endereço de e-mail e o nome de domínio com suas informações.

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

Uma vez que o processo esteja concluído, seu arquivo de host virtual prestashop.conf será automaticamente configurado com HTTPS e seus certificados SSL/TLS estarão disponíveis no diretório /etc/letsencrypt/live/howtoforge.local.

Instalando PrestaShop via Linha de Comando

Neste ponto, você pode agora finalizar sua instalação do PrestaShop via interface web ou linha de comando. Neste exemplo, você finalizará sua instalação do PrestaShop via linha de comando.

Vá para o diretório de instalação do PrestaShop /var/www/prestashop/install.

cd /var/www/prestashop/install

Execute o script index_cli.php como o seguinte para iniciar a instalação do PrestaShop via linha de comando. Certifique-se de alterar os detalhes do nome de domínio, host do banco de dados MariaDB, nome, nome de usuário e senha. Além disso, certifique-se de alterar o endereço de e-mail e a senha que serão usados como administrador para o PrestaShop.

sudo -u www-data php index_cli.php --domain=howtoforge.local --db_server=127.0.0.1 --db_name=prestashopdb --db_user=prestashop --db_password=password --prefix=myps_ [email protected] --password=Passw0rd

Uma vez que a instalação esteja concluída, a saída “ Instalação bem-sucedida “ será exibida como a seguinte.

instalar prestashop via linha de comando

Em seguida, execute o seguinte comando para configurar a permissão adequada para alguns diretórios do PrestaShop. Isso permitirá que o www-data como proprietário leia e escreva nesses diretórios de destino.

sudo chmod u+rw /var/www/prestashop/var/cache  
sudo chmod u+rw /var/www/prestashop/var/logs  
sudo chmod u+rw /var/www/prestashop/img  
sudo chmod u+rw /var/www/prestashop/mails  
sudo chmod u+rw /var/www/prestashop/modules  
sudo chmod u+rw /var/www/prestashop/translations  
sudo chmod u+rw /var/www/prestashop/upload  
sudo chmod u+rw /var/www/prestashop/download  
sudo chmod u+rw /var/www/prestashop/app/config  
sudo chmod u+rw /var/www/prestashop/app/Resources/translations

Agora execute o comando abaixo para remover o diretório /var/www/prestashop/install e proteger sua instalação do PrestaShop.

sudo rm -rf /var/www/prestashop/install

Em seguida, abra seu navegador da web e visite seu nome de domínio do PrestaShop, como http://howtoforge.local/. Uma vez que a instalação seja bem-sucedida, você deve ser redirecionado para uma conexão HTTPS segura, e você deve ver a página inicial padrão da sua instalação do PrestaShop.

homepage prestashop

Em seguida, visite o nome de domínio do PrestaShop seguido do caminho admin, como https://howtoforge.local/admin/. Se tudo correr bem, você deve ser redirecionado para a página de login do PrestaShop. Além disso, você pode ver que o caminho URL padrão para o PrestaShop mudou para admin051rgjztgtkvgcie6dp.

Digite seu usuário e senha de administrador e clique em Login.

Se você tiver um usuário e senha de administrador corretos, você deve ser apresentado ao painel de administração do PrestaShop.

painel prestashop

Outra consideração, você pode executar o seguinte comando para verificar o login do administrador do PrestaShop.

ls /var/www/prestashop

A saída abaixo mostra que a página de administração do PrestaShop está disponível em admin051rgjztgtkvgcie6dp.

verificar admin ps

Conclusão

Para concluir, você agora instalou com sucesso o PrestaShop no Debian 12 passo a passo. Você instalou o PrestaShop 8 com a Pilha LAMP (Apache2, MariaDB e PHP) e protegeu a instalação do PrestaShop com certificados SSL/TLS. Além disso, você também aprendeu como iniciar a instalação do PrestaShop via linha de comando. Agora você pode adicionar novos temas e extensões adicionais para expandir sua instalação do PrestaShop.