Como instalar o Laravel na DigitalOcean (Guia passo a passo)

Principais conclusões

• Podes configurar o Laravel manualmente na DigitalOcean para uma flexibilidade total ou usar a Cloudways para saltar o trabalho pesado e ter um ambiente gerido pronto em minutos.
• Uma vez que as aplicações Laravel são executadas a partir do diretório public/, certificar-se de que o teu servidor aponta para aqui evita erros e mantém a tua aplicação segura.
• Não te esqueças de atualizar o teu ficheiro .env com as credenciais da base de dados e ajustar as permissões das pastas para que as migrações, o armazenamento e a cache do Laravel funcionem sem problemas.

Colocar uma aplicação Laravel em um servidor é um passo fundamental para qualquer projeto web. Muitos desenvolvedores escolhem a DigitalOcean para isso porque ela oferece uma combinação perfeita de desempenho, preço acessível e uma comunidade forte.

Se estás à procura de instalar uma aplicação Laravel na DigitalOcean, estás no sítio certo. Este guia abrange dois métodos distintos para colocar seu aplicativo no ar.

Vou mostrar-te a abordagem manual, que te dá controlo total, criando um Droplet e tratando eu mesmo de todas as configurações. Também abordarei um método mais simples utilizando a Cloudways, uma plataforma gerida que simplifica todo o processo para ti.

No final, terás uma compreensão clara de ambos os métodos e poderás escolher o melhor para as tuas necessidades.

Como instalar o Laravel na DigitalOcean (método manual)

Agora, vamos mergulhar no primeiro método. A abordagem manual é para desenvolvedores que desejam ter controle total sobre a pilha do servidor e é uma ótima maneira de entender exatamente o que está acontecendo nos bastidores.

Pré-requisitos (lista de verificação rápida)

• Conta DigitalOcean com faturação configurada.
• Um Droplet (Ubuntu LTS).
• Um domínio (opcional) apontado para o IP do seu Droplet (registro A).
• Conforto básico com o terminal.
• Marcadores de lugar que vais substituindo à medida que avanças:
  • YOUR_SERVER_IP – o IP público do teu Droplet
  • your_domain.com – o teu domínio (ou utiliza o IP durante o teste)
  • myapp – o nome da pasta do teu projeto

O que vais acabar por ter

• Servidor Ubuntu (Droplet)
• Nginx + PHP-FPM + Composer
• Nova aplicação Laravel em /var/www/[a tua pasta de aplicações]
• Base de dados MySQL
• Bloqueio do servidor Nginx para o IP ou domínio do teu servidor

1) Cria o teu Droplet

• Faz login na DigitalOcean → Criar → Droplets.

• Centro de dados: escolhe o mais próximo dos teus utilizadores.

• Imagem: Ubuntu (escolhe a última versão LTS). LTS significa basicamente Suporte a Longo Prazo. As versões LTS são estáveis e suportadas durante mais tempo, que é o que pretendes para um servidor de produção. Para qualquer servidor que planeies manter a funcionar a longo prazo, escolhe uma versão LTS.

• Plano: O plano básico é bom; 1-2 GB de RAM é suficiente para uma aplicação de demonstração/pequena.

• Autenticação:
  • Chaves SSH (recomendado): adiciona a tua chave pública (ver passo 2 abaixo).
  • Ou define uma palavra-passe de raiz (menos segura). Para efeitos deste tutorial, vou escolher a opção de palavra-passe e depois criar uma palavra-passe de raiz.

• Clica em Criar Droplet e copia o IP público.

• Quando o teu droplet estiver ativo, copia o seu endereço IP – vamos precisar dele mais tarde.

2) Liga-te ao teu servidor (através da consola da DigitalOcean)

Agora que o teu Droplet está pronto e tens o IP do teu droplet à mão, vamos ligar-nos a ele.

A maneira mais fácil é usar o Launch Console da DigitalOcean – ele abre um terminal baseado em navegador diretamente no seu servidor.

