Saltar al contenido principal

​
Requisitos del entorno

Antes de empezar con Laravel necesitas lo siguiente:
  • PHP 8.3 o superior
  • Composer (gestor de paquetes de PHP)
  • Instalador de Laravel (opcional, pero recomendado)
También necesitas Node.js/npm o Bun para compilar los assets del frontend.

​
Instalación de PHP y del instalador de Laravel

La forma más sencilla de instalar PHP, Composer y el instalador de Laravel de una sola vez es ejecutar el comando correspondiente a tu sistema operativo. 
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))

/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"
Tras ejecutar el comando, reinicia la sesión de la terminal. Si ya tienes PHP y Composer instalados, puedes instalar solo el instalador de Laravel con Composer. 
composer global require laravel/installer
Si prefieres una herramienta gráfica para gestionar PHP, consulta también Instalación con Laravel Herd.

​
Creación de una nueva aplicación Laravel

Una vez preparados PHP, Composer y el instalador de Laravel, crea una nueva aplicación. El instalador te pedirá elegir framework de pruebas, base de datos y starter kit. 
laravel new example-app
Cuando la aplicación esté creada, arranca el servidor de desarrollo con el script dev de Composer. 
cd example-app
npm install && npm run build
composer run dev
Cuando el servidor esté en marcha, accede en el navegador a http://localhost:8000.
Si utilizas un starter kit, se genera automáticamente el andamiaje base con funcionalidad de autenticación. En Laravel 13 puedes elegir entre cuatro variantes: React, Vue, Svelte y Livewire.

​
Opciones de starter kit

Al ejecutar laravel new puedes elegir uno de los siguientes starter kits.
Starter kit con frontend en React usando Inertia. Usa React 19, TypeScript, Tailwind y shadcn/ui, y ofrece una configuración moderna que combina SPA y enrutamiento del lado del servidor.
Starter kit con frontend en Vue usando Inertia. Usa la Composition API de Vue, TypeScript, Tailwind y shadcn-vue.
Starter kit con frontend en Svelte usando Inertia. Usa Svelte 5, TypeScript, Tailwind y shadcn-svelte.
Starter kit basado en Laravel Livewire. Puedes construir una UI dinámica solo con PHP, ideal para equipos que trabajan principalmente con plantillas Blade. Usa Tailwind y Flux UI.
Si dudas qué configuración elegir, resulta más fácil decidir después de leer Frontend, donde se comparan Blade, Livewire, Inertia y SPA.

​
Instalación con Laravel Herd

Laravel Herd es un entorno de desarrollo Laravel/PHP nativo para macOS y Windows. Permite instalar PHP, Nginx y la CLI de Laravel en un solo paquete.

​
macOS

  1. Descarga el instalador desde la web de Herd.
  2. Al ejecutar el instalador, PHP se configura automáticamente.
  3. El directorio ~/Herd queda configurado como directorio “park”.
cd ~/Herd
laravel new my-app
cd my-app
herd open

​
Windows

  1. Descarga el instalador para Windows desde la web de Herd.
  2. Tras la instalación, ejecuta Herd y completa el proceso de onboarding.
  3. El directorio “park” será %USERPROFILE%\Herd.
cd ~\Herd
laravel new my-app
cd my-app
herd open

​
Configuración inicial

​
Configuración del entorno

Muchos de los valores de configuración de Laravel varían según el entorno. Por ello, los valores importantes se gestionan en el archivo .env en la raíz de la aplicación.
No confirmes el archivo .env en el control de versiones. Hay riesgo de filtrar información sensible.

​
Configuración de la base de datos

Por defecto, Laravel está configurado para usar SQLite. Si vas a usar MySQL o PostgreSQL, actualiza el archivo .env. 
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
Si usas una base de datos distinta de SQLite, ejecuta las migraciones para crear las tablas. 
php artisan migrate

​
Soporte del IDE

Instalando la extensión oficial Laravel VS Code Extension obtienes soporte para Laravel: resaltado de sintaxis, snippets, integración con comandos Artisan y autocompletado inteligente para modelos Eloquent, entre otras cosas.
PhpStorm incluye soporte nativo para Laravel y ofrece autocompletado inteligente para plantillas Blade, modelos Eloquent, rutas, vistas y traducciones.

​
Próximos pasos

Estructura de directorios

Comprende los principales directorios y archivos de un proyecto Laravel.
Última modificación el 13 de julio de 2026

Temas relacionados

Laravel Console StarterLaravel BoostLaravel TelescopeLaravel PromptsBroadcasting