Como Instalar o Framework PHP Laravel no Ubuntu 24.04

Laravel é um framework de aplicação web baseado em PHP que é usado para construir aplicações web empresariais. É um framework web gratuito e aberto que segue a arquitetura model-view-controller (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.

Este guia ensinará você a instalar o framework web Laravel no servidor Ubuntu 24.04. Você instalará o Laravel com o LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP) e o gerenciador de pacotes PHP Composer.

Pré-requisitos

Antes de começar este guia, certifique-se de que você possui o seguinte:

• Um servidor Ubuntu 24.04.
• Um usuário não-root com privilégios de administrador

Instalando LAMP Stack e Composer

Laravel é um popular framework PHP para desenvolvimento web moderno. Portanto, você deve garantir que o PHP e outras dependências estejam instaladas em seu servidor Ubuntu. Nesta seção, você instalará o Laravel com o LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP) e o Composer.

Antes de instalar o pacote, execute o seguinte comando para atualizar seu repositório Ubuntu.

sudo apt update

Agora execute o seguinte comando para instalar as dependências do Laravel, incluindo o LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP), Composer e Git.

sudo apt install apache2 mariadb-server php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip composer git

Digite Y para prosseguir com a instalação.

Uma vez que a instalação esteja concluída, verifique o status dos serviços Apache e MariaDB. Em seguida, verifique as versões do PHP e do Composer.

Verifique o status do serviço Apache com o seguinte comando. O serviço Apache padrão no Ubuntu deve estar habilitado e em execução automaticamente.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Saída:

Agora verifique o serviço MariaDB usando o comando abaixo. O servidor MariaDB deve estar habilitado e em execução em seu sistema Ubuntu.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Saída:

Por fim, verifique as versões do PHP e do Composer usando o comando abaixo. Você verá o PHP 8.3 e o Composer 2.7.1 instalados em seu sistema.

php -v  
sudo -u www-data composer -v

Opcional: Instalando Node.js e NPM (Gerenciador de Pacotes Node.js)

Node.js e NPM são necessários se você estiver usando o Laravel com um mecanismo de template como Blade e JavaScript. Nesta seção, você instalará tanto o Node.js quanto o NPM (Gerenciador de Pacotes Node.js) através do repositório Ubuntu.

Para instalar o Node.js e o NPM em seu sistema Ubuntu, execute o seguinte:

sudo apt install nodejs npm

Digite Y para confirmar a instalação.

Quando a instalação estiver concluída, insira o comando abaixo para verificar a versão do Node.js e do NPM.

node --version  
npm --version

A saída a seguir mostra que o Node.js 18 e o NPM 9.5 estão instalados.

Configurando o PHP

Para executar o Laravel, você deve garantir que algumas extensões do PHP estejam habilitadas, como fileinfo, mbstring e openssl. Portanto, agora você carrega essas extensões PHP modificando o arquivo ‘php.ini’.

Usando o editor nano, edite o arquivo de configuração PHP padrão ‘/etc/php/8.3/apache2/php.ini’.

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

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

extension=fileinfo  
extension=mbstring  
extension=openssl

Salve o arquivo e saia do editor.

Agora execute o comando abaixo para reiniciar o serviço Apache e aplicar as alterações no PHP.

sudo systemctl restart apache2

Em seguida, verifique as extensões PHP fileinfo, mbstring e openssl com o seguinte comando. Se essas extensões estiverem habilitadas, o nome de cada extensão será exibido.

sudo php -m | grep 'fileinfomstringolenssl'

Além disso, você pode verificar a lista de extensões PHP habilitadas via PHPINFO. Crie um novo arquivo PHPINFO com o seguinte comando.

echo "" > /var/www/html/info.php

Em seguida, visite http://192.168.5.30/info.php. Verifique as extensões fileinfo, mbstring e openssl para garantir que essas extensões estejam habilitadas.

Configurando o servidor MariaDB

Após configurar o PHP, você precisa proteger seu servidor MariaDB e criar um novo banco de dados e usuário para o Laravel.

Execute o comando ‘mariadb-secure-installation’ abaixo para proteger seu servidor MariaDB. Agora você será solicitado a configurar o servidor MariaDB.

sudo mariadb-secure-installation

Quando solicitado, insira Y para aplicar a nova configuração ou digite N para rejeitá-la.

• A instalação padrão do MariaDB vem sem senha. Pressione ENTER quando solicitado pela senha.
• Agora, insira Y para configurar a senha root do MariaDB. Em seguida, digite a nova senha para o MariaDB e repita a senha.
• Insira Y para remover o usuário anônimo da sua instalação do MariaDB.
• Insira Y novamente quando solicitado para desabilitar o login remoto para o usuário root do MariaDB.
• Insira Y para remover o banco de dados de teste padrão do seu MariaDB.
• Por fim, insira Y para recarregar os privilégios da tabela e aplicar novas alterações.

