Cómo instalar el marco PHP Laravel en Alma Linux 9

Laravel es un marco de aplicación web basado en PHP que se utiliza para construir aplicaciones web empresariales y robustas de pila completa. Sigue la arquitectura de modelo-vista-controlador (MVC) y se basa en Symfony. Laravel admite múltiples bases de datos, incluidas MySQL, PostgreSQL, SQLite y SQL Server. Laravel también proporciona andamiaje para una autenticación segura.

Este tutorial te mostrará cómo instalar Laravel en el servidor Alma Linux 9. Te guiaremos a través de la instalación de Laravel con LAMP Stack (Linux, Apache/Httpd, MariaDB y PHP) y Composer.

Requisitos previos

Antes de continuar, asegúrate de tener lo siguiente:

Un servidor Alma Linux 9.
Un usuario no root con privilegios de administrador.
Un nombre de dominio local.
Un SELinux en modo permisivo.

Instalando LAMP Stack y Composer

Laravel es uno de los marcos web PHP más populares para construir aplicaciones web. Para instalar Laravel, necesitas instalar dependencias, incluido el LAMP Stack (Apache/Httpd, MariaDb y PHP) y Composer. Actualmente, Laravel requiere PHP 8.3. Debes instalar PHP 8.3 a través de un repositorio de terceros.

Primero, agrega el repositorio de terceros EPEL y Remi a tu servidor Alma Linux usando el siguiente comando. El repositorio EPEL se utilizará para instalar paquetes como Composer, mientras que el repositorio Remi proporciona múltiples versiones de PHP para Laravel.

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

add repo

Ahora habilita el repositorio PHP 8.3 a través de Remi usando el siguiente comando.

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

A continuación, instala el LAMP Stack (Apache/Httpd, MariaDB y PHP) y los paquetes de Composer con el siguiente comando. Ingresa y para confirmar con la instalación.

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

install deps

Una vez que la instalación esté completa, inicia y habilita el servicio httpd con el siguiente comando.

sudo systemctl start httpd  
sudo systemctl enable httpd

Luego, inicia y habilita el servidor MariaDB con el siguiente comando.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

Ahora, verifica las versiones de PHP y Composer usando el siguiente comando. Deberías ver que PHP 8.3 y Composer 2.7.1 están instalados.

php -v  
sudo -u apache composer -v

check php and composer

Por último, ejecuta el siguiente comando para verificar tus módulos de PHP. Asegúrate de que fileinfo, mbstring y openssl estén habilitados.

php -m

Configurando MariaDB

Con PHP configurado, asegurarás el servidor MariaDB y crearás una nueva base de datos y usuario para Laravel. El servidor MariaDB proporciona una utilidad de instalación segura de MariaDB para asegurar el servidor MariaDB y el cliente de MariaDB para conectarse al servidor MariaDB a través de la línea de comandos.

Para asegurar el servidor MariaDB, ejecuta el siguiente comando y se te pedirá algunas de las configuraciones del servidor MariaDB. Ingresa Y o N para aceptar o rechazar la aplicación de nuevos cambios en MariaDB.

sudo mariadb-secure-installation

A continuación se presentan algunas de las configuraciones del servidor MariaDB que se te preguntarán:

¿Cambiar a la autenticación unix_socket? Ingresa n y presiona ENTER. El usuario root predeterminado de MariaDB ya está protegido. Opcionalmente, también puedes habilitarlo escribiendo y para sí.
¿Cambiar la contraseña de root? Ingresa y para confirmar y configurar tu nueva contraseña de root de MariaDB.
¿Eliminar usuario anónimo? Ingresa y para confirmar.
¿Deshabilitar el inicio de sesión remoto de root? Ingresa y para confirmar. Solo se permitirá la conexión local si estás utilizando el usuario root de MariaDB.
¿Eliminar la base de datos de prueba y el acceso a ella? Ingresa y para confirmar y eliminar la base de datos predeterminada ‘test’.
Por último, ingresa y nuevamente para recargar todos los privilegios de las tablas en tu servidor MariaDB y aplicar nuevos cambios.

Después de asegurar MariaDB, crearás una nueva base de datos y usuario para Laravel a través del cliente mariadb.

Inicia sesión en el servidor MariaDB con el comando del cliente mariadb a continuación. Ingresa tu contraseña de root de MariaDB cuando se te solicite.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas para crear una nueva base de datos y usuario para Laravel. En este ejemplo, crearás una nueva base de datos laravelapp, un usuario laravel, con la contraseña p4ssw0rd. Ajusta los detalles de la base de datos y el usuario a continuación con tu información.

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

create database

A continuación, ejecuta la consulta a continuación para verificar los privilegios del usuario laravel. Asegúrate de que el usuario laravel pueda acceder a la base de datos laravelapp.

SHOW PRIVILEGES FOR laravel@localhost;

Por último, escribe quit para salir del servidor MariaDB.

show privileges

Creando el Proyecto Laravel

Ahora que has configurado tanto PHP como MariaDB, descarguemos e instalemos Laravel en tu sistema. Crearás y configurarás el directorio del proyecto, luego descargarás e instalarás el proyecto Laravel a través de Composer.

Crea nuevos directorios para el proyecto Laravel /var/www/laravelapp y directorios adicionales .cache y .config para almacenar la caché y la configuración de Composer. Luego, cambia la propiedad de esos directorios al usuario apache.

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

Ve al directorio /var/www/laravelapp y ejecuta el comando composer a continuación para descargar e instalar Laravel.

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

El proceso de descarga debería ser así:

install Laravel

Una vez que Laravel esté descargado, abre el archivo .env usando el siguiente comando del editor nano.

nano .env

Cambia el APP_URL con tu nombre de dominio local, luego cambia los detalles de la base de datos con tu información de base de datos de 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

Cuando termines, guarda el archivo y sal.

Ahora ejecuta el siguiente comando para migrar la base de datos y llenar tus tablas con nuevos datos de muestra.

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

migrate database

Configurando el Host Virtual de Httpd

Después de instalar Laravel, crearás una nueva configuración de host virtual de Httpd que Laravel utilizará. Para esto, asegúrate de tener un nombre de dominio local o cualquier dominio aleatorio que desees. Puedes configurar este dominio más tarde.

Crea una nueva configuración de host virtual httpd /etc/httpd/conf.d/laravel.conf usando el siguiente comando del editor nano.

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

Inserta la siguiente configuración y asegúrate de cambiar la opción ServerName con tu nombre de dominio de 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

Guarda el archivo y sal del editor.

Ahora ejecuta el siguiente comando para verificar tu configuración httpd. Si tienes la sintaxis httpd correcta, deberías obtener una salida Syntax OK.

sudo apachectl configtest

Por último, reinicia el servicio httpd para aplicar tu nueva configuración de host virtual para Laravel.

sudo systemctl restart httpd

setup vhost

Configurando Firewalld

Antes de acceder a tu instalación de Laravel, debes abrir ambos puertos HTTP y HTTPS en tu sistema, lo que se puede hacer a través de Firewalld.

Abre tanto el tráfico HTTP como HTTPS a tu servidor Alma Linux con el siguiente comando.

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

Ahora recarga firewalld para aplicar los cambios.

sudo firewall-cmd --reload

Por último, verifica las reglas de la lista de firewalld usando el siguiente comando. Verás que ambos servicios HTTP y HTTPS se han agregado a firewalld.

sudo firewall-cmd --list-all

setup firewalld

Accediendo a Laravel desde la Computadora Local

Para configurar un nombre de dominio local para tu instalación de Laravel, usa lo siguiente:

Para usuarios de Windows, modifica el archivo C:\Windows\System32\drivers\etc\hosts como administrador.
Para usuarios de Linux y Mac, abre el archivo /etc/hosts con privilegios de root.

Inserta la configuración a continuación y asegúrate de cambiar la dirección IP y el nombre de dominio con tu información.

192.168.5.60 dev.hwdomain.local

Guarda y sal del archivo.

Ahora abre tu navegador web y visita tu instalación de Laravel http://dev.hwdomain.local/. Si tu instalación es exitosa, deberías obtener la siguiente página de índice de Laravel.

laravel

Conclusión

¡Felicidades! Has completado la instalación de Laravel en Alma Linux 9 con el LAMP Stack (Linux, Apache/Httpd, MariaDB y PHP) y Composer. También configuraste firewalld para abrir ambos puertos HTTP y HTTPS, y luego también configuraste el nombre de dominio local para tu desarrollo de Laravel a través del archivo /etc/hosts o el archivo C:\Windows\System32\drivers\etc\hosts.