• Vai para o teu Droplet no painel de controlo da DigitalOcean.
• Clica em Acessar Console.

• Clica em Iniciar Console do Droplet.

• Abre uma nova janela com um terminal.

O que conseguiste: Agora estás ligado ao teu novo servidor como root e pronto para o configurar.

3) Actualiza o servidor e ativa uma firewall básica

Antes de começarmos a instalar o Laravel ou qualquer software de servidor web, é sempre uma boa ideia garantir que o teu servidor está atualizado e seguro. Pensa neste passo como uma verificação da saúde do teu novo droplet antes de o pores a trabalhar.

Vai em frente e executa estes comandos um a um:

apt update && apt upgrade -y

apt install -y ufw

ufw permite OpenSSH

ufw enable

estado do ufw

Eis o que está a acontecer:

• O apt update & apt upgrade -y assegura que todos os pacotes do sistema estão actualizados. Isto reduz os bugs e fecha quaisquer falhas de segurança conhecidas.
• O ufw (Uncomplicated Firewall) dá-nos uma forma simples de controlar que ligações são permitidas no servidor.
• ufw allow OpenSSH garante que não te bloqueies no servidor (uma vez que o SSH/console precisa de permanecer aberto).
• ufw enable ativa o firewall e o configura para iniciar automaticamente na reinicialização.

Quando verificares o estado com ufw status, deves ver algo como:

Nesta altura, o teu droplet está atualizado e tem uma camada de segurança básica instalada.

4) Instala o Nginx, o PHP e outros elementos essenciais

Agora que o servidor está atualizado e protegido com um firewall básico, o próximo passo é realmente instalar a pilha de software que o Laravel precisa. No centro desta configuração está o Nginx, o servidor web que servirá a tua aplicação Laravel.

Junto com ele, instalaremos o PHP-FPM (para que o código PHP possa ser executado), o Composer (gerenciador de pacotes do Laravel) e algumas extensões PHP úteis.

• Nginx para lidar com o tráfego da Web.
• PHP-FPM + extensões para executar o código da estrutura Laravel.
• Composer para gerir as dependências do Laravel.
• Git e unzip para descarregar e descompactar ficheiros de projeto.

Executa isto na tua consola, mais uma vez, um por um:

apt install -y nginx php-fpm php-cli php-mbstring php-xml php-bcmath php-curl php-zip php-gd php-intl unzip git

apt install -y composer

Quando terminar, verifica o seu estado:

systemctl status nginx

Deves ver ativo (em execução).

Por padrão, o Nginx escuta nas portas 80 (HTTP) e 443 (HTTPS), mas, neste momento, seu firewall não está permitindo que o tráfego externo passe por essas portas. É por isso que o próximo passo é abri-las:

ufw permite 80

ufw permite 443

estado do ufw

Verás OpenSSH, 80 e 443 na lista. Isto significa que o teu servidor está agora acessível através da web.

Tenta abrir o endereço IP do teu servidor num browser (http://YOUR_SERVER_IP) – deves ver a página de boas-vindas predefinida do Nginx.

Assim:

Neste ponto, tens um servidor Web em execução com suporte PHP, Composer para gerir o Laravel e a firewall configurada para permitir que os visitantes se liguem ao teu site.

5) Instala o MySQL (opcional mas recomendado)

No último passo, instalámos o Nginx e o PHP, o que já torna o teu servidor pronto para executar o Laravel. Mas a maioria dos projetos Laravel depende de um banco de dados para lidar com usuários, postagens, pedidos ou outro conteúdo dinâmico. É por isso que configuramos um banco de dados MySQL aqui.

Se a tua aplicação não precisa de uma base de dados, podes saltar este passo. Caso contrário, vamos instalar e proteger o MySQL.

Primeiro, instala o servidor:

apt install -y mysql-server

Uma vez instalado, executa o script de segurança do MySQL:

mysql_secure_installation

Isto irá guiar-te através do reforço da configuração do MySQL:

