Cómo instalar Laravel en Debian 12

Laravel es un marco de aplicación web basado en PHP para construir aplicaciones web empresariales. Es un marco 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 marco 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.

Combinar el marco web de Laravel con otro marco 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 esta guía, te mostraremos cómo instalar Laravel paso a paso en Debian 12, para que puedas comenzar con el proyecto Laravel. Te mostraremos cómo instalar Laravel con el servidor web Apache2, MariaDB y PHP 8.2.

Requisitos previos

A continuación se presentan los requisitos que necesitas para seguir esta guía:

• Un servidor Debian 12.
• Un usuario no root con privilegios de administrador.

Instalando LAMP Stack

El primer paso que debes hacer es instalar el LAMP Stack (Apache2, MariaDB y PHP) en tu servidor Debian. Luego, también verificarás ambos servicios de Apache2 y MariaDB para asegurarte de que el servicio esté en funcionamiento.

Antes de instalar paquetes, ejecuta el comando apt update para actualizar y refrescar los repositorios de Debian.

sudo apt update

Una vez que el repositorio esté actualizado, instala los paquetes del LAMP Stack (Apache2, PHP y MariaDB) ejecutando el comando apt install a continuación. El siguiente comando también instala algunas de las extensiones de PHP que necesita Laravel.

sudo apt install apache2 php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip mariadb-server

Ingresa y para confirmar y proceder con la instalación.

Con el LAMP Stack instalado, ejecuta el siguiente comando systemctl para verificar los servicios de apache2 y mariadb. Si el servicio está en funcionamiento, deberías obtener la salida active (running).

sudo systemctl status apache2  
sudo systemctl status mariadb

Para el servicio apache2, deberías obtener una salida como esta:

Y a continuación está el estado del servicio mariadb.

A continuación, ejecuta el comando php a continuación para verificar la versión de PHP y los módulos habilitados en PHP. Deberías ver PHP 8.2 instalado con algunos módulos habilitados, como curl, date, dom y exif.

php -v  
php -m

