Como Instalar o Framework PHP Laravel com Apache 2 no Ubuntu 22.04

Laravel é um framework de aplicação web baseado em PHP para construir aplicações web empresariais. É um framework web gratuito e aberto que segue a arquitetura de modelo-visão-controlador (MVC) e é baseado no Symfony. Ele fornece uma sintaxe elegante que permite criar aplicações com código limpo e é fácil de ler e entender.

Laravel é um framework web de nível empresarial para construir aplicações web robustas e completas. As aplicações Laravel podem ser entregues rapidamente sem dores de cabeça, desde o processo de desenvolvimento até a produção.

Combinar o framework web Laravel com outro framework como React ou Vue permite criar um frontend bonito e interativo. Além disso, ele suporta múltiplos bancos de dados, incluindo MySQL, PostgreSQL, SQLite e SQL Server. O Laravel também fornece scaffolding para autenticação segura.

Neste tutorial, você aprenderá como instalar o Laravel na versão mais recente do Ubuntu 22.04 LTS. Isso também incluirá como configurar a pilha LAMP para o desenvolvimento do Laravel.

Pré-requisitos

• Uma máquina Ubuntu 22.04. Este exemplo usa o servidor Ubuntu.
• Um usuário não-root com privilégios de administrador sudo, ou você também pode usar o usuário root.

Instalando o Servidor Web Apache

Neste primeiro passo, você instalará o servidor web Apache2 no seu sistema Ubuntu. Neste exemplo, você estará executando o framework web Laravel com o servidor web Apache.

Agora execute o comando apt abaixo para atualizar e refrescar seu repositório Ubuntu.

sudo apt update

Em seguida, instale o pacote do servidor web Apache2 usando o seguinte comando.

sudo apt install apache2

Digite Y para confirmar e pressione ENTER para iniciar a instalação. A instalação do servidor web Apache começará.

Após a conclusão da instalação do Apache2, você precisará adicionar os serviços HTTP e HTTPS ao firewall UFW.

Execute o comando ufw abaixo para adicionar os serviços HTTP e HTTPS ao firewall UFW.

sudo ufw allow "Apache Full"

