Cómo instalar el framework PHP Laravel con Apache 2 en Ubuntu 22.04

Laravel es un framework de aplicación web basado en PHP 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 permite crear aplicaciones con código limpio y fácil de leer y entender.

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

Combinar el framework web Laravel con otro framework como React o Vue te permite crear un frontend hermoso e interactivo. Además, admite múltiples bases de datos, incluyendo MySQL, PostgreSQL, SQLite y SQL Server. Laravel también proporciona andamiaje para una autenticación segura.

En este tutorial, aprenderás cómo instalar Laravel en el último Ubuntu 22.04 LTS. Esto también incluirá cómo configurar la pila LAMP para el desarrollo de Laravel.

Requisitos previos

• Una máquina Ubuntu 22.04. Este ejemplo utiliza el servidor Ubuntu.
• Un usuario no root con privilegios de administrador sudo, o también puedes usar el usuario root.

Instalando el servidor web Apache

En este primer paso, instalarás el servidor web Apache2 en tu sistema Ubuntu. En este ejemplo, estarás ejecutando el framework web Laravel con el servidor web Apache.

Ahora ejecuta el comando apt a continuación para actualizar y refrescar tu repositorio de Ubuntu.

sudo apt update

A continuación, instala el paquete del servidor web Apache2 usando el siguiente comando.

sudo apt install apache2

Ingresa Y para confirmar y presiona ENTER para comenzar la instalación. La instalación del servidor web Apache comenzará.

Después de que se complete la instalación de Apache2, necesitarás agregar los servicios HTTP y HTTPS al firewall UFW.

Ejecuta el comando ufw a continuación para agregar los servicios HTTP y HTTPS al firewall UFW.

sudo ufw allow "Apache Full"

