
Instalar Laravel 12 correctamente es el primer paso para desarrollar aplicaciones web modernas y seguras. En esta guía aprenderás cómo instalar Laravel 12 desde cero y cómo agregar Laravel Breeze para tener autenticación lista (login y registro) en pocos minutos.
Este tutorial está actualizado a 2026 y funciona con PHP 8.2 o superior.
Requisitos para Instalar Laravel 12
Antes de comenzar la instalación, es fundamental asegurarte de que tu entorno cumple con los requisitos necesarios. Laravel depende de ciertas herramientas para funcionar correctamente.
PHP 8.2 o Superior
Laravel 12 requiere PHP 8.2 o una versión superior. Esto es importante porque versiones anteriores pueden generar errores de compatibilidad.
Para verificar tu versión ejecuta en la terminal:
php -vSi no tienes PHP actualizado, puedes instalarlo mediante XAMPP, Laragon o directamente desde la web oficial de PHP.
Composer Instalado
Composer es el gestor de dependencias de PHP. Laravel se instala y administra mediante Composer.
Verifica que esté instalado con:
composer -VSi no lo tienes, descárgalo desde su sitio oficial e instálalo antes de continuar.
Node.js Instalado
Node.js es necesario para compilar los assets frontend (CSS y JavaScript) mediante Vite.
Verifica con:
node -vSi no lo tienes instalado, descárgalo desde su página oficial.
Servidor Local (XAMPP o Laragon)
Necesitas un entorno local con Apache/Nginx y MySQL.
Opciones recomendadas:
- XAMPP
- Laragon
Ambos incluyen PHP y base de datos, facilitando el desarrollo local.
Cómo Instalar Laravel 12 Paso a Paso
Ahora que tu entorno está listo, vamos a instalar Laravel 12 usando Composer.
Crear un Nuevo Proyecto Laravel
Abre la terminal en la carpeta donde deseas crear el proyecto y ejecuta:
composer create-project laravel/laravel mi_proyectoEste comando descargará la versión más reciente estable de Laravel y configurará automáticamente la estructura del proyecto.
Ingresar al Proyecto
Una vez finalizada la instalación, entra al directorio del proyecto:
cd mi_proyectoAquí es donde trabajarás durante el desarrollo.
Levantar el Servidor de Desarrollo
Para iniciar el servidor local ejecuta:
php artisan serveLuego abre en tu navegador:
http://127.0.0.1:8000Si ves la pantalla de bienvenida, la instalación fue exitosa.
Cómo Instalar Laravel Breeze (Autenticación)
Laravel Breeze es un paquete oficial que proporciona autenticación básica lista para usar. Incluye login, registro, recuperación de contraseña y dashboard.
Instalar el Paquete Breeze
Dentro del proyecto ejecuta:
composer require laravel/breeze --devEsto instalará el paquete como dependencia de desarrollo.
Ejecutar el Instalador de Breeze
Luego ejecuta:
php artisan breeze:installAquí podrás elegir entre:
- Blade
- Vue
- React
- API
Para este tutorial seleccionamos Blade por ser más simple y ligero.
Instalar Dependencias Frontend
Ahora necesitas instalar y compilar los archivos frontend:
npm install
npm run devEsto compilará los recursos usando Vite.
Configurar la Base de Datos
Antes de usar el sistema de autenticación, debes configurar la conexión a la base de datos.
Editar el Archivo .env
Abre el archivo .env y configura:
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=Asegúrate de que la base de datos exista en MySQL.
Ejecutar las Migraciones
Para crear las tablas necesarias ejecuta:
php artisan migrateEste comando creará las tablas como users, password_reset_tokens y otras necesarias para autenticación.
Probar el Sistema de Login y Registro
Con todo instalado, abre en tu navegador:
http://127.0.0.1:8000/registerCrea un usuario y luego inicia sesión.
Si todo funciona correctamente, verás el dashboard autenticado. Esto confirma que Laravel Breeze está funcionando correctamente.
Errores Comunes y Soluciones
Durante la instalación pueden aparecer algunos errores. Aquí tienes las soluciones más comunes.
Error de Clave de Aplicación
Si aparece error relacionado con APP_KEY, ejecuta:
php artisan key:generateError en Migraciones
Si falla la migración, verifica:
- Credenciales correctas en .env
- Que la base de datos exista
- Que el servidor MySQL esté activo
Error en Assets Frontend
Si el diseño no carga correctamente, ejecuta nuevamente:
npm run devConclusión
Instalar Laravel 12 con Laravel Breeze es un proceso sencillo si sigues los pasos correctamente. En menos de 15 minutos puedes tener una aplicación lista con autenticación funcional.
Este método es ideal para:
- Crear sistemas administrativos
- Aplicaciones web con usuarios
- Proyectos profesionales con Laravel
Ahora que ya tienes Laravel 12 con autenticación lista, el siguiente paso puede ser crear un CRUD completo o implementar roles y permisos.
