Laravel 12 es el framework PHP más popular para el desarrollo de aplicaciones web modernas. Su potencia y flexibilidad lo convierten en la elección favorita de programadores en todo el mundo. En esta guía, aprenderás a instalar Laravel 12 en Windows, utilizando Laragon como entorno local y Composer como gestor de dependencias.

Paso 1: Instalar Laragon

• Descarga e instala Laragon desde https://laragon.org.
• Es una herramienta ligera y potente para ejecutar PHP, MySQL/MariaDB y otros servicios fácilmente.

Paso 2: Instalar Composer

• Descarga e instala Composer desde https://getcomposer.org.
• Laravel lo usa para gestionar dependencias y librerías.

Paso 3: Instalar el instalador de Laravel

Abre la terminal de Laragon y ejecuta:

composer global require laravel/installer

Esto instalará el instalador oficial de Laravel de forma global en tu sistema.

Paso 4: Crear tu aplicación

Ahora crea tu proyecto con:

laravel new mi-app

Durante la instalación, el asistente te hará una serie de preguntas. Estas son las preguntas y las respuestas seleccionadas en este tutorial:

Which starter kit would you like to install?

• Respuesta: Livewire
• Explicación: permite crear interfaces dinámicas y reactivas directamente con Blade y PHP, sin necesidad de un framework de frontend pesado.

Which authentication provider do you prefer?

• Respuesta: Laravel
• Explicación: se instala el sistema de autenticación nativo de Laravel (Breeze), con vistas, controladores y rutas listas para usar.

Would you like to use Laravel Volt?

• Respuesta: Yes
• Explicación: Volt es una herramienta oficial que acelera la creación de componentes Livewire preconstruidos para formularios y autenticación.

Which testing framework do you prefer?

• Respuesta: Pest
• Explicación: framework moderno de testing, más legible y expresivo que PHPUnit.

Would you like to run npm install and npm run build?

• Respuesta: Yes
• Explicación: ejecuta automáticamente la instalación de dependencias de Node y la primera compilación de los assets de tu proyecto.

Con estas respuestas, tu proyecto quedará listo con Livewire, autenticación integrada, soporte de Volt, entorno de testing con Pest y assets compilados desde el inicio.

Paso 5: Entrar al proyecto y levantar el servidor

Accede a la carpeta de tu aplicación y arranca el entorno de desarrollo:

cd mi-app
composer run dev

Paso 6: Configurar la base de datos y el archivo .env

Abre el panel de Laragon y entra a phpMyAdmin o usa la consola para crear una base de datos llamada laravel:

CREATE DATABASE laravel;

Abre tu proyecto con un editor de código (por ejemplo Visual Studio Code, Sublime Text u otro de tu preferencia).

Edita el archivo .env ubicado en la raíz del proyecto para conectar la aplicación a MariaDB:

DB_CONNECTION=mariadb
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

Paso 7: Ejecutar migraciones

Corre las migraciones para crear las tablas por defecto en tu base de datos:

php artisan migrate

Paso 8: Personalizar la URL del proyecto

Para acceder a tu aplicación con una URL amigable:

Abre el archivo hosts en la ruta:

C:\Windows\System32\drivers\etc

(Debes abrirlo como administrador).

Agrega al final la siguiente línea:

127.0.0.1 tudominio.test #laragon magic!

Reinicia Laragon. Esto es necesario para que el cambio en el archivo hosts sea reconocido por el sistema y Laragon pueda redirigir el dominio correctamente.

Ahora podrás acceder al proyecto desde la URL personalizada: http://tudominio.test

Paso 9: Crear un repositorio en GitHub

Es recomendable versionar tu proyecto para trabajar de forma ordenada y segura:

Inicializa Git en tu proyecto:

git init
git add .
git commit -m "Primer commit - Proyecto Laravel 12"

Crea un repositorio en GitHub desde la web y copia la URL del mismo.

Vincula tu proyecto local con GitHub:

git remote add origin https://github.com/tu-usuario/tu-repositorio.git
git branch -M main
git push -u origin main

Con esto tendrás tu proyecto respaldado y listo para trabajar en equipo.

Paso 10: Configurar idioma con Laravel Lang

Para mejorar la experiencia con traducciones en Laravel, instala el paquete de idiomas:

composer require laravel-lang/common --dev
php artisan lang:update

Paso opcional: Reiniciar el proceso si algo salió mal

Si cometiste un error durante la instalación o simplemente quieres empezar desde cero, regresa a la carpeta www usando el siguiente comando

cd ..

Y luego, elimina el proyecto con el siguiente comando (ejecutado desde la terminal de Laragon o CMD):

rm -rf mi-app

Esto borrará la carpeta del proyecto y podrás volver a crear una nueva aplicación desde el Paso 4.

Conclusión

Con estos pasos, ya tienes Laravel 12 funcionando en Windows con Laragon y Composer, tu base de datos creada y configurada, migraciones aplicadas, acceso con una URL personalizada, tu proyecto versionado en GitHub y soporte de idioma. Además, cuentas con Livewire, Volt, autenticación lista y Pest para testing.