Como instalar o ProcessWire CMS 3.0 no Debian 9 LAMP VPS

O ProcessWire CMS 3.0 é um sistema de gerenciamento de conteúdo (CMS) simples, flexível e poderoso, gratuito e de código aberto. O ProcessWire CMS 3.0 apresenta uma API de estilo jQuery fácil de usar, arquitetura de plug-in totalmente modular e um sistema de templates flexível e poderoso que oferece uma experiência de usuário igualmente satisfatória para designers, desenvolvedores e usuários finais.

Neste tutorial vamos instalar o ProcessWire CMS 3.0 em um VPS de 9 LAMPs Debian usando o servidor web Apache, PHP 7.1 e um banco de dados MariaDB.

Pré-requisitos

• Uma instância limpa do servidor Site & Site Debian 9 com acesso SSH

Etapa 1: adicionar um usuário do Sudo

Vamos começar adicionando um novo sudousuário.

Primeiro, entre no seu servidor como root:

ssh [email protected]_VULTR_IP_ADDRESS

O sudocomando não é instalado por padrão na instância do servidor Site & Site Debain 9, então vamos instalar primeiro sudo:

apt-get -y install sudo

Agora adicione um novo usuário chamado user1(ou seu nome de usuário preferido):

adduser user1

Quando solicitado, insira uma senha segura e memorável. Você também será solicitado para o seu “Nome Completo” e alguns outros detalhes, mas você pode simplesmente deixá-los em branco pressionando Enter.

Agora, verifique o /etc/sudoersarquivo para certificar-se de que o sudoersgrupo esteja ativado:

visudo

Procure por uma seção como esta:

%sudo        ALL=(ALL:ALL)       ALL

Esta linha nos diz que os usuários que são membros do sudogrupo podem usar o sudocomando para obter rootprivilégios. Deve ser descomentado por padrão, então você pode simplesmente sair do arquivo.

Em seguida, precisamos adicionar user1ao sudogrupo:

usermod -aG sudo user1

Podemos verificar a user1associação ao grupo e verificar se o usermodcomando funcionou com o groupscomando:

groups user1

Agora use o sucomando para mudar para a nova user1conta de usuário do sudo :

su - user1

O prompt de comando será atualizado para indicar que você está logado na user1conta. Você pode verificar isso com o whoamicomando:

whoami

Agora, reinicie o sshdserviço para que você possa efetuar login sshcom a nova conta de usuário sudo não-raiz que você acabou de criar:

sudo systemctl restart sshd

Saia da user1conta:

exit

Saia da rootconta (que desconectará sua sshsessão):

exit

Agora você pode sshentrar na instância do servidor do seu host local usando a nova user1conta de usuário sudo não raiz :

ssh [email protected]_VULTR_IP_ADDRESS

Se você deseja executar sudosem ter que digitar uma senha toda vez, abra o /etc/sudoersarquivo novamente, usando visudo:

sudo visudo

Edite a seção do sudogrupo para que fique assim:

%sudo   ALL=(ALL) NOPASSWD: ALL

Por favor note: Desabilitar o requisito de senha para o usuário sudo não é uma prática recomendada, mas está incluída aqui, pois pode tornar a configuração do servidor muito mais conveniente e menos frustrante, especialmente durante sessões de administração de sistemas mais longas. Se você estiver preocupado com as implicações de segurança, sempre poderá reverter a alteração da configuração para o original depois de concluir as tarefas de administração.

Sempre que você quiser efetuar login na rootconta de usuário a partir da conta de sudousuário, use um dos seguintes comandos:

sudo -i
sudo su -

Você pode sair da rootconta e voltar para sua sudoconta de usuário a qualquer momento, basta digitar exit.

Etapa 2: Atualize o Sistema Debian 9

Antes de instalar qualquer pacote na instância do servidor Debian, nós iremos primeiro atualizar o sistema.

Certifique-se de ter efetuado login no servidor usando um usuário sudo não-root e execute os seguintes comandos:

sudo apt-get update
sudo apt-get -y upgrade