• Ativar o plugin de validação da palavra-passe? → digita y.
• Escolhe a política de resistência → introduz 1 para MÉDIO.
• Estás a saltar a password para o root devido ao auth_socket? → isso é normal, o root no Ubuntu usa autenticação por socket.
• Remover utilizadores anónimos? → y
• Não permites o login do root remotamente? → y
• Remover base de dados de teste? → y
• Recarregas as tabelas de privilégios agora? → y

Neste ponto, o MySQL está bloqueado.

Agora vamos criar uma base de dados e um utilizador MySQL dedicado para a tua aplicação Laravel. Faz login no prompt do MySQL:

mysql

Uma vez lá dentro, executa estes comandos (substitui laravel_db, laravel_user, e StrongPasswordHere!

com os teus próprios valores):

CRIA a base de dados laravel_db;

CRIAR UTILIZADOR 'laravel_user'@'localhost' IDENTIFICADO COM mysql_native_password POR 'StrongPasswordHere!';

CONCEDE TODOS OS PRIVILÉGIOS EM laravel_db.* A 'laravel_user'@'localhost';

PRIVILÉGIOS DE DESCARGA;

SAÍDA;

O que fizeste aqui:

• Cria uma nova base de dados (laravel_db).
• Adicionado um utilizador (laravel_user) com a sua própria palavra-passe.
• Concede a esse utilizador acesso total apenas a essa base de dados.
• Aplica as alterações.

Mais tarde, quando configurares o teu ficheiro .env do Laravel, vais inserir estes valores:

DB_DATABASE=laravel_db

DB_USERNAME=laravel_user

DB_PASSWORD=StrongPasswordHere!

Dessa forma, o Laravel se conecta de forma segura ao seu próprio banco de dados sem depender da conta root.

6) Cria um novo projeto Laravel

Neste ponto, seu servidor já está preparado com Nginx, PHP e (opcionalmente) MySQL das últimas etapas. Agora vem a parte emocionante – realmente instalar o Laravel em seu droplet da DigitalOcean.

Primeiro, vai para o diretório /var/www. Este é um local comum para manteres os teus projectos web:

cd /var/www

Antes de criarmos o projeto, vamos nos certificar de que todas as extensões PHP das quais o Laravel depende estão instaladas. Mesmo que tenhamos instalado o PHP anteriormente, algumas extensões opcionais, mas importantes (como xml, dom e mbstring) são necessárias para o Laravel e seu ecossistema (como PHPUnit para testes e Pint para formatação de código).

Executa isto para instalar tudo de uma só vez:

apt install -y php-cli php-fpm php-mbstring php-xml php-bcmath php-curl php-zip php-gd php-intl php-mysql unzip git

Agora, usa o Composer para criar um novo projeto Laravel. Substitui mylaravelapp pelo nome que quiseres dar à pasta do teu projeto:

compositor cria um projeto laravel/laravel mylaravelapp

O Composer irá baixar e configurar o Laravel em um novo diretório em /var/www/mylaravelapp. Isso pode levar alguns minutos, dependendo da velocidade do teu servidor.

Quando terminar, passa para a pasta do teu novo projeto:

cd /var/www/mylaravelapp

Neste ponto, tens uma aplicação Laravel a funcionar no teu servidor, pronta para ser servida através do Nginx.

O que acabaste de conseguir: Você puxou com sucesso uma nova base de código Laravel para o seu droplet da DigitalOcean. A partir daqui, o próximo passo é configurar o Nginx para que ele aponte para a pasta public/ do Laravel e possa servir seu aplicativo para a Web.

7) Configura o ambiente e as permissões do Laravel

Agora que o Laravel está instalado em /var/www/mylaravelapp, ele precisa de alguns ajustes antes de poder ser executado. O Laravel depende de um ficheiro.env para armazenar definições importantes, como os detalhes da tua ligação à base de dados.

Abre o ficheiro de ambiente:

nano .env

Quando o editor nano for aberto, procura esta secção:

DB_CONNECTION=sqlite

# DB_HOST=127.0.0.1

# DB_PORT=3306

# DB_DATABASE=laravel

# DB_USERNAME=root

# DB_PASSWORD=

Substitui-o pelas tuas definições MySQL (descomenta e ajusta):

DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=laravel_db

DB_USERNAME=laravel_user

DB_PASSWORD=a tua palavra-passe

Desce até à secção da base de dados e substitui-a pelas credenciais da base de dados que criaste anteriormente:

DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=laravel_db

DB_USERNAME=laravel_user

DB_PASSWORD=pAssword123!a

Substitui laravel_db, laravel_user e your_password pela base de dados e pelo utilizador que criaste anteriormente no MySQL.

Guarda e sai do nano:

Prima CTRL + O → e depois Enter (para guardar).

Prima CTRL + X (para sair).

Em seguida, define as permissões corretas para que o Laravel possa escrever nos diretórios de armazenamento e cache:

sudo chown -R www-data:www-data /var/www/mylaravelapp/storage /var/www/mylaravelapp/bootstrap/cache

sudo chmod -R 775 /var/www/mylaravelapp/storage /var/www/mylaravelapp/bootstrap/cache

Isso garante que o Nginx (que é executado como www-data) possa ler e escrever onde for necessário.

8) Executa as migrações da base de dados

Agora que o Laravel sabe como se conectar ao teu banco de dados, vamos criar as tabelas padrão que ele precisa (como usuários e redefinições de senha).

Corre:

php artisan migrate

Se tudo estiver configurado corretamente, verás uma série de mensagens “Migrado” bem sucedidas.

9) Configura o Nginx para o Laravel

Neste momento, o Nginx não conhece o teu projeto Laravel. Precisamos apontá-lo para a pasta public/ do Laravel – este é o único diretório que deve ser acessível pela web.

Cria um novo ficheiro de configuração para a tua aplicação:

sudo nano /etc/nginx/sites-available/mylaravelapp

Depois de executares este comando, verás uma janela em branco do editor nano. Cola esta configuração(substitui o teu_servidor_ip pelo IP ou domínio do teu servidor):

servidor {

Ouve 80;

nome_do_servidor o teu_ip_do_servidor;




root /var/www/mylaravelapp/public;




index index.php index.html index.htm;




localização / {

tenta_arquivos $uri $uri/ /index.php?$query_string;

}




localização ~ \.php$ {

inclui snippets/fastcgi-php.conf;

fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

inclui fastcgi_params;

}




localização ~ /\.ht {

nega tudo;

}

}

Este bloco informa o Nginx:

• serve ficheiros de /var/www/mylaravelapp/public
• processa ficheiros PHP com PHP-FPM
• nega o acesso a ficheiros .ht* ocultos

Guarda e sai do nano

• CTRL + O → Enter (para guardar)
• CTRL + X (para sair)

Habilita o site criando um link simbólico para sites-enabled:

ln -s /etc/nginx/sites-available/mylaravelapp /etc/nginx/sites-enabled/

Testa a configuração para te certificares de que não existem erros:

nginx -t

Devias ver:

a sintaxe está correta

o teste foi bem sucedido

Recarrega o Nginx para aplicar a nova configuração:

recarrega o nginx

10) Testa o Laravel no navegador

Nesta altura, abre o teu browser e visita:

http://YOUR_SERVER_IP

Se tudo foi feito corretamente, verás a página “Welcome” predefinida do Laravel.

É isso, a página “Let’s get started” que estás a ver é o ecrã de boas-vindas predefinido do Laravel, que confirma que a tua aplicação está instalada e acessível a partir do browser.

A partir daqui, basicamente concluíste os passos de implementação. O resto depende das necessidades do teu projeto:

• Se estiveres apenas a testar → podes deixar como está.
• Se quiseres construir algo → começa a editar as rotas em routes/web.php e controllers.
• Se isto é produção → os próximos passos naturais são configurar o SSL com Let’s Encrypt (Certbot), desligar o modo de depuração (APP_DEBUG=false em .env), e talvez configurar o Supervisor se fores correr filas.

Instalar o Laravel na DigitalOcean da maneira mais fácil (usando o Cloudways)

Se a configuração manual parece muito complexa, nós a tornamos muito mais simples na Cloudways. Em vez de passar horas configurando servidores, você pode lançar o Laravel na DigitalOcean em apenas alguns cliques – com tudo otimizado e gerenciado para ti.

Vê como:

1) Inscreve-te na Cloudways

Começa por criar a tua conta Cloudways. Oferecemos um teste gratuito de 3 dias – não é necessário cartão de crédito. Depois de fazer o login, você chegará ao seu painel de controle da Cloudways.

2) Lança um novo servidor

Vai ao menu dos servidores e clica em + Adicionar servidor.

• Escolhe a aplicação → Seleciona Laravel. Preparamos automaticamente o ambiente para ti.

• Detalhes da aplicação e do servidor → Dá um nome à tua aplicação e ao teu servidor.

• Fornecedor de nuvem → Escolhe DigitalOcean.

• Tamanho do servidor → Um servidor de 1GB é suficiente para começar, mas podes escalar em qualquer altura.

• Região → Escolhe o centro de dados mais próximo dos seus utilizadores para obter o melhor desempenho.

Carrega em Launch Now e, em poucos minutos, o teu servidor preparado para o Laravel estará pronto a funcionar.

3) Aceder à tua aplicação Laravel

Quando o servidor estiver pronto:

• Vai para o separador Aplicações no teu painel de controlo da Cloudways.
• Clica na tua aplicação Laravel.
• Carrega na ligação URL da candidatura.

Neste ponto, ainda não verás o ecrã de boas-vindas do Laravel. Em vez disso, o Cloudways mostra uma página de Introdução com links para guias. Isso é porque ainda precisamos apontar o Cloudways para o teu projeto Laravel corretamente.

4) Prepara o teu projeto Laravel

A página “Getting Started” que você está vendo significa que a Cloudways provisionou o servidor, mas é um shell vazio esperando pelo seu código. O próximo passo é obter o teu projeto Laravel do teu computador local e prepará-lo para a implantação.

Embora a melhor prática para a maioria dos programadores seja gerir o seu código com o Git e implementar a partir de um repositório, para este tutorial, vamos criar um projeto na nossa máquina local e transferi-lo. Esta é uma ótima maneira de entender o processo subjacente.

• Cria o teu projeto: Abre o terminal do teu computador ou o prompt de comando e executa um único comando. Isto diz ao Composer para descarregar todos os ficheiros Laravel e criar um novo projeto para ti. Executa este comando:

composer create-project laravel/laravel my-laravel-project

Isso criará uma nova pasta chamada my-laravel-project com todos os arquivos básicos do Laravel. Esta é a pasta para a qual faremos o upload. Antes de o fazeres, temos de remover alguns ficheiros que não são necessários no servidor para tornar o processo mais rápido e mais limpo.

Localiza a pasta de raiz do teu projeto e elimina o seguinte:

• vendor/: Esta pasta grande contém todas as tuas dependências PHP. Nós vamos reinstalá-las no servidor.
• .env: Este ficheiro tem informação sensível. Cria um novo, separado, no servidor.

5) Carrega os ficheiros do teu projeto

Agora é altura de transferir o teu projeto para o servidor. Vamos utilizar o FileZilla, um cliente SFTP de fácil utilização, que utiliza o protocolo de transferência segura de ficheiros.

• Obter suas credenciais SFTP: Vá para o painel de controle da Cloudways, navegue até Servidores e clique no seu servidor. Em Credenciais mestre, você verá as credenciais necessárias para fazer login no seu servidor usando o FileZilla.