Após proteger o servidor MariaDB, você deve criar um novo banco de dados e usuário para seu projeto Laravel.

Faça login no servidor MariaDB usando o comando abaixo. Insira sua senha root do MariaDB quando solicitado.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados e usuário ‘laravelapp‘, com a senha ‘password‘.

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

Em seguida, execute a seguinte consulta para verificar os privilégios do usuário ‘laravelapp‘. Isso garantirá que seu usuário possa acessar o banco de dados Laravel ‘laravelapp‘.

SHOW GRANTS FOR laravelapp@localhost;

Por fim, digite quit para sair do servidor MariaDB.

Instalando o Laravel via Composer

Agora que você configurou o PHP e criou o banco de dados MySQL/MariaDB e o usuário, você pode instalar o Laravel. Nesta seção, você configurará o diretório do projeto, instalará o Laravel via Composer e integrará o Laravel com o banco de dados MySQL/MariaDB.

Primeiro, execute o comando abaixo para criar os diretórios /var/www/.cache (para cache do Composer), /var/www/.config (para configuração adicional do Composer) e /var/www/laravelapp (para seu projeto Laravel).

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

Agora mude a propriedade dos diretórios /var/www/.cache, /var/www/.config e /var/www/laravelapp para o usuário ‘www-data‘.

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

Em seguida, vá para o diretório /var/www/laravelapp e instale o Laravel com o comando Composer abaixo.

cd /var/www/laravelapp/  
sudo -u www-data composer create-project laravel/laravel .

A instalação do Laravel deve começar como a seguinte:

Agora abra o arquivo ‘.env’ usando o comando do editor nano abaixo.

nano .env

Altere o ‘ APP_URL ‘ padrão para o seu nome de domínio local. Neste exemplo, o Laravel será executado no domínio ‘laravelapp.local’.

APP_URL=http://laravelapp.local

Altere o ‘ DB_CONNECTION ‘ padrão para ‘ mysql ‘, descomente e altere os detalhes do banco de dados com suas informações.

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

Salve e saia do arquivo.

Por fim, execute o comando abaixo para migrar o banco de dados para seu projeto Laravel.

sudo -u www-data php artisan migrate

Saída da migração do banco de dados Laravel:

Configurando um host virtual para Laravel

Nesta seção, você configurará o arquivo de host virtual para o Laravel. Certifique-se de que você tenha o nome de domínio local pronto para seu desenvolvimento Laravel.

Antes de criar um host virtual, habilite o módulo ‘ rewrite ‘ do Apache com o comando abaixo.

sudo a2enmod rewrite

Crie uma nova configuração de host virtual ‘/etc/apache2/sites-available/laravelapp.conf‘ com o editor nano.

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

Adicione a seguinte configuração e altere a opção ServerName para o seu nome de domínio Laravel, como ‘laravelapp.local‘.

  
  
 ServerAdmin [email protected]  
 ServerName laravelapp.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 o arquivo e saia do editor.

Agora execute o comando abaixo para ativar o host virtual ‘ laravelapp.conf ‘ e verificar sua sintaxe do Apache. Se não houver erro, você deve ver a saída ‘ Syntax OK ‘.

sudo a2ensite laravelapp.conf  
sudo apachectl configtest

Reinicie o serviço Apache para aplicar o novo arquivo de host virtual do Laravel. Após o Apache reiniciar, sua instalação do Laravel estará pronta.

sudo systemctl restart apache2

Acessando o Projeto Laravel

Neste ponto, você está pronto para acessar sua instalação do Laravel através do arquivo ‘hosts’.

Para usuários Linux ou MacOS, modifique o arquivo ‘ /etc/hosts ‘ com privilégios de root. Para usuários do Windows, abra o arquivo ‘ C:\Windows\System32\drivers\etc\hosts ‘ como administrador.

Adicione o endereço IP do seu servidor Ubuntu seguido pelo nome de domínio do Laravel como o seguinte:

192.168.5.30 laravelapp.local

Salve e saia do arquivo.

Agora visite http://laravelapp.local/ com seu navegador web. Se sua instalação do Laravel for bem-sucedida, você deve obter a seguinte página:

Conclusão

Parabéns! Você completou a instalação do Laravel no Ubuntu 24.04. Você tem o Laravel em execução com o LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP) e aprendeu o comando básico do Composer para criar um projeto.