Instalar manualmente

Módulo 2: Instalar e configurar · Tempo de leitura: 9 minutos

Objetivo de aprendizagem: Após esta lição, saberá instalar o WordPress sem instalador e compreenderá o que um instalador faz por si.

Conceitos-chave: transferência a partir de wordpress.org, soma de verificação, SFTP, base de dados, utilizador da base de dados, privilégios mínimos, wp-config-sample.php, chaves e salts, prefixo de tabelas, script de instalação, WP-CLI

Porque vale a pena fazê-lo uma vez à mão

Mesmo que utilize sempre um instalador, é instrutivo instalar o WordPress uma vez manualmente. Assim vê quais os componentes que existem e como se relacionam entre si. Isto ajuda mais tarde numa migração, numa base de dados que não liga ou numa site que herda de outra pessoa sem instalador. E nem todos os fornecedores de alojamento têm um instalador.

Os passos: transferir o WordPress, carregá-lo, criar uma base de dados, preencher o wp-config.php e executar o script de instalação.

Passo 1: transferir, e apenas a partir de wordpress.org

Transfira sempre o WordPress a partir de https://wordpress.org/download/ (ou a versão em português de https://wordpress.org/). Nunca de outra site: uma versão alterada pode conter uma porta das traseiras.

Na página de lançamentos do wordpress.org encontra, para cada versão, uma soma de verificação (SHA-1 ou MD5). Com ela pode confirmar se a sua transferência não foi alterada pelo caminho. No seu próprio computador, por exemplo:

sha1sum wordpress-7.1.4.zip            (Linux)
shasum -a 1 wordpress-7.1.4.zip        (macOS)
certutil -hashfile wordpress-7.1.4.zip SHA1   (Windows)

O resultado deve ser exatamente igual ao valor indicado em wordpress.org.

Passo 2: carregar

Descompacte o ficheiro zip. Obtém uma pasta wordpress que contém wp-admin, wp-includes, wp-content e os ficheiros soltos. Coloque o conteúdo dessa pasta na sua pasta web (public_html), não a pasta em si; caso contrário, a sua site fica em example.com/wordpress/.

O carregamento pode ser feito de duas formas:

• Com um programa de FTP como o FileZilla. Utilize SFTP ou FTPS, nunca FTP normal: com FTP normal, a sua palavra-passe circula pela internet sem encriptação.
• Como zip através do Gerenciador de arquivos do seu painel, descompactando-o aí. Isto é, geralmente, muito mais rápido do que carregar milhares de ficheiros separados.

Passo 3: base de dados e utilizador da base de dados

Crie no seu painel uma nova base de dados e um utilizador da base de dados. Tenha atenção a dois aspetos:

• Um utilizador próprio por site. Não utilize um único utilizador de base de dados para todas as suas sites, e muito menos a conta principal do seu alojamento. Se uma site for atacada, o intruso só consegue aceder, com esses dados, a essa única base de dados.
• Privilégios: para uso normal, o WordPress precisa apenas de ler, escrever, alterar e eliminar dados (SELECT, INSERT, UPDATE, DELETE). Para a instalação e para atualizações que alteram a estrutura das tabelas, são também necessários CREATE, ALTER, INDEX e DROP. Na prática, a maioria dos painéis atribui ao utilizador todos os privilégios sobre essa única base de dados. Isto é aceitável, desde que seja apenas essa base de dados.

Anote o nome da base de dados, o nome de utilizador, a palavra-passe e o servidor (host). Na maioria dos fornecedores de alojamento, o servidor é localhost. No DirectAdmin, a base de dados e o utilizador recebem o nome da sua conta como prefixo, como por exemplo utilizador_wp1.

Passo 4: wp-config.php

Na pasta encontra o ficheiro wp-config-sample.php. Copie-o para wp-config.php e preencha:

define( 'DB_NAME', 'utilizador_wp1' );
define( 'DB_USER', 'utilizador_wp1' );
define( 'DB_PASSWORD', 'a-palavra-passe-do-passo-3' );
define( 'DB_HOST', 'localhost' );

Em seguida, substitua as oito linhas com put your unique phrase here por novas chaves e salts. Pode obtê-las em https://api.wordpress.org/secret-key/1.1/salt/: sempre que abrir essa página, recebe novos valores aleatórios. Cole-os no lugar das linhas de exemplo.

