Como Instalar o Framework PHP Laravel no Alma Linux 9

Laravel é um framework de aplicação web baseado em PHP que é usado para construir aplicações web robustas e empresariais. Ele segue a arquitetura model-view-controller (MVC) e é baseado no Symfony. Laravel suporta múltiplos bancos de dados, incluindo MySQL, PostgreSQL, SQLite e SQL Server. O Laravel também fornece scaffolding para autenticação segura.

Este tutorial mostrará como instalar o Laravel no servidor Alma Linux 9. Vamos guiá-lo pela instalação do Laravel com a pilha LAMP (Linux, Apache/Httpd, MariaDB e PHP) e Composer.

Pré-requisitos

Antes de prosseguir, certifique-se de que você possui o seguinte:

Um servidor Alma Linux 9.
Um usuário não-root com privilégios de administrador.
Um nome de domínio local.
Um SELinux em modo permissivo.

Instalando a Pilha LAMP e o Composer

Laravel é um dos frameworks PHP mais populares para construir aplicações web. Para instalar o Laravel, você precisa instalar dependências, incluindo a Pilha LAMP (Apache/Httpd, MariaDB e PHP) e o Composer. Atualmente, o Laravel requer PHP 8.3. Você deve instalar o PHP 8.3 através de um repositório de terceiros.

Primeiro, adicione os repositórios de terceiros EPEL e Remi ao seu servidor Alma Linux usando o comando abaixo. O repositório EPEL será usado para instalar pacotes como o Composer, enquanto o repositório Remi fornece várias versões do PHP para o Laravel.

sudo dnf install epel-release dnf-utils http://rpms.remirepo.net/enterprise/remi-release-9.rpm

add repo

Agora habilite o repositório PHP 8.3 via Remi usando o comando abaixo.

sudo dnf reset php -y  
sudo dnf module enable php:remi-8.3 -y

Em seguida, instale a Pilha LAMP (Apache/Httpd, MariaDB e PHP) e os pacotes do Composer com o seguinte comando. Digite y para confirmar a instalação.

sudo dnf install httpd mariadb-server composer php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

install deps

Uma vez que a instalação esteja completa, inicie e habilite o serviço httpd com o comando abaixo.

sudo systemctl start httpd  
sudo systemctl enable httpd

Em seguida, inicie e habilite o servidor MariaDB com o seguinte comando.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

Agora, verifique as versões do PHP e do Composer usando o comando abaixo. Você deve ver que o PHP 8.3 e o Composer 2.7.1 estão instalados.

php -v  
sudo -u apache composer -v

check php and composer

Por último, execute o comando abaixo para verificar seus módulos PHP. Certifique-se de que fileinfo, mbstring e openssl estão habilitados.

php -m

Configurando o MariaDB

Com o PHP configurado, você irá proteger o servidor MariaDB e criar um novo banco de dados e usuário para o Laravel. O servidor MariaDB fornece uma utilidade de instalação segura do MariaDB para proteger o servidor MariaDB e o cliente MariaDB para conectar-se ao servidor MariaDB via linha de comando.

Para proteger o servidor MariaDB, execute o comando abaixo e você será solicitado a algumas configurações do servidor MariaDB. Digite Y ou N para concordar ou discordar em aplicar novas alterações no MariaDB.

sudo mariadb-secure-installation

Abaixo estão algumas das configurações do servidor MariaDB que você será solicitado:

Mudar para autenticação unix_socket?. Digite n e pressione ENTER. O usuário root padrão do MariaDB já está protegido. Opcionalmente, você também pode habilitá-lo digitando y para sim.
Mudar a senha do root?. Digite y para confirmar e configurar sua nova senha de root do MariaDB.
Remover usuário anônimo?. Digite y para confirmar.
Proibir login remoto do root? Digite y para confirmar. Apenas conexões locais serão permitidas se você estiver usando o usuário root do MariaDB.
Remover o banco de dados de teste e o acesso a ele?. Digite y para confirmar e remover o banco de dados padrão ‘test’.
Por último, digite y novamente para recarregar todos os privilégios das tabelas no seu servidor MariaDB e aplicar novas alterações.

Após o MariaDB ser protegido, você criará um novo banco de dados e usuário para o Laravel através do cliente mariadb.

Faça login no servidor MariaDB com o comando do cliente mariadb abaixo. Digite sua senha de 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 para o Laravel. Neste exemplo, você criará um novo banco de dados laravelapp, um usuário laravel, com a senha p4ssw0rd. Ajuste os detalhes do banco de dados e do usuário abaixo com suas informações.

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

create database

Em seguida, execute a consulta abaixo para verificar os privilégios do usuário laravel. Certifique-se de que o usuário laravel pode acessar o banco de dados laravelapp.

SHOW PRIVILEGES FOR laravel@localhost;

Por último, digite quit para sair do servidor MariaDB.

show privileges

Criando o Projeto Laravel

Agora que você configurou tanto o PHP quanto o MariaDB, vamos baixar e instalar o Laravel no seu sistema. Você criará e configurará o diretório do projeto, e então baixará e instalará o projeto Laravel via Composer.

Crie novos diretórios para o projeto Laravel /var/www/laravelapp e diretórios adicionais .cache e .config para armazenar o cache e a configuração do Composer. Em seguida, mude a propriedade desses diretórios para o usuário apache.

mkdir -p /var/www/laravelapp /usr/share/httpd/.composer/{.cache,.config}  
sudo chown -R apache:apache /var/www/laravelapp /usr/share/httpd/.composer

Vá para o diretório /var/www/laravelapp e execute o comando do composer abaixo para baixar e instalar o Laravel.

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

O processo de download deve ser assim:

install Laravel

Uma vez que o Laravel esteja baixado, abra o arquivo .env usando o seguinte comando do editor nano.

nano .env

Altere o APP_URL com seu nome de domínio local, em seguida, altere os detalhes do banco de dados com as informações do seu banco de dados MariaDB.

APP_URL=http://dev.hwdomain.local  
DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravel  
DB_PASSWORD=password

Quando terminar, salve o arquivo e saia.

Agora execute o comando abaixo para migrar o banco de dados e preencher suas tabelas com novos dados de exemplo.

sudo -u apache php artisan migrate  
sudo -u apache php artisan db:seed

migrate database

Configurando o Host Virtual Httpd

Após instalar o Laravel, você criará uma nova configuração de host virtual Httpd que o Laravel usará. Para isso, certifique-se de ter um nome de domínio local ou qualquer domínio aleatório que desejar. Você pode configurar esse domínio mais tarde.

Crie uma nova configuração de host virtual httpd /etc/httpd/conf.d/laravel.conf usando o seguinte comando do editor nano.

sudo nano /etc/httpd/conf.d/laravel.conf

Insira a seguinte configuração e certifique-se de alterar a opção ServerName com seu nome de domínio Laravel.

  
  
 ServerAdmin [email protected]  
 ServerName dev.hwdomain.local  
 DocumentRoot /var/www/laravelapp/public  
  
   
 Options FollowSymLinks  
 AllowOverride None  
   
   
 AllowOverride All  
   
  
 ErrorLog /var/log/httpd/laravel-error.log  
 CustomLog /var/log/httpd/laravel-access.log combined

Salve o arquivo e saia do editor.

Agora execute o comando abaixo para verificar sua configuração httpd. Se você tiver a sintaxe httpd correta, deverá obter uma saída Syntax OK.

sudo apachectl configtest

Por último, reinicie o serviço httpd para aplicar sua nova configuração de host virtual para o Laravel.

sudo systemctl restart httpd

setup vhost

Configurando o Firewalld

Antes de acessar sua instalação do Laravel, você deve abrir as portas HTTP e HTTPS no seu sistema, o que pode ser feito via Firewalld.

Abra o tráfego HTTP e HTTPS para o seu servidor Alma Linux com o comando abaixo.

sudo firewall-cmd --add-service=http --permanent  
sudo firewall-cmd --add-service=https --permanent

Agora recarregue o firewalld para aplicar as alterações.

sudo firewall-cmd --reload

Por último, verifique as regras da lista do firewalld usando o seguinte comando. Você verá os serviços HTTP e HTTPS adicionados ao firewalld.

sudo firewall-cmd --list-all

setup firewalld

Acessando o Laravel do Computador Local

Para configurar um nome de domínio local para sua instalação do Laravel, use o seguinte:

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

Insira a configuração abaixo e certifique-se de alterar o endereço IP e o nome do domínio com suas informações.

192.168.5.60 dev.hwdomain.local

Salve e saia do arquivo.

Agora abra seu navegador e visite sua instalação do Laravel http://dev.hwdomain.local/. Se sua instalação for bem-sucedida, você deverá ver a seguinte página de índice do Laravel.

laravel

Conclusão

Parabéns! Você completou a instalação do Laravel no Alma Linux 9 com a Pilha LAMP (Linux, Apache/Httpd, MariaDB e PHP) e Composer. Você também configurou o firewalld para abrir as portas HTTP e HTTPS, e também configurou o nome de domínio local para seu desenvolvimento Laravel via arquivo /etc/hosts ou arquivo C:\Windows\System32\drivers\etc\hosts.