Cómo instalar el framework PHP Laravel en Ubuntu 24.04

Laravel es un framework de aplicación web basado en PHP que se utiliza para construir aplicaciones web empresariales. Es un framework web gratuito y de código abierto que sigue la arquitectura de modelo-vista-controlador (MVC) y se basa en Symfony. Proporciona una sintaxis elegante que te permite crear aplicaciones con código limpio y es fácil de leer y entender.

Laravel es un framework web de nivel empresarial para construir aplicaciones web robustas y completas. Las aplicaciones de Laravel se pueden entregar rápidamente sin complicaciones, desde el proceso de desarrollo hasta la producción.

Esta guía te enseñará cómo instalar el framework web Laravel en el servidor Ubuntu 24.04. Instalarás Laravel con el LAMP Stack (Linux, Apache, MySQL/MariaDB y PHP) y el gestor de paquetes PHP Composer.

Requisitos previos

Antes de comenzar esta guía, asegúrate de tener lo siguiente:

• Un servidor Ubuntu 24.04.
• Un usuario no root con privilegios de administrador

Instalando LAMP Stack y Composer

Laravel es un popular framework web PHP para el desarrollo web moderno. Por lo tanto, debes asegurarte de que PHP y otras dependencias estén instaladas en tu servidor Ubuntu. En esta sección, instalarás Laravel con el LAMP Stack (Linux, Apache, MySQL/MariaDB y PHP) y Composer.

Antes de instalar el paquete, ejecuta el siguiente comando para actualizar tu repositorio de Ubuntu.

sudo apt update

Ahora ejecuta el siguiente comando para instalar las dependencias de Laravel, incluyendo el LAMP Stack (Linux, Apache, MySQL/MariaDB y PHP), Composer y 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

Escribe Y para continuar con la instalación.

Una vez finalizada la instalación, verifica el estado del servicio de Apache y MariaDB. Luego, verifica las versiones de PHP y Composer.

Verifica el estado del servicio de Apache con el siguiente comando. El servicio de Apache predeterminado en Ubuntu debería estar habilitado y funcionando automáticamente.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Salida:

Ahora verifica el servicio de MariaDB usando el comando a continuación. El servidor de MariaDB debería estar habilitado y funcionando en tu sistema Ubuntu.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Salida:

Por último, verifica las versiones de PHP y Composer usando el comando a continuación. Verás PHP 8.3 y Composer 2.7.1 instalados en tu sistema.

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

Opcional: Instalando Node.js y NPM (Gestor de Paquetes de Node.js)

Node.js y NPM son necesarios si estás utilizando Laravel con un motor de plantillas como Blade y JavaScript. En esta sección, instalarás tanto Node.js como NPM (Gestor de Paquetes de Node.js) a través del repositorio de Ubuntu.

Para instalar Node.js y NPM en tu sistema Ubuntu, ejecuta lo siguiente:

sudo apt install nodejs npm

Escribe Y para confirmar la instalación.

Cuando la instalación haya finalizado, ingresa el comando a continuación para verificar la versión de Node.js y NPM.

node --version  
npm --version

La siguiente salida muestra que Node.js 18 y NPM 9.5 están instalados.

Configurando PHP

Para ejecutar Laravel, debes asegurarte de que algunas extensiones de PHP estén habilitadas, como fileinfo, mbstring y openssl. Así que ahora cargarás esas extensiones de PHP modificando el archivo ‘php.ini’.

Usando el editor nano, edita el archivo de configuración PHP predeterminado ‘/etc/php/8.3/apache2/php.ini’.

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

Descomenta las siguientes líneas para habilitar las extensiones de PHP fileinfo, mbstring y openssl.

extension=fileinfo  
extension=mbstring  
extension=openssl

Guarda el archivo y sal del editor.

Ahora ejecuta el comando a continuación para reiniciar el servicio de Apache y aplicar los cambios en PHP.

sudo systemctl restart apache2

A continuación, verifica las extensiones de PHP fileinfo, mbstring y openssl con el siguiente comando. Si esas extensiones están habilitadas, se mostrará el nombre de cada extensión.

sudo php -m | grep 'fileinfo\|mbstring\|openssl'

Además, puedes verificar la lista de extensiones de PHP habilitadas a través de PHPINFO. Crea un nuevo archivo PHPINFO con el siguiente comando.

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

Luego, visita http://192.168.5.30/info.php. Verifica las extensiones fileinfo, mbstring y openssl para asegurarte de que esas extensiones estén habilitadas.

Configurando el servidor MariaDB

Después de configurar PHP, necesitas asegurar tu servidor MariaDB y crear una nueva base de datos y usuario para Laravel.

Ejecuta el comando ‘mariadb-secure-installation’ a continuación para asegurar tu servidor MariaDB. Ahora se te pedirá que configures el servidor MariaDB.