Etapa 3: instalar o servidor da Web Apache

Instale o servidor da web Apache:

sudo apt-get -y install apache2 

Use o systemctlcomando para iniciar e ativar o Apache para executar automaticamente no momento da inicialização:

sudo systemctl enable apache2
sudo systemctl start apache2

Verifique seu arquivo de configuração do site padrão do Apache para garantir que a DocumentRootdiretiva aponte para o diretório correto:

sudo vi /etc/apache2/sites-enabled/000-default.conf 

A DocumentRootopção de configuração ficará assim:

DocumentRoot "/var/www/html"

Agora precisamos ativar o mod_rewritemódulo Apache, portanto, certifique-se de que o arquivo de configuração do site do Deafult do Apache ainda esteja aberto e adicione as seguintes Directorydiretivas do Apache logo antes da </VirtualHost>tag de fechamento , para que o final do arquivo de configuração seja assim:

    <Directory /var/www/html/>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        allow from all
    </Directory>
</VirtualHost>

A diretiva mais importante mostrada acima é AllowOverride All.

Agora salve e saia do arquivo e ative o mod_rewritemódulo do Apache:

sudo a2enmod rewrite

Vamos reiniciar o Apache no final deste tutorial, mas reiniciar o Apache regularmente durante a instalação e configuração é certamente um bom hábito, então vamos fazer agora:

sudo systemctl restart apache2

Etapa 4: Instalar o PHP 7.0

Agora podemos instalar o PHP 7.0 junto com todos os módulos PHP necessários requeridos pelo ProcessWire CMS:

sudo apt-get -y install php php-gd php-mbstring php-common php-mysql php-imagick php-xml libapache2-mod-php php-curl php-zip

Etapa 5: Instale o servidor MariaDB (MySQL)

O Debian 9 é padronizado para usar o servidor de banco de dados MariaDB, que é um substituto avançado, completamente aberto, desenvolvido pela comunidade, para o servidor MySQL.

Instale o servidor de banco de dados MariaDB:

sudo apt-get -y install mariadb-server

Inicie e permita que o servidor MariaDB seja executado automaticamente no momento da inicialização:

sudo systemctl enable mariadb
sudo systemctl start mariadb    

Proteja sua instalação do servidor MariaDB com:

sudo mysql_secure_installation

A rootsenha ficará em branco, basta pressionar enter quando for solicitada a rootsenha.

Quando solicitado a criar um rootusuário MariaDB / MySQL , selecione “Y” (para sim) e insira uma rootsenha segura . Simplesmente responda “Y” a todas as outras perguntas sim / não, pois as sugestões padrão são as opções mais seguras.

Etapa 6: Criar Banco de Dados para o ProcessWire CMS

Faça o login no shell do MariaDB como o rootusuário do MariaDB , executando o seguinte comando:

sudo mariadb -u root -p

Para acessar o prompt de comando do MariaDB, basta digitar a rootsenha do MariaDB quando solicitado.

Execute as seguintes consultas para criar um banco de dados e um usuário do banco de dados MariaDB para o ProcessWire CMS:

CREATE DATABASE pw_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'pw_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON pw_db.* TO 'pw_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Você pode substituir o nome do banco de dados pw_dbe o nome de usuário pw_userpor algo mais a seu gosto, se preferir. Além disso, certifique-se de substituir “UltraSecurePassword” por uma senha realmente segura.

Etapa 7: Instalar os arquivos do ProcessWire CMS

Altere seu diretório de trabalho atual para o diretório da web padrão:

cd /var/www/html/

Se você receber uma mensagem de erro dizendo algo como, em 'No such file or directory'seguida, tente o seguinte comando:

cd /var/www/ ; sudo mkdir html ; cd html

Seu atual diretório de trabalho agora será: /var/www/html/. Você pode verificar isso com o pwdcomando (diretório de trabalho de impressão):

pwd

Agora use wgetpara baixar o pacote de instalação do ProcessWire CMS:

sudo wget https://github.com/processwire/processwire/archive/master.zip