Opcionalmente, escolha um prefixo de tabelas diferente de wp_, por exemplo se colocar várias instalações numa única base de dados. Apenas letras, números e um traço.

Guarde o wp-config.php. Se saltar este passo, o WordPress abrirá, no passo 5, um formulário onde preenche os dados da base de dados. Isto funciona, mas nesse caso as chaves e o prefixo não são escolhidos por si.

Passo 5: o script de instalação

Abra https://example.com/wp-admin/install.php no seu navegador. O WordPress pergunta o idioma, o nome da site, o nome de utilizador e a palavra-passe do administrador, o endereço de e-mail e se os motores de pesquisa podem indexar a site. Depois disso, cria as tabelas e a site fica pronta.

Faça isto imediatamente após o carregamento. Um WordPress carregado mas ainda não instalado é perigoso: quem abrir primeiro o install.php escolhe o administrador. Existem robôs que procuram exatamente isso. Por isso, não carregue hoje e instale só na semana seguinte.

O mesmo com o WP-CLI

O WP-CLI é um programa de linha de comandos com o qual instala e gere o WordPress sem navegador. Muitos fornecedores de alojamento disponibilizam-no via SSH ou um terminal no painel. A instalação completa é então:

wp core download --locale=pt_PT
wp config create --dbname=utilizador_wp1 --dbuser=utilizador_wp1 --prompt=dbpass
wp core install --url=https://example.com --title="O meu site" \
  --admin_user=admin_k7 --admin_email=admin@example.com --prompt=admin_password

wp config create cria o wp-config.php e obtém automaticamente novas chaves e salts. Com --prompt digita a palavra-passe em vez de a colocar no comando (caso contrário, ficaria gravada no histórico do seu terminal).

O WP-CLI também é útil mais tarde: wp core update, wp plugin list, wp core verify-checksums (lição 7.5) e wp search-replace (lição 3.2). Não precisa de o utilizar, mas é bom saber que existe.

O que um instalador faz a mais

Agora que o fez à mão, vê o que um instalador acrescenta: cria a base de dados e o utilizador com uma palavra-passe forte, obtém novos salts, instala imediatamente (sem um install.php aberto) e regista a instalação para atualizações, cópias de segurança e clonagens. Se instalar à mão, terá de tratar você mesmo destes últimos aspetos (módulos 7 e 8), ou importar depois a instalação para o seu instalador.

Resumo

• Transfira o WordPress apenas a partir de wordpress.org e, se possível, verifique a soma de verificação.
• Carregue via SFTP ou FTPS, ou como zip através do Gerenciador de arquivos.
• Dê a cada site a sua própria base de dados e utilizador de base de dados.
• Preencha o wp-config.php com os dados da base de dados e novas chaves e salts obtidos em api.wordpress.org.
• Execute o script de instalação imediatamente após o carregamento; um install.php aberto é um risco.

Questionário

Exercício

Exercício D2.3: Uma segunda instalação manual. Instale o WordPress manualmente num subdomínio de teste, por exemplo manual.example.com (com o seu próprio domínio). Transfira a partir de wordpress.org, crie a sua própria base de dados e utilizador de base de dados, preencha o wp-config.php com novos salts e execute o script de instalação. Registe cada passo e responda: que privilégios recebeu o seu utilizador de base de dados, e porque é isso (im)prudente? Qual foi a diferença em relação ao instalador da lição 2.2? Remova a instalação de teste (ficheiros e base de dados) quando terminar, ou importe-a para o seu instalador.

Leitura adicional

Estes artigos descrevem os passos nos painéis da WebOké; noutros painéis funcionam de forma semelhante.

• Manual DirectAdmin 11.7: Ligar com FileZilla (FTP, FTPS e SFTP)
• Manual DirectAdmin 11.3: Extrair e criar ficheiros zip
• Manual DirectAdmin 12.1: Criar um banco de dados
• Manual DirectAdmin 12.2: Utilizadores de bases de dados, permissões e palavras-passe
• Manual DirectAdmin 15.2: Chaves do SSH e iniciar sessão com SSH
• Manual DirectAdmin 15.3: Terminal de comando no seu browser
• Instalar o WordPress (wordpress.org, Inglês): https://developer.wordpress.org/advanced-administration/before-install/howto-install/