Por último, abre tu navegador web y visita la dirección IP de tu servidor Debian (es decir: http://192.168.10.15/). Si la instalación es exitosa, deberías obtener la página index.html del servidor web Apache.

Configurando PHP

Para instalar Laravel, hay algunas extensiones de PHP que debes habilitar, como fileinfo, mbstring y openssl. Puedes habilitar esas extensiones a través del archivo php.ini.

Usa el siguiente comando del editor nano para abrir el archivo de configuración de PHP /etc/php/8.2/apache2/php.ini.

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

Descomenta las siguientes líneas para habilitar la extensión fileinfo, mbstring y openssl.

extension=fileinfo  
extension=mbstring  
extension=openssl

Cuando termines, guarda el archivo y sal del editor.

A continuación, ejecuta el siguiente comando systemctl para reiniciar el servicio apache2 y aplicar los cambios.

sudo systemctl restart apache2

Luego, asegúrate de que las extensiones de PHP fileinfo, mbstring y openssl estén habilitadas ejecutando el siguiente comando php.

sudo php -m

Ahora crea un nuevo archivo phpinfo en /var/www/html/info.php usando el siguiente comando. Si tu instalación de PHP y el servidor web Apache2 son exitosos, esto te mostrará información detallada sobre tu instalación de PHP.

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

Abre tu navegador web preferido y visita la dirección IP del servidor seguida de la ruta del archivo info.php (es decir: http://192.168.10.15/info.php). Si es exitoso, deberías ver una salida como esta:

Configurando el servidor MariaDB

Después de configurar PHP, configurarás tu servidor MariaDB, que incluye asegurar el servidor MariaDB a través de la utilidad mariadb-secure-installation, luego crear una nueva base de datos y usuario para tu proyecto Laravel.

Primero, ejecuta el comando mariadb-secure-installation a continuación para asegurar tu instalación del servidor MariaDB. Durante el proceso, se te pedirá algunas configuraciones de MariaDB, ingresa Y para confirmar la configuración o n para No.

sudo mariadb-secure-installation

A continuación se presentan algunas de las configuraciones de MariaDB que se te preguntarán durante el proceso:

• Presiona ENTER cuando se te pida la contraseña de root de MariaDB.
• Ingresa n cuando se te pregunte sobre el método de autenticación unix_socket.
• Ingresa Y para configurar una nueva contraseña para el usuario root de MariaDB. Luego, ingresa la nueva contraseña y repítela.
• Ingresa Y para eliminar el usuario anónimo predeterminado de MariaDB.
• Luego, ingresa Y nuevamente para 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 MariaDB.
• Por último, ingresa Y nuevamente para recargar los privilegios de las tablas y aplicar los cambios.

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

Inicia sesión en el servidor MariaDB a través del comando mariadb a continuación. Ingresa tu contraseña de MariaDB cuando se te pida.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas para crear una nueva base de datos testapp, el usuario testapp y la contraseña password. Asegúrate de cambiar la contraseña en la siguiente consulta.

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

A continuación, ejecuta la consulta a continuación para asegurarte de que el usuario testapp pueda acceder a la base de datos testapp.

SHOW GRANTS FOR testapp@localhost;

La salida a continuación confirma que el usuario testapp puede acceder a la base de datos testapp.

Por último, escribe quit para salir del servidor MariaDB y completar este paso.

Instalando Composer

Laravel se puede instalar de muchas maneras, y la más fácil es instalarlo a través de Composer, el administrador de paquetes de PHP. Ahora, instalarás Composer en tu servidor Debian.

Para instalar el administrador de paquetes PHP Composer, ejecuta el comando apt install a continuación. Escribe y cuando se te pida proceder con la instalación.

sudo apt install composer

Después de que la instalación haya finalizado, ejecuta el siguiente comando para localizar el archivo binario de Composer y verificar la versión de Composer.

which composer  
sudo -u www-data composer --version

El archivo binario de Composer se encuentra en /usr/bin/composer y se ha instalado Composer 2.5.5.

Creando el primer proyecto Laravel

Con todo en su lugar, estás listo para instalar y crear el primer proyecto Laravel. Crearás el primer proyecto Laravel con MariaDB como base de datos.

Primero, crea un nuevo directorio raíz de documentos /var/www/testapp para tu proyecto y cambia la propiedad al usuario www-data a través del comando a continuación. También crearás los directorios /var/www/.cache y /var/www/.config que serán utilizados por Composer.

sudo mkdir -p /var/www/{.cache,.config,testapp}  
sudo chown -R www-data:www-data /var/www/{.cache,.config,testapp}

Ahora muévete al directorio /var/www/testapp/ y ejecuta el comando composer a continuación para crear el primer proyecto Laravel. Tu primer proyecto Laravel se almacena en el directorio /var/www/testapp/.

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

Durante la instalación, deberías obtener una salida similar a esta:

Con el proyecto Laravel creado, a continuación configurarás la base de datos para tu proyecto a través del archivo de configuración .env. El archivo .env se utiliza como la configuración base para tu proyecto Laravel.

Usa el siguiente comando del editor nano para abrir el archivo .env.

nano .env

Cambia el parámetro APP_URL con el nombre de dominio local de tu proyecto Laravel. De esta manera, puedes acceder a tu proyecto a través de un nombre de dominio local. En este caso, el nombre de dominio es testapp.local.

APP_URL=http://testapp.local

Ahora cambia la configuración de la base de datos DB_CONNECTION a mysql y cambia los detalles de DB_DATABASE, DB_USERNAME y DB_PASSWORD con los detalles de tu base de datos y usuario de MariaDB.

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

Cuando termines, guarda el archivo y sal del editor.

Ahora ejecuta el siguiente comando para migrar la base de datos. Esto creará tablas para el proyecto Laravel.

sudo -u www-data php artisan migrate

Configurando el host virtual de Apache

En el siguiente paso, crearás una nueva configuración de host virtual de Apache2 para tu proyecto Laravel. Después de eso, debes activar el host virtual y verificar las configuraciones de Apache2, luego reiniciar el servidor web Apache2 para que los cambios surtan efecto.

Antes de crear la configuración de host virtual de Apache2 para Laravel, debes habilitar el módulo rewrite en Apache2 a través del siguiente comando.

sudo a2enmod rewrite

Usa el siguiente comando del editor nano para crear la configuración de host virtual de Apache2 /etc/apache2/sites-available/laravel.conf.

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

Inserta la siguiente configuración y cambia el parámetro ServerName con tu nombre de dominio.

  
  
    ServerAdmin [email protected]  
    ServerName testapp.local  
    DocumentRoot /var/www/testapp/public  
  
      
            Options FollowSymLinks  
            AllowOverride None  
      
      
            AllowOverride All  
      
  
    ErrorLog ${APACHE_LOG_DIR}/error.log  
    CustomLog ${APACHE_LOG_DIR}/access.log combined  
  

Cuando termines, guarda el archivo y sal del editor.

A continuación, ejecuta el siguiente comando para activar la configuración del host virtual laravel.conf y verificar las configuraciones de Apache2. Si tienes configuraciones adecuadas, deberías obtener un mensaje como Syntax OK.

sudo a2ensite laravel.conf  
sudo apachectl configtest

Por último, reinicia el servicio apache2 ejecutando el siguiente comando y aplicando los cambios que has realizado.

sudo systemctl restart apache2

Accediendo a Laravel

Si estás en un cliente Linux, modifica el archivo /etc/hosts a través del comando del editor nano a continuación.

sudo nano /etc/hosts

Si estás en una máquina Windows, modifica el archivo C:\Windows\System32\drivers\etc\hosts.

Inserta el nombre de dominio de tu proyecto Laravel y la dirección IP de tu servidor Debian así:

192.168.10.15   testapp.local

Guarda el archivo y sal del editor.

Por último, abre tu navegador web y visita el nombre de dominio local de tu proyecto Laravel (es decir: http://testapp.local). Si es exitoso, deberías obtener una página similar a Laravel como esta:

Conclusión

En conclusión, has instalado Laravel con LAMP Stack (Apache2, MariaDB y PHP) en el servidor Debian 12. También has instalado Composer, el administrador de paquetes de PHP, y lo has utilizado como medio de instalación para Laravel. Con esto en mente, ahora puedes desarrollar tu aplicación utilizando el marco web Laravel y MariaDB como base de datos para tus aplicaciones.