Por favor, note: Você deve definitivamente verificar a versão mais recente, visitando a página de download do ProcessWire CMS .

Liste o diretório atual para verificar se você fez o download do arquivo com sucesso:

ls -la

Vamos instalar rapidamente unzippara que possamos descompactar o arquivo:

sudo apt-get -y install unzip

Remover index.html:

sudo rm index.html

Agora descompacte o arquivo zip:

sudo unzip master.zip

Mova todos os arquivos de instalação para o diretório raiz da web:

sudo mv processwire-master/* /var/www/html

Altere a propriedade dos arquivos da web para evitar problemas de permissão:

sudo chown -R www-data:www-data * ./

Reinicie o Apache novamente:

sudo systemctl restart apache2

Etapa 8: Conclua a instalação do ProcessWire CMS

Agora é hora de visitar o endereço IP da sua instância do servidor no seu navegador, ou se você já tiver configurado suas configurações de DNS da Vultr (e com tempo suficiente para propagar), basta visitar seu domínio.

Para acessar a página de instalação do ProcessWire CMS, insira o endereço IP da instância do Vultr na barra de endereços do navegador, seguido por index.php:

http://YOUR_VULTR_IP_ADDRESS/install.php

O instalador do ProcessWire CMS contém muitas opções, portanto, aqui estão algumas dicas para ajudá-lo:

1. Na página de boas-vindas da instalação do ProcessWire CMS, clique no Get Startedbotão para iniciar o processo de instalação.
2. Agora selecione seu perfil de instalação preferido (ou site de demonstração) e clique em Continue.
3. Você verá uma Compatibility Checkpágina. Se você vir algum erro, provavelmente significa que você está perdendo alguns módulos do PHP ou tem um problema de permissões, caso contrário, você pode simplesmente clicar Continue.
4. Digite os seguintes valores na MySQL Database Settingspágina:

   DB Name:            pw_db
   DB User:            pw_user
   DB Pass:            UltraSecurePassword
   DB Host:            localhost
   DB Port:            3306
   

5. Você pode deixar as File Permissionconfigurações com seus valores padrão ou ajustá-las se entender as implicações.
6. Você pode inserir os futuros nomes de host do seu site na seção apropriada ou editar o site/config.phparquivo posteriormente, se preferir.
7. Clique em Continuepara configurar o banco de dados e instalar os arquivos do ProcessWire CMS.
8. Em seguida, selecione o seu preferido Admin Theme.
9. Você pode alterar a opção, Admin URLse preferir, ou simplesmente deixá-la no valor padrão.
10. Digite seu Admin Login Detailsconforme mostrado abaixo:

    User (a-z 0-9):     <admin username>
    Password:           <admin password>
    Password (again):   <same admin password>
    Email Address:      <admin email address>
    

11. Depois que todos os detalhes apropriados forem inseridos, você poderá clicar Continuepara finalizar a instalação do ProcessWire.
12. Quando a instalação estiver concluída, basta clicar no Login to Adminbotão para entrar na seção Admin.

Você pode ver um aviso dizendo algo como:

Warning: your server locale is undefined and may cause issues. Please add this to /site/config.php file (adjust en_US.UTF-8†as needed): setlocale(LC_ALL,'en_US.UTF-8');

Você pode corrigir esse erro editando o site/config.phparquivo:

sudo vi site/config.php

Anexe o valor apropriado ao final do arquivo:

setlocale(LC_ALL,'en_GB.utf8');

Se você não conseguir descobrir qual valor usar, poderá encontrar uma lista de valores apropriados para sua instância específica do servidor, executando o localecomando:

locale -a

Não esqueça de salvar e sair do site/config.phparquivo quando terminar de editar.

Por motivos de segurança, certifique-se de alterar as permissões no site/config.phparquivo:

sudo chmod 400 site/config.php

Reinicie o Apache.

sudo systemctl restart apache2

Você está pronto para começar a adicionar seu conteúdo e configurar a aparência do seu site. Certifique-se de verificar a excelente documentação do ProcessWire CMS para obter mais informações sobre como criar e configurar seu site.