• Liga-te ao FileZilla: Abre o FileZilla. Introduz as tuas credenciais na barra superior: Host (IP público), Nome de usuário, Senha e Porta (22). Clica em Quickconnect.

• Carrega: Uma vez ligado, verás o sistema de ficheiros do teu servidor no lado direito. Navega para /applications/[your_app_username]/public_html. No lado esquerdo, encontra a pasta do teu projeto Laravel. Seleciona todos os restantes ficheiros e pastas e arrasta-os para a pasta public_html do lado direito.

Sim, precisas absolutamente de atualizar o ficheiro .env com as tuas credenciais específicas. O processo que descreveste está correto e é essencial para que a tua aplicação se ligue à base de dados e funcione corretamente.

O conteúdo fornecido já inclui estes passos, mas vou tornar as instruções ainda mais explícitas para garantir que não te escapam quaisquer pormenores.

6) Finalizar a configuração com o terminal SSH da Cloudways

Os ficheiros estão agora no servidor, mas tens de executar alguns comandos para que tudo fique configurado.

Abre o Terminal: Vai para o painel de controle da Cloudways, depois para Servidores > Credenciais mestre. Clique em Iniciar terminal SSH e faça login com seu nome de usuário e senha principais.

Navega para o teu projeto: Uma vez conectado, usa o comando cd para navegar até o diretório da sua aplicação:

cd aplicações/[your_app_username]/public_html

Executa os comandos: Agora, executa os seguintes comandos, um a um, para instalar as dependências, definir o ambiente e configurar a base de dados.

Instala as dependências do PHP: Cria a pasta do fornecedor no servidor.

instala o compositor

Cria o arquivo de ambiente: Copia o ficheiro de exemplo para um ficheiro .env novo e funcional.

cp .env.example .env

Configura as tuas variáveis de ambiente: Este é o passo mais crítico. Vamos abrir o ficheiro .env para atualizar as tuas credenciais.

nano .env

No editor, encontra a seção de banco de dados e atualiza as credenciais com as informações da seção Credenciais de acesso ao Cloudways. Além disso, atualiza o APP_URL e define o sinalizador APP_DEBUG.

DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=o teu nome_de_base_aqui

DB_USERNAME=o teu nome de utilizador_db_aqui

DB_PASSWORD=a tua palavra-passe_db_aqui




APP_URL=https://your-domain.com

APP_DEBUG=false

Depois de editar, prime Ctrl + X, Y e Enter para guardar e sair.

Gera uma chave de aplicação: Isto é crucial para a segurança.

php artisan key:generate

Executa as migrações da base de dados: Isto irá criar as tabelas necessárias na tua base de dados.

php artisan migrate

Já fizeste tudo!

Quando o comando php artisan migrate for executado com êxito, verás uma lista das tabelas que foram criadas. Isto significa que a tua aplicação se ligou com sucesso à base de dados e está pronta a funcionar.

Agora, podes visitar o URL do teu aplicativo para ver a página de boas-vindas do Laravel. Você implantou com sucesso um aplicativo Laravel na DigitalOcean usando o Cloudways.

Como podes ver, implantar o Laravel com o Cloudways é um processo muito mais simples e rápido em comparação com fazê-lo manualmente em um Droplet da DigitalOcean, o que exigiria uma extensa configuração do servidor, proteção de segurança e muito trabalho de linha de comando. O Cloudways lida com tudo isso para ti e poupa-te de configurações manuais.

Terminar!

Então, aí tens. Viste agora duas maneiras sólidas de colocar uma aplicação Laravel no ar na DigitalOcean. A abordagem manual, embora seja um processo mais longo, dá-te um controlo total e uma compreensão mais profunda do servidor. Por outro lado, o método Cloudways mostra-te o quão rápido e simples pode ser o deployment.

Espero que este guia te ajude a decidir qual é o caminho certo para o teu projeto. De qualquer forma, agora tens todo o conhecimento necessário para lançar com êxito a tua aplicação Laravel.