Por último, abra seu navegador web e insira o endereço IP do servidor na barra de endereços (por exemplo, http://192.168.10.15). Agora você deve ver a página padrão index.html do servidor web Apache2.

Instalando o PHP 8.1

Após a instalação do servidor web Apache, você instalará e configurará o PHP na máquina Ubuntu 22.04. O repositório padrão do Ubuntu 22.04 fornece o pacote PHP v8.1, que é bem suportado para o framework web Laravel.

Execute o comando apt abaixo para instalar os pacotes PHP para o framework web Laravel.

sudo apt install php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

Digite Y para confirmar a instalação e pressione ENTER para continuar. A instalação do PHP começará.

Agora, após a conclusão da instalação do PHP, edite a configuração php.ini usando o editor nano.

sudo nano /etc/php/8.1/apache2/php.ini

Descomente as seguintes opções para habilitar as extensões PHP fileinfo, openssl e mbstring.

extension=fileinfo  
extension=mbstring  
extension=openssl

Salve e feche o arquivo quando terminar.

Em seguida, reinicie o serviço Apache2 para aplicar as novas alterações à sua configuração PHP.

sudo systemctl restart apache2

Por último, teste e verifique sua configuração PHP executando o seguinte comando.

Verifique a versão do PHP instalada na sua máquina Ubuntu.

php --version

Na captura de tela abaixo, você pode ver que o PHP 8.1.2 está instalado na máquina Ubuntu.

Verifique todas as extensões habilitadas no seu ambiente PHP.

php -m

Instalando o Servidor MariaDB

Agora você instalou o servidor web Apache2 e os pacotes PHP. Agora você instalará e configurará o servidor de banco de dados MariaDB na máquina Ubuntu 22.04. Você também criará um novo banco de dados MariaDB e um usuário para o projeto Laravel.

Para instalar o banco de dados MariaDB na máquina Ubuntu, você pode executar o comando apt abaixo.

sudo apt install mariadb-server

Digite Y para confirmar e pressione ENTER para iniciar a instalação.

Após a conclusão da instalação do MariaDB, faça login no shell do MariaDB como usuário root usando o comando abaixo.

sudo mysql -u root -p

Agora execute as consultas abaixo do MariaDB para criar um novo banco de dados e usuário para o projeto Laravel. Neste exemplo, você criará o banco de dados laravelapp com o usuário laravel e a senha é “ password “.

CREATE DATABASE laravelapp;  
CREATE USER laravel@localhost IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON laravelapp.* TO laravel@localhost;  
FLUSH PRIVILEGES;

Agora execute a consulta “ EXIT “ para sair do shell do MariaDB. Você agora instalou o servidor de banco de dados MariaDB e criou um novo banco de dados e usuário para o projeto Laravel.

Instalando o Composer

Nesta seção, você instalará o Composer. É um gerenciador de pacotes para a linguagem de programação PHP, é como o pip no Python, o gem no Ruby, npm ou yarn para Node.js.

O framework web Laravel pode ser instalado de várias maneiras. Neste exemplo, você instalará o framework web Laravel usando o Composer.

Agora execute o comando abaixo para baixar o instalador do Composer.

curl -sS https://getcomposer.org/installer -o composer-setup.php

Agora execute o script do instalador “composer-setup.php” para instalar o Composer. Isso instalará o Composer no diretório /usr/local/bin.

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Abaixo está a captura de tela durante a instalação do Composer.

Agora, após a conclusão da instalação, execute o comando abaixo para verificar e validar a instalação do Composer.

Verifique a versão do Composer.

sudo -u www-data composer --version

Mostre o conteúdo de ajuda do Composer.

sudo -u www-data composer --help

Agora você está pronto para começar a instalação do Laravel.

Começando a Instalar o Laravel

Antes de começar a instalar o Laravel, vamos criar novos diretórios para o projeto Laravel.

Neste exemplo, você criará três diretórios, “.cache” para armazenar o cache dos pacotes PHP, o diretório “.config” para armazenar a configuração adicional do Composer, e o diretório “laravelapp” para o próprio projeto Laravel. Todos esses diretórios estarão disponíveis sob o diretório “ /var/www
“.

Execute o comando abaixo para criar novos diretórios para a instalação do Laravel.

mkdir -p /var/www/{.cache,.config,laravelapp}

Agora mude a propriedade dos diretórios Laravel e Composer para o usuário e grupo www-data.

sudo chown -R www-data:www-data /var/www/{.cache,.config,laravelapp}

Em seguida, vá para o diretório /var/www/laravelapp usando o seguinte comando.

cd /var/www/laravelapp/

Então instale o framework web Laravel usando o comando composer abaixo. O ponto no final do comando instalará o Laravel no diretório de trabalho atual /var/www/laravelapp.

sudo -u www-data composer create-project laravel/laravel .

Abaixo está a captura de tela do processo de instalação do Laravel.

E abaixo está o resultado após a conclusão da instalação do Laravel.

Em seguida, após a conclusão da instalação, edite o arquivo “.env” usando o editor nano. Esta configuração é a configuração principal do ambiente para o Laravel, que inclui a URL da instalação, detalhes do banco de dados, etc.

nano .env

Altere a configuração APP_URL com seu domínio para a instalação do Laravel. Neste exemplo, o Laravel estará rodando no nome de domínio laravelapp.howtoforge.local.

APP_URL=http://laravelapp.howtoforge.local

Agora altere os detalhes do banco de dados com sua configuração de banco de dados.

DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravel  
DB_PASSWORD=password

Salve e feche o arquivo quando terminar.

Você agora completou a instalação do framework web Laravel com o servidor de banco de dados MariaDB.

Configurando o Host Virtual do Apache

Agora é hora de configurar o host virtual do Apache2 para o framework web Laravel. Neste exemplo, o projeto Laravel estará rodando no domínio local laravelapp.howtoforge.local.

Crie um novo arquivo “ /etc/apache2/sites-available/laravel.conf “ usando o editor nano.

sudo nano /etc/apache2/sites-available/laravel.conf

Adicione a seguinte configuração ao arquivo. Se você estiver usando seu nome de domínio, pode alterar o domínio. Além disso, certifique-se de alterar o caminho do Document root para o projeto Laravel.

  
  
    ServerAdmin [email protected]  
    ServerName laravelapp.howtoforge.local  
    DocumentRoot /var/www/laravelapp/public  
  
      
            Options FollowSymLinks  
            AllowOverride None  
      
      
            AllowOverride All  
      
  
    ErrorLog ${APACHE_LOG_DIR}/error.log  
    CustomLog ${APACHE_LOG_DIR}/access.log combined  
  

Salve e feche o arquivo quando terminar.

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

sudo a2enmod rewrite  
sudo a2ensite laravel.conf

Agora verifique a configuração do Apache2 e certifique-se de que não há erro.

sudo apachectl configtest

Agora reinicie o serviço Apache2 para aplicar uma nova configuração de host virtual para o projeto Laravel usando o comando abaixo.

sudo systemctl restart apache2

Agora você completou a configuração do host virtual do Apache para o Laravel.

Na sua máquina, edite o arquivo /etc/hosts usando o editor nano/vim.

sudo nano /etc/hosts

Adicione a seguinte configuração. Certifique-se de alterar o nome do domínio e o endereço IP com seu servidor detalhado.

192.168.10.15 laravelapp.howtoforge.local

Salve e feche o arquivo quando terminar.

Por último, volte ao seu navegador web e insira a URL da instalação do laravel (ou seja, http://laravelapp.howtoforge.local) na barra de endereços. E você deve ver a página padrão de índice do framework web Laravel. Além disso, na parte inferior, você pode ver a versão do Laravel que você acabou de instalar e a versão do PHP que você está usando atualmente.

Conclusão

Parabéns! Você agora instalou com sucesso o framework web Laravel no Ubuntu 22.04. Você também aprendeu a configuração básica da pilha LAMP para o framework web Laravel.