Instalação Laravel · 7 min read · Dec 01, 2025

Como Instalar o Framework Web PHP Laravel no Ubuntu 20.04

Laravel é um framework PHP de código aberto amplamente utilizado para desenvolvimento de aplicações web. O padrão arquitetônico MVC (Model-View-Controller) é implementado no Laravel. O projeto Laravel foi iniciado por Taylor Otwell em 2011 como uma alternativa sofisticada ao framework CodeIgniter (CI).

As versões 1 e 2 do Laravel foram publicadas em 2011. O esquema de versionamento, a política de suporte, as Tags de Componentes Blade e Melhorias, Operações de String Fluentes, Melhorias de Vínculo de Modelo de Rota e outras melhorias foram adicionadas à versão atual 8.x.

Neste artigo, você aprenderá como instalar a versão mais recente do Laravel 8.x usando o servidor web Apache no Ubuntu 20.04 Server. Vamos ensinar como instalar o framework web Laravel no Linux de duas maneiras distintas.

Pré-requisitos

  • Sistema Ubuntu 20.04
  • 2 GB ou mais de RAM
  • Privilégios de root
  • Compreensão do Uso Básico do Sistema Debian/Ubuntu

O que faremos?

  • Instalar o Servidor Web Apache
  • Instalar e Configurar o PHP 7.4
  • Instalar o Gerenciamento de Pacotes PHP Composer
  • Instalar o Framework Web Laravel
  • Configurar o Host Virtual Apache para o Projeto Laravel
  • Testando

Passo 1 - Instalar o Servidor Web Apache

Primeiro, instalaremos o servidor web Apache no sistema Ubuntu 20.04 e configuraremos o firewall UFW que permite apenas conexões de entrada para alguns serviços, incluindo SSH, HTTP e HTTPS.

Atualize todos os repositórios disponíveis em seu sistema e instale o servidor web Apache usando o comando apt abaixo.

sudo apt update  
sudo apt install apache2

Uma vez que toda a instalação esteja concluída, inicie o serviço Apache e adicione-o ao boot do sistema.

systemctl start apache2  
systemctl enable apache2

Agora verifique o status do serviço Apache usando o seguinte comando.

systemctl status apache2

Abaixo está o resultado que você obterá.

Instalar Servidor Web Apache

Como resultado, o serviço Apache está ativo e em execução.

Em seguida, adicione os serviços SSH, HTTP e HTTPS ao firewall UFW usando o seguinte comando.

for svc in ssh http https  
do   
ufw allow $svc  
done

Agora ative os serviços do firewall UFW.

sudo ufw enable

Digite ‘ y ‘ para continuar, e o firewall UFW foi ativado.

Configurar firewall UFW

Em seguida, abra seu navegador web e digite o endereço IP do seu servidor na barra de endereços.

http://10.5.5.25/

E você verá a página padrão index.html do Apache.

Apache Default index.html

Como resultado, a instalação do servidor web Apache e a configuração do firewall UFW foram concluídas.

Passo 2 - Instalar e Configurar o PHP 7.4

Neste passo, instalaremos e configuraremos o PHP 7.4 para nossa instalação do Laravel. Para instalar o Laravel 8.x, você deve ter pelo menos o PHP >= 7.2.5 em seu sistema. E por padrão, o repositório oficial do Ubuntu 20.04 fornece pacotes PHP 7.4.

Instale os pacotes PHP 7.4 usando o comando apt abaixo.

sudo apt install libapache2-mod-php php php-common php-xml php-gd php-opcache php-mbstring php-tokenizer php-json php-bcmath php-zip unzip

Uma vez que toda a instalação esteja concluída, vá para o diretório ‘/etc/php/7.4/‘ e edite a configuração ‘php.ini’ para o servidor web Apache2.

cd /etc/php/7.4/  
vim apache2/php.ini

Descomente a opção ‘cgi.fix_pathinfo’ e altere o valor para ‘0’.

cgi.fix_pathinfo=0 

Salve e feche.

Em seguida, reinicie o serviço Apache para aplicar a nova configuração ‘php.ini’.

systemctl restart apache2

Como resultado, a configuração básica do PHP 7.4 foi concluída com sucesso.

Configurar PHP 7.4 no Sistema Ubuntu

Passo 3 - Instalar o Gerenciamento de Pacotes PHP Composer

O Composer é um gerenciador de dependências para PHP. É um gerenciador de pacotes em nível de aplicativo para PHP que permite baixar dependências e bibliotecas adicionais para seu projeto PHP.

Neste tutorial, usaremos o Composer para instalar o Laravel, e instalaremos o Composer baixando o arquivo binário do site oficial do composer.

Baixe o arquivo binário do Composer e mova o arquivo para o diretório ‘/usr/local/bin’.

curl -sS https://getcomposer.org/installer | php  
sudo mv composer.phar /usr/local/bin/composer

Depois disso, verifique a versão do composer usando o seguinte comando.

composer --version

Abaixo está o resultado que você obterá.

Instalar Composer no Ubuntu 20.04

Como pode ser visto, o Gerenciamento de Pacotes PHP Composer foi instalado no Sistema Ubuntu.

Passo 4 - Instalar o Laravel 8.x no Ubuntu 20.04

Para este passo, mostraremos duas maneiras diferentes de instalar o framework web Laravel. Instalaremos o Laravel via o Instalador Laravel e o instalaremos através do Composer.

- Instalar Laravel Via Instalador Laravel

Esse tipo de instalação é mais adequado para desenvolvedores Laravel. Porque ao usar o Instalador Laravel, você pode instalar o Laravel em qualquer lugar com um usuário não-root.

Esta seção instalará o framework web Laravel com o usuário não-root chamado ‘hakase’.

Você pode adicionar o usuário e configurar sua senha usando o seguinte comando.

useradd -m -s /bin/bash hakase  
passwd hakase

Depois disso, faça login no usuário ‘hakase’.

su - hakase

Em seguida, instale o pacote Instalador Laravel usando o comando composer abaixo.

composer global require laravel/installer

Uma vez que toda a instalação esteja concluída, você obterá o seguinte resultado.

Instalar Instalador Laravel

Como pode ser visto, todos os pacotes foram instalados no diretório ‘~/.config/composer’.

Em seguida, precisamos adicionar o diretório ‘bin’ à variável de ambiente PATH através da configuração ~/.bashrc.

Edite a configuração ~/.bashrc usando o editor vim.

vim ~/.bashrc

Cole a seguinte configuração no final da linha.

export PATH="$HOME/.config/composer/vendor/bin:$PATH"

Salve e feche.

Agora carregue a nova versão da configuração ~/.bashrc e verifique a variável de ambiente $PATH.

source ~/.bashrc  
echo $PATH

Abaixo está o resultado que você obterá.

O diretório ‘bin’ para os pacotes do composer foi adicionado à variável de ambiente $PATH. E como resultado, você pode usar o comando ‘laravel’ para iniciar e criar um novo projeto.

Como resultado, agora você pode usar o comando ‘laravel’ para criar um novo projeto.

Para criar um novo projeto Laravel chamado ‘blog’, execute o comando laravel abaixo.

laravel new blog

Agora você terá o diretório do projeto Laravel ‘blog’.

Criar Novo Projeto Laravel com o Instalador Laravel

Para torná-lo acessível para o servidor web Apache acessar o diretório do seu projeto Laravel, altere o grupo proprietário do diretório do projeto para o grupo ‘www-data’ e torne o diretório ‘storage’ gravável.

sudo chgrp -R www-data /home/hakase/blog  
sudo chmod -R 775 /home/hakase/blog/storage

Como resultado, o Laravel foi instalado usando o instalador Laravel, e você está pronto para configurar o host virtual Apache para seu projeto Laravel.

Configurar Projeto Laravel

- Instalar Laravel Via Composer create-project

Outra maneira de instalar o framework web Laravel é usando o gerenciamento de pacotes PHP Composer.

Vá para o diretório ‘/var/www/‘ e crie um novo projeto Laravel chamado ‘blog’ usando o comando ‘composer’ abaixo.

cd /var/www/  
composer create-project --prefer-dist laravel/laravel blog

Agora você terá o novo diretório do projeto chamado ‘blog’.

Criar Projeto Laravel com Composer

Em seguida, altere a propriedade do diretório do projeto ‘blog’ para o usuário ‘www-data’ e torne o diretório ‘storage’ gravável.

sudo chown -R www-data:www-data /var/www/blog  
sudo chmod -R 775 /var/www/blog/storage

Como resultado, você instalou o framework web Laravel usando o comando Composer.

Configurar Projeto Laravel

Passo 5 - Configurar Apache para o Projeto Laravel

Neste passo, configuraremos o host virtual Apache para o projeto Laravel.

Agora vá para o diretório ‘/etc/apache/sites-available’ e crie uma nova configuração de host virtual ‘laravel.conf’ usando o editor vim.

cd /etc/apache2/sites-available/  
vim laravel.conf

Altere o nome do domínio e o diretório webroot com os seus e cole a configuração nele.

  
    ServerName hakase-labs.io  
    
    ServerAdmin [email protected]  
    DocumentRoot /home/hakase/blog/public  
    
      
    Options Indexes MultiViews  
    AllowOverride None  
    Require all granted  
      
    
    ErrorLog ${APACHE_LOG_DIR}/error.log  
    CustomLog ${APACHE_LOG_DIR}/access.log combined  

Salve e feche.

Em seguida, ative o módulo de reescrita do Apache e a configuração do host virtual Laravel usando o seguinte comando.

sudo a2enmod rewrite  
sudo a2ensite laravel.conf

Depois disso, teste a configuração do Apache, garantindo que não haja erro, e reinicie o serviço Apache.

apachectl configtest  
systemctl restart apache2

Como resultado, a configuração do host virtual Apache para Laravel foi concluída.

Configurar Host Virtual Apache para Laravel

Passo 6 - Testando

Abra seu navegador web e digite o endereço IP do seu servidor ou nome de domínio na barra de endereços.

http://hakase-labs.io/

Abaixo está o resultado que você obterá.

Página Padrão Laravel

Como resultado, a instalação e configuração do Laravel com o servidor web Apache foi concluída com sucesso.

Referência

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.