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 apache2Uma 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 apache2Agora verifique o status do serviço Apache usando o seguinte comando.
systemctl status apache2Abaixo está o resultado que você obterá.

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
doneAgora ative os serviços do firewall UFW.
sudo ufw enableDigite ‘ y ‘ para continuar, e o firewall UFW foi ativado.

Em seguida, abra seu navegador web e digite o endereço IP do seu servidor na barra de endereços.
E você verá a página padrão index.html do Apache.

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 unzipUma 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.iniDescomente 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 apache2Como resultado, a configuração básica do PHP 7.4 foi concluída com sucesso.

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/composerDepois disso, verifique a versão do composer usando o seguinte comando.
composer --versionAbaixo está o resultado que você obterá.

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 hakaseDepois disso, faça login no usuário ‘hakase’.
su - hakaseEm seguida, instale o pacote Instalador Laravel usando o comando composer abaixo.
composer global require laravel/installerUma vez que toda a instalação esteja concluída, você obterá o seguinte resultado.

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 ~/.bashrcCole 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 $PATHAbaixo 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 blogAgora você terá o diretório do projeto Laravel ‘blog’.

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/storageComo resultado, o Laravel foi instalado usando o instalador Laravel, e você está pronto para configurar o host virtual Apache para seu 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 blogAgora você terá o novo diretório do projeto chamado ‘blog’.

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/storageComo resultado, você instalou o framework web Laravel usando o comando Composer.

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.confAltere 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.confDepois disso, teste a configuração do Apache, garantindo que não haja erro, e reinicie o serviço Apache.
apachectl configtest
systemctl restart apache2Como resultado, a configuração do host virtual Apache para Laravel foi concluída.

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.
Abaixo está o resultado que você obterá.

Como resultado, a instalação e configuração do Laravel com o servidor web Apache foi concluída com sucesso.
Referência
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.