> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# Instalación
> Explicamos cómo instalar Laravel y configurar el entorno PHP.
## 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.
```shell macOS theme={null}
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"
```
```powershell Windows (ejecutar como administrador) theme={null}
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'))
```
```shell Linux theme={null}
/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.
```shell theme={null}
composer global require laravel/installer
```
Si prefieres una herramienta gráfica para gestionar PHP, consulta también [Instalación con Laravel Herd](#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.
```shell theme={null}
laravel new example-app
```
Cuando la aplicación esté creada, arranca el servidor de desarrollo con el script `dev` de Composer.
```shell theme={null}
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](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](https://inertiajs.com). Usa React 19, TypeScript, Tailwind y [shadcn/ui](https://ui.shadcn.com), y ofrece una configuración moderna que combina SPA y enrutamiento del lado del servidor.
Starter kit con frontend en Vue usando [Inertia](https://inertiajs.com). Usa la Composition API de Vue, TypeScript, Tailwind y [shadcn-vue](https://www.shadcn-vue.com/).
Starter kit con frontend en Svelte usando [Inertia](https://inertiajs.com). Usa Svelte 5, TypeScript, Tailwind y [shadcn-svelte](https://www.shadcn-svelte.com/).
Starter kit basado en [Laravel Livewire](https://livewire.laravel.com). Puedes construir una UI dinámica solo con PHP, ideal para equipos que trabajan principalmente con plantillas Blade. Usa Tailwind y [Flux UI](https://fluxui.dev).
Si dudas qué configuración elegir, resulta más fácil decidir después de leer [Frontend](/es/frontend), donde se comparan Blade, Livewire, Inertia y SPA.
## Instalación con Laravel Herd
[Laravel Herd](https://herd.laravel.com) 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](https://herd.laravel.com).
2. Al ejecutar el instalador, PHP se configura automáticamente.
3. El directorio `~/Herd` queda configurado como directorio "park".
```shell theme={null}
cd ~/Herd
laravel new my-app
cd my-app
herd open
```
### Windows
1. Descarga el instalador para Windows desde la [web de Herd](https://herd.laravel.com/windows).
2. Tras la instalación, ejecuta Herd y completa el proceso de onboarding.
3. El directorio "park" será `%USERPROFILE%\Herd`.
```shell theme={null}
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`.
```ini theme={null}
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.
```shell theme={null}
php artisan migrate
```
## Soporte del IDE
Instalando la extensión oficial [Laravel VS Code Extension](https://marketplace.visualstudio.com/items?itemName=laravel.vscode-laravel) obtienes soporte para Laravel: resaltado de sintaxis, snippets, integración con comandos Artisan y autocompletado inteligente para modelos Eloquent, entre otras cosas.
[PhpStorm](https://www.jetbrains.com/phpstorm/laravel/) incluye soporte nativo para Laravel y ofrece autocompletado inteligente para plantillas Blade, modelos Eloquent, rutas, vistas y traducciones.
## Próximos pasos
Comprende los principales directorios y archivos de un proyecto Laravel.
## Related topics
- [Laravel Console Starter](/es/packages/laravel-console-starter/index.md)
- [Laravel Boost](/es/boost.md)
- [Laravel Telescope](/es/telescope.md)
- [Laravel Prompts](/es/prompts.md)
- [Broadcasting](/es/broadcasting.md)