Por último, abre tu navegador web e ingresa la dirección IP del servidor en la barra de direcciones (por ejemplo, http://192.168.10.15). Ahora deberías ver la página index.html predeterminada del servidor web Apache2.

Instalando PHP 8.1

Después de la instalación del servidor web Apache, instalarás y configurarás PHP en la máquina Ubuntu 22.04. El repositorio predeterminado de Ubuntu 22.04 proporciona el paquete PHP v8.1, y está bien soportado para el framework web Laravel.

Ejecuta el comando apt a continuación para instalar los paquetes PHP para el framework web Laravel.

sudo apt install php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

Ingresa Y para confirmar la instalación y presiona ENTER para continuar. La instalación de PHP comenzará.

Ahora, después de que se complete la instalación de PHP, edita la configuración php.ini usando el editor nano.

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

Descomenta las siguientes opciones para habilitar las extensiones de PHP fileinfo, openssl y mbstring.

extension=fileinfo  
extension=mbstring  
extension=openssl

Guarda y cierra el archivo cuando hayas terminado.

A continuación, reinicia el servicio Apache2 para aplicar los nuevos cambios a tu configuración de PHP.

sudo systemctl restart apache2

Por último, prueba y verifica tu configuración de PHP ejecutando el siguiente comando.

Verifica la versión de PHP instalada en tu máquina Ubuntu.

php --version

En la captura de pantalla a continuación, puedes ver que PHP 8.1.2 está instalado en la máquina Ubuntu.

Verifica todas las extensiones habilitadas en tu entorno PHP.

php -m

Instalando el servidor MariaDB

Ahora has instalado el servidor web Apache2 y los paquetes PHP. Ahora instalarás y configurarás el servidor de base de datos MariaDB en la máquina Ubuntu 22.04. También crearás una nueva base de datos MariaDB y un usuario para el proyecto Laravel.

Para instalar la base de datos MariaDB en la máquina Ubuntu, puedes ejecutar el comando apt a continuación.

sudo apt install mariadb-server

Ingresa Y para confirmar y presiona ENTER para comenzar la instalación.

Después de que se complete la instalación de MariaDB, inicia sesión en el shell de MariaDB como el usuario root usando el siguiente comando.

sudo mysql -u root -p

Ahora ejecuta las siguientes consultas de MariaDB para crear una nueva base de datos y un usuario para el proyecto Laravel. En este ejemplo, crearás la base de datos laravelapp con el usuario laravel y la contraseña es “ password “.

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

Ahora ejecuta la consulta “ EXIT “ para cerrar sesión en el shell de MariaDB. Ahora has instalado el servidor de base de datos MariaDB y creado una nueva base de datos y usuario para el proyecto Laravel.

Instalando Composer

En esta sección, estarás instalando Composer. Es un gestor de paquetes para el lenguaje de programación PHP, es como pip en Python, el gem en Ruby, npm o yarn para Node.js.

El framework web Laravel se puede instalar de muchas maneras. En este ejemplo, estarás instalando el framework web Laravel usando Composer.

Ahora ejecuta el siguiente comando para descargar el instalador de Composer.

curl -sS https://getcomposer.org/installer -o composer-setup.php

Ahora ejecuta el script del instalador “composer-setup.php” para instalar Composer. Esto instalará Composer en el directorio /usr/local/bin.

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

A continuación se muestra la captura de pantalla al instalar Composer.

Ahora, después de que se complete la instalación, ejecuta el siguiente comando para verificar la instalación de Composer.

Verifica la versión de Composer.

sudo -u www-data composer --version

Muestra el contenido de ayuda de Composer.

sudo -u www-data composer --help

Ahora estás listo para comenzar la instalación de Laravel.

Comenzar a instalar Laravel

Antes de comenzar a instalar Laravel, vamos a crear nuevos directorios para el proyecto Laravel.

En este ejemplo, crearás tres directorios, “.cache” para almacenar la caché de los paquetes PHP, el directorio “.config” para almacenar la configuración adicional de Composer, y el directorio “laravelapp” para el propio proyecto Laravel. Todos esos directorios estarán disponibles bajo el directorio “ /var/www
“.

Ejecuta el siguiente comando para crear nuevos directorios para la instalación de Laravel.

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

Ahora cambia la propiedad de los directorios de Laravel y Composer al usuario y grupo www-data.

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

A continuación, muévete al directorio /var/www/laravelapp usando el siguiente comando.

cd /var/www/laravelapp/

Luego instala el framework web Laravel usando el comando composer a continuación. El punto al final del comando instalará Laravel en el directorio de trabajo actual /var/www/laravelapp.

sudo -u www-data composer create-project laravel/laravel .

A continuación se muestra la captura de pantalla del proceso de instalación de Laravel.

Y a continuación se muestra el resultado después de que se complete la instalación de Laravel.

A continuación, después de que se complete la instalación, edita el archivo “.env” usando el editor nano. Esta configuración es la configuración principal del entorno para Laravel, que incluye la URL de la instalación, detalles de la base de datos, etc.

nano .env

Cambia la configuración APP_URL con tu dominio para la instalación de Laravel. En este ejemplo, Laravel se ejecutará en el nombre de dominio laravelapp.howtoforge.local.

APP_URL=http://laravelapp.howtoforge.local

Ahora cambia los detalles de la base de datos con tu configuración de base de datos.

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

Guarda y cierra el archivo cuando hayas terminado.

Ahora has completado la instalación del framework web Laravel con el servidor de base de datos MariaDB.

Configurar el host virtual de Apache

Ahora es el momento de configurar el host virtual de Apache2 para el framework web Laravel. En este ejemplo, el proyecto Laravel se ejecutará en el dominio local laravelapp.howtoforge.local.

Crea un nuevo archivo “ /etc/apache2/sites-available/laravel.conf “ usando el editor nano.

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

Agrega la siguiente configuración al archivo. Si estás usando tu nombre de dominio, puedes cambiar el dominio. Además, asegúrate de cambiar la ruta de la raíz del documento para el proyecto Laravel.

  
  
    ServerAdmin [email protected]  
    ServerName laravelapp.howtoforge.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 y cierra el archivo cuando hayas terminado.

A continuación, activa el módulo de reescritura de Apache2 y activa la configuración del host virtual laravel.conf usando el siguiente comando.

sudo a2enmod rewrite  
sudo a2ensite laravel.conf

Ahora verifica la configuración de Apache2 y asegúrate de que no haya errores.

sudo apachectl configtest

Ahora reinicia el servicio Apache2 para aplicar una nueva configuración de host virtual para el proyecto Laravel usando el siguiente comando.

sudo systemctl restart apache2

Ahora has completado la configuración del host virtual de Apache para Laravel.

En tu máquina, edita el archivo /etc/hosts usando el editor nano/vim.

sudo nano /etc/hosts

Agrega la siguiente configuración. Asegúrate de cambiar el nombre de dominio y la dirección IP con tu servidor detallado.

192.168.10.15 laravelapp.howtoforge.local

Guarda y cierra el archivo cuando hayas terminado.

Por último, vuelve a tu navegador web e ingresa la URL de instalación de Laravel (es decir, http://laravelapp.howtoforge.local) en la barra de direcciones. Y deberías ver la página de índice predeterminada del framework web Laravel. Además, en la parte inferior, puedes ver la versión de Laravel que acabas de instalar y la versión de PHP que estás utilizando actualmente.

Conclusión

¡Felicidades! Ahora has instalado con éxito el framework web Laravel en Ubuntu 22.04. También has aprendido la configuración básica de la pila LAMP para el framework web Laravel.