Skip to main content

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.
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.
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.
Cuando la aplicación esté creada, arranca el servidor de desarrollo con el script dev de Composer.
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”.

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.

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.
Si usas una base de datos distinta de SQLite, ejecuta las migraciones para crear las tablas.

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