sudo mariadb-secure-installation

Cuando se te pida, ingresa Y para aplicar la nueva configuración o escribe N para rechazarla.

• La instalación predeterminada de MariaDB viene sin contraseña. Presiona ENTER cuando se te pida la contraseña.
• Ahora, ingresa Y para configurar la contraseña de root de MariaDB. Luego, escribe la nueva contraseña para MariaDB y repite la contraseña.
• Ingresa Y para eliminar el usuario anónimo de tu instalación de MariaDB.
• Ingresa Y nuevamente cuando se te pida deshabilitar el inicio de sesión remoto para el usuario root de MariaDB.
• Ingresa Y para eliminar la base de datos de prueba predeterminada de tu MariaDB.
• Por último, ingresa Y para recargar los privilegios de las tablas y aplicar los nuevos cambios.

Después de asegurar el servidor MariaDB, debes crear una nueva base de datos y usuario para tu proyecto Laravel.

Inicia sesión en el servidor MariaDB usando el comando a continuación. Ingresa tu contraseña de root de MariaDB cuando se te pida.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas para crear una nueva base de datos y usuario ‘laravelapp‘, con la contraseña ‘password‘.

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

A continuación, ejecuta la siguiente consulta para verificar los privilegios del usuario ‘laravelapp‘. Esto asegurará que tu usuario pueda acceder a la base de datos de Laravel ‘laravelapp‘.

SHOW GRANTS FOR laravelapp@localhost;

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

Instalando Laravel a través de Composer

Ahora que has configurado PHP y creado la base de datos y usuario de MySQL/MariaDB, puedes instalar Laravel. En esta sección, configurarás el directorio del proyecto, instalarás Laravel a través de Composer e integrarás Laravel con la base de datos MySQL/MariaDB.

Primero, ejecuta el comando a continuación para crear los directorios /var/www/.cache (para la caché de Composer), /var/www/.config (para la configuración adicional de Composer) y /var/www/laravelapp (para tu proyecto Laravel).

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

Ahora cambia la propiedad de los directorios /var/www/.cache, /var/www/.config y /var/www/laravelapp al usuario ‘www-data‘.

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

A continuación, ve al directorio /var/www/laravelapp e instala Laravel con el comando Composer a continuación.

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

La instalación de Laravel debería comenzar como lo siguiente:

Ahora abre el archivo ‘.env’ usando el comando del editor nano a continuación.

nano .env

Cambia el ‘ APP_URL ‘ predeterminado por tu nombre de dominio local. En este ejemplo, Laravel se ejecutará en el dominio ‘laravelapp.local’.

APP_URL=http://laravelapp.local

Cambia el ‘ DB_CONNECTION ‘ predeterminado a ‘ mysql ‘, descomenta y cambia los detalles de la base de datos con tu información.

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

Guarda y sal del archivo.

Por último, ejecuta el comando a continuación para migrar la base de datos para tu proyecto Laravel.

sudo -u www-data php artisan migrate

Salida de la migración de la base de datos de Laravel:

Configurando un host virtual para Laravel

En esta sección, configurarás el archivo de host virtual para Laravel. Asegúrate de tener el nombre de dominio local listo para tu desarrollo en Laravel.

Antes de crear un host virtual, habilita el módulo ‘ rewrite ‘ de Apache con el comando a continuación.

sudo a2enmod rewrite

Crea una nueva configuración de host virtual ‘/etc/apache2/sites-available/laravelapp.conf‘ con el editor nano.

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

Agrega la siguiente configuración y cambia la opción ServerName con tu nombre de dominio de 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  
  

Guarda el archivo y sal del editor.

Ahora ejecuta el comando a continuación para activar el host virtual ‘ laravelapp.conf ‘ y verificar la sintaxis de Apache. Si no hay errores, deberías ver la salida ‘ Syntax OK ‘.

sudo a2ensite laravelapp.conf  
sudo apachectl configtest

Reinicia el servicio de Apache para aplicar el nuevo archivo de host virtual de Laravel. Después de que Apache se reinicie, tu instalación de Laravel estará lista.

sudo systemctl restart apache2

Accediendo al Proyecto Laravel

En este punto, estás listo para acceder a tu instalación de Laravel a través del archivo ‘hosts’.

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

Agrega la dirección IP de tu servidor Ubuntu seguida del nombre de dominio de Laravel como sigue:

192.168.5.30 laravelapp.local

Guarda y sal del archivo.

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

Conclusión

¡Felicidades! Has completado la instalación de Laravel en Ubuntu 24.04. Tienes Laravel funcionando con el LAMP Stack (Linux, Apache, MySQL/MariaDB y PHP) y has aprendido el comando básico de Composer para crear un proyecto.