Cómo Instalar Laravel PHP Framework en Ubuntu 24.04

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

Laravel es un framework web de nivel empresarial para crear aplicaciones web empresariales y robustas de pila completa. Las aplicaciones Laravel pueden entregarse rápidamente sin quebraderos de cabeza, desde el proceso de desarrollo hasta la producción.

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

Requisitos previos

Antes de empezar esta guía, asegúrate de que tienes lo siguiente:

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

Instalación de LAMP Stack y Composer

Laravel es un popular framework web PHP para el desarrollo web moderno. Así que debes asegurarte de que PHP y otras dependencias están instaladas en tu servidor Ubuntu. En esta sección, instalarás Laravel con la Pila LAMP (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 la Pila LAMP (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 proceder con la instalación.

Una vez finalizada la instalación, comprueba el estado de los servicios de Apache y MariaDB. A continuación, comprueba las versiones de PHP y Composer.

Comprueba el estado del servicio Apache con el siguiente comando. El servicio Apache por defecto en Ubuntu debería estar activado y ejecutándose automáticamente.

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Salida:

Comprueba ahora el servicio MariaDB con el siguiente comando. El servidor MariaDB debería estar habilitado y ejecutándose en tu sistema Ubuntu.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Resultado:

Por último, comprueba las versiones de PHP y Composer utilizando el siguiente comando. Verás que PHP 8.3 y Composer 2.7.1 están instalados en tu sistema.

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

Opcional: Instalar Node.js y NPM (Node.js Package Manager)

Node.js y NPM son necesarios si utilizas Laravel con un motor de plantillas como Blade y JavaScript. En esta sección, instalarás tanto Node.js como NPM (Node.js Package Manager) 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 finalice la instalación, introduce el siguiente comando para comprobar 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.

Configurar PHP

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

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

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

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

extension=fileinfo
extension=mbstring
extension=openssl

Guarda el archivo y sal del editor.

Ahora ejecuta el siguiente comando para reiniciar el servicio Apache y aplicar los cambios en PHP.

sudo systemctl restart apache2

A continuación, verifica las extensiones PHP fileinfo , mbstring y opens sl con el siguiente comando. Si esas extensiones están activadas, se mostrará el nombre de cada una de ellas.

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

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

echo "<?php phpinfo(); ?>" > /var/www/html/info.php

A continuación, visita http://192.168.5.30/info.php. Comprueba las extensiones fileinfo, mbstring y openssl para asegurarte de que están habilitadas.

Configurar el servidor MariaDB

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

Ejecuta el siguiente comando ‘mariadb-secure-installation’ para asegurar tu servidor MariaDB. Ahora se te pedirá la configuración del servidor MariaDB.

sudo mariadb-secure-installation

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

• La instalación por defecto de MariaDB viene sin contraseña, pulsa ENTER cuando se te pida la contraseña.
• Ahora introduce Y para configurar la contraseña raíz de MariaDB. A continuación, escribe la nueva contraseña para MariaDB y repite la contraseña.
• Introduce Y para eliminar el usuario anónimo de tu instalación de MariaDB.
• Vuelve a introducir Y cuando se te pida para desactivar el inicio de sesión remoto para el usuario raíz de MariaDB.
• Introduce Y para eliminar la prueba de base de datos por defecto de tu MariaDB.
• Por último, introduce Y para recargar los privilegios de las tablas y aplicar los nuevos cambios.

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

Inicia sesión en el servidor MariaDB con el siguiente comando. Introduce tu contraseña de root de MariaDB cuando te lo pida.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas para crear una nueva base de datos y un nuevo 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 garantizará que tu usuario pueda acceder a la base de datos Laravel‘laravelapp‘.

SHOW GRANTS FOR laravelapp@localhost;

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

Instalar Laravel a través de Composer

Ahora que has configurado PHP y creado la base de datos MySQL/MariaDB y el usuario, 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.

En primer lugar, ejecuta el siguiente comando 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 siguiente comando de Composer.

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

La instalación de Laravel debería comenzar como se muestra a continuación:

Ahora abre el archivo ‘.env’ utilizando el comando editor nano de abajo.

nano .env

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

APP_URL=http://laravelapp.local

Cambia la‘DB_CONNECTION‘ por defecto 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 el archivo y sal de él.

Por último, ejecuta el siguiente comando para migrar la base de datos de tu proyecto Laravel.

sudo -u www-data php artisan migrate

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

Configurar un host virtual para Laravel

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

Antes de crear un host virtual, habilita el módulo ‘rewrite’ de Apache con el siguiente comando.

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

Añade la siguiente configuración y cambia la opción ServerName por el nombre de tu dominio Laravel, por ejemplo‘laravelapp.local‘.

<VirtualHost *:80>
ServerAdmin [email protected]
ServerName laravelapp.local
DocumentRoot /var/www/laravelapp/public

<Directory />
Options FollowSymLinks
AllowOverride None
</Directory>
<Directory /var/www/laravelapp>
AllowOverride All
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Guarda el archivo y sal del editor.

Ahora ejecuta el siguiente comando para activar el host virtual‘laravelapp.conf‘ y verifica la sintaxis de tu Apache. Si no hay errores, deberías ver la salida‘Sintaxis OK‘.

sudo a2ensite laravelapp.conf
sudo apachectl configtest

Reinicia el servicio Apache para aplicar el nuevo archivo de host virtual de Laravel. Una vez reiniciado Apache, tu instalación de Laravel estará lista.

sudo systemctl restart apache2

Acceder al Proyecto Laravel

En este punto, estás listo para acceder a tu instalación 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.

Añade la dirección IP de tu servidor Ubuntu seguida del nombre de dominio de Laravel como se indica a continuación:

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 se ha realizado correctamente, deberías obtener la siguiente página:

Conclusión

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