Instalación

Conozca Laravel

Laravel se esfuerza por brindar una increíble experiencia de desarrollador al tiempo que proporciona características poderosas como inyección de dependencia completa, una capa de abstracción de base de datos expresiva, colas y trabajos programados, pruebas unitarias y de integración, y más.

Ya sea que seas nuevo en los frameworks web PHP o tengas años de experiencia, Laravel es un framework que puede crecer contigo. Te ayudaremos a dar tus primeros pasos como desarrollador web o te daremos un impulso para que lleves tu experiencia al siguiente nivel. Estamos ansiosos por ver lo que creas.

¿Es nuevo en Laravel? Visite el Laravel Bootcamp para realizar un recorrido práctico por el marco mientras lo guiamos en la creación de su primera aplicación Laravel.

¿Por qué Laravel?

Hay una variedad de herramientas y marcos disponibles para crear una aplicación web. Sin embargo, creemos que Laravel es la mejor opción para crear aplicaciones web modernas y completas.

Un marco progresista

Nos gusta llamar a Laravel un framework “progresivo”. Con esto queremos decir que Laravel crece contigo. Si estás dando tus primeros pasos en el desarrollo web, la amplia biblioteca de documentación, guías y tutoriales en video de Laravel te ayudará a aprender los conceptos básicos sin agobiarte.

Si eres un desarrollador senior, Laravel te ofrece herramientas sólidas para inyección de dependencias , pruebas unitarias , colas , eventos en tiempo real y más. Laravel está optimizado para crear aplicaciones web profesionales y está listo para manejar cargas de trabajo empresariales.

Un marco escalable

Laravel es increíblemente escalable. Gracias a la naturaleza escalable de PHP y al soporte integrado de Laravel para sistemas de caché distribuidos y rápidos como Redis, el escalamiento horizontal con Laravel es muy sencillo. De hecho, las aplicaciones de Laravel se han escalado fácilmente para manejar cientos de millones de solicitudes por mes.

¿Necesitas una escalabilidad extrema? Las plataformas como Laravel Vapor te permiten ejecutar tu aplicación Laravel a una escala casi ilimitada con la última tecnología sin servidor de AWS.

Un marco comunitario

Laravel combina los mejores paquetes del ecosistema PHP para ofrecer el marco de trabajo más sólido y fácil de usar para los desarrolladores. Además, miles de desarrolladores talentosos de todo el mundo han contribuido al marco de trabajo . Quién sabe, tal vez incluso te conviertas en colaborador de Laravel.

Creando una aplicación Laravel

Instalación de PHP y el instalador de Laravel

Antes de crear tu primera aplicación Laravel, asegúrate de que tu máquina local tenga instalado PHP , Composer y el instalador de Laravel . Además, debes instalar Node y NPM o Bun para poder compilar los recursos de interfaz de tu aplicación.

Si no tiene PHP y Composer instalados en su máquina local, los siguientes comandos instalarán PHP, Composer y el instalador de Laravel en macOS, Windows o Linux:macOSWindows PowerShellLinux

/bin/bash -c "$(curl -fsSL https://php.new/install/mac)"

Después de ejecutar uno de los comandos anteriores, debe reiniciar su sesión de terminal. Para actualizar PHP, Composer y el instalador de Laravel después de instalarlos mediante php.new, puede volver a ejecutar el comando en su terminal.

Si ya tiene instalados PHP y Composer, puede instalar el instalador de Laravel a través de Composer:

composer global require laravel/installer

Para una experiencia de instalación y administración de PHP completamente gráfica y con funciones, consulte Laravel Herd .

Creando una aplicación

Una vez que haya instalado PHP, Composer y el instalador de Laravel, estará listo para crear una nueva aplicación de Laravel. El instalador de Laravel le solicitará que seleccione su marco de pruebas, base de datos y kit de inicio preferidos:

laravel new example-app

Una vez creada la aplicación, puedes iniciar el servidor de desarrollo local de Laravel, el trabajador de cola y el servidor de desarrollo Vite usando el devscript Composer:

cd example-appnpm install && npm run buildcomposer run dev

Una vez que haya iniciado el servidor de desarrollo, podrá acceder a su aplicación en su navegador web en http://localhost:8000 . A continuación, estará listo para comenzar a dar los siguientes pasos en el ecosistema de Laravel . Por supuesto, es posible que también desee configurar una base de datos .

Si desea comenzar con ventaja al desarrollar su aplicación Laravel, considere usar uno de nuestros kits de inicio . Los kits de inicio de Laravel brindan un andamiaje de autenticación de frontend y backend para su nueva aplicación Laravel.

Configuración inicial

Todos los archivos de configuración del framework Laravel se almacenan en el configdirectorio. Cada opción está documentada, así que no dudes en consultar los archivos y familiarizarte con las opciones disponibles.

Laravel no necesita prácticamente ninguna configuración adicional de fábrica. ¡Puedes empezar a desarrollar! Sin embargo, es posible que desees revisar el config/app.phparchivo y su documentación. Contiene varias opciones, como timezoney locale, que puedes modificar según tu aplicación.

Configuración basada en el entorno

Dado que muchos de los valores de las opciones de configuración de Laravel pueden variar dependiendo de si su aplicación se ejecuta en su máquina local o en un servidor web de producción, muchos valores de configuración importantes se definen utilizando el .envarchivo que existe en la raíz de su aplicación.

Su .envarchivo no debe enviarse al control de código fuente de su aplicación, ya que cada desarrollador o servidor que utilice su aplicación podría requerir una configuración de entorno diferente. Además, esto podría representar un riesgo de seguridad en caso de que un intruso obtenga acceso a su repositorio de control de código fuente, ya que cualquier credencial confidencial quedaría expuesta.

Para obtener más información sobre la .envconfiguración basada en archivos y entornos, consulte la documentación de configuración completa .

Bases de datos y migraciones

Ahora que ha creado su aplicación Laravel, probablemente desee almacenar algunos datos en una base de datos. De manera predeterminada, .envel archivo de configuración de su aplicación especifica que Laravel interactuará con una base de datos SQLite.

Durante la creación de la aplicación, Laravel creó un database/database.sqlitearchivo para usted y ejecutó las migraciones necesarias para crear las tablas de base de datos de la aplicación.

Si prefiere utilizar otro controlador de base de datos, como MySQL o PostgreSQL, puede actualizar su .envarchivo de configuración para utilizar la base de datos adecuada. Por ejemplo, si desea utilizar MySQL, actualice las variables .envde su archivo de configuración DB_*de la siguiente manera:

DB_CONNECTION=mysqlDB_HOST=127.0.0.1DB_PORT=3306DB_DATABASE=laravelDB_USERNAME=rootDB_PASSWORD=

Si elige utilizar una base de datos distinta a SQLite, deberá crear la base de datos y ejecutar las migraciones de bases de datos de su aplicación :

php artisan migrate

Si está desarrollando en macOS o Windows y necesita instalar MySQL, PostgreSQL o Redis localmente, considere usar Herd Pro .

Configuración del directorio

Laravel siempre debe servirse desde la raíz del “directorio web” configurado para su servidor web. No debe intentar servir una aplicación Laravel desde un subdirectorio del “directorio web”. Intentar hacerlo podría exponer archivos confidenciales presentes en su aplicación.

Instalación local mediante Herd

Laravel Herd es un entorno de desarrollo nativo de Laravel y PHP increíblemente rápido para macOS y Windows. Herd incluye todo lo que necesitas para comenzar a desarrollar con Laravel, incluidos PHP y Nginx.

Una vez que instales Herd, estarás listo para comenzar a desarrollar con Laravel. Herd incluye herramientas de línea de comandos para php, composer, laravel, expose, node, npm, y nvm.

Herd Pro amplía Herd con funciones adicionales potentes, como la capacidad de crear y administrar bases de datos locales MySQL, Postgres y Redis, así como visualización de correo local y monitoreo de registros.

Rebaño en macOS

Si desarrollas en macOS, puedes descargar el instalador de Herd desde el sitio web de Herd . El instalador descarga automáticamente la última versión de PHP y configura tu Mac para que siempre ejecute Nginx en segundo plano.

Herd para macOS usa dnsmasq para admitir directorios “estacionados”. Herd servirá automáticamente cualquier aplicación de Laravel en un directorio estacionado. De manera predeterminada, Herd crea un directorio estacionado en ~/Herdy puedes acceder a cualquier aplicación de Laravel en este directorio en el .testdominio usando su nombre de directorio.

Después de instalar Herd, la forma más rápida de crear una nueva aplicación Laravel es usar la CLI de Laravel, que viene incluida con Herd:

cd ~/Herdlaravel new my-appcd my-appherd open

Por supuesto, siempre puede administrar sus directorios estacionados y otras configuraciones de PHP a través de la interfaz de usuario de Herd, que se puede abrir desde el menú de Herd en la bandeja del sistema.

Puede obtener más información sobre Herd consultando la documentación de Herd .

Rebaño en las ventanas

Puede descargar el instalador de Windows para Herd en el sitio web de Herd . Una vez finalizada la instalación, puede iniciar Herd para completar el proceso de incorporación y acceder a la interfaz de usuario de Herd por primera vez.

Se puede acceder a la interfaz de usuario de Herd haciendo clic con el botón izquierdo en el icono de la bandeja del sistema de Herd. Si hace clic con el botón derecho, se abrirá el menú rápido con acceso a todas las herramientas que necesita a diario.

Durante la instalación, Herd crea un directorio “estacionado” en su directorio de inicio en %USERPROFILE%\Herd. Herd servirá automáticamente cualquier aplicación Laravel en un directorio estacionado y usted podrá acceder a cualquier aplicación Laravel en este directorio en el .testdominio usando su nombre de directorio.

Después de instalar Herd, la forma más rápida de crear una nueva aplicación Laravel es mediante la CLI de Laravel, que viene incluida con Herd. Para comenzar, abra PowerShell y ejecute los siguientes comandos:

cd ~\Herdlaravel new my-appcd my-appherd open

Puede obtener más información sobre Herd consultando la documentación de Herd para Windows .

Instalación de Docker con Sail

Queremos que sea lo más fácil posible comenzar a usar Laravel, independientemente del sistema operativo que prefieras. Por lo tanto, existen diversas opciones para desarrollar y ejecutar una aplicación Laravel en tu máquina local. Si bien es posible que desees explorar estas opciones más adelante, Laravel ofrece Sail , una solución integrada para ejecutar tu aplicación Laravel con Docker .

Docker es una herramienta para ejecutar aplicaciones y servicios en “contenedores” pequeños y livianos que no interfieren con el software o la configuración instalados en su máquina local. Esto significa que no tiene que preocuparse por configurar o instalar herramientas de desarrollo complicadas, como servidores web y bases de datos, en su máquina local. Para comenzar, solo necesita instalar Docker Desktop .

Laravel Sail es una interfaz de línea de comandos liviana para interactuar con la configuración de Docker predeterminada de Laravel. Sail ofrece un excelente punto de partida para crear una aplicación de Laravel con PHP, MySQL y Redis sin necesidad de tener experiencia previa con Docker.

¿Ya eres un experto en Docker? ¡No te preocupes! Todo lo relacionado con Sail se puede personalizar usando el docker-compose.ymlarchivo incluido con Laravel.

Navegar en macOS

Si está desarrollando en una Mac y Docker Desktop ya está instalado, puede usar un comando de terminal simple para crear una nueva aplicación Laravel. Por ejemplo, para crear una nueva aplicación Laravel en un directorio llamado “example-app”, puede ejecutar el siguiente comando en su terminal:

curl -s "https://laravel.build/example-app" | bash

Por supuesto, puedes cambiar “example-app” en esta URL por lo que quieras, solo asegúrate de que el nombre de la aplicación solo contenga caracteres alfanuméricos, guiones y guiones bajos. El directorio de la aplicación Laravel se creará dentro del directorio desde el que ejecutes el comando.

La instalación de Sail puede tardar varios minutos mientras se construyen los contenedores de aplicaciones de Sail en su máquina local.

Una vez creada la aplicación, puedes navegar hasta el directorio de la aplicación e iniciar Laravel Sail. Laravel Sail ofrece una interfaz de línea de comandos sencilla para interactuar con la configuración de Docker predeterminada de Laravel:

cd example-app./vendor/bin/sail up

Una vez que se hayan iniciado los contenedores Docker de la aplicación, debes ejecutar las migraciones de la base de datos de tu aplicación :

./vendor/bin/sail artisan migrate

Finalmente, puedes acceder a la aplicación en tu navegador web en: http://localhost .

Para continuar aprendiendo más sobre Laravel Sail, revise su documentación completa .

Navegar en Windows

Antes de crear una nueva aplicación Laravel en su máquina Windows, asegúrese de instalar Docker Desktop . A continuación, debe asegurarse de que Windows Subsystem for Linux 2 (WSL2) esté instalado y habilitado. WSL le permite ejecutar archivos binarios ejecutables de Linux de forma nativa en Windows 10. Puede encontrar información sobre cómo instalar y habilitar WSL2 en la documentación del entorno de desarrollo de Microsoft .

Después de instalar y habilitar WSL2, debe asegurarse de que Docker Desktop esté configurado para usar el backend de WSL2 .

A continuación, ya está listo para crear su primera aplicación Laravel. Inicie Windows Terminal y comience una nueva sesión de terminal para su sistema operativo WSL2 Linux. A continuación, puede utilizar un comando de terminal simple para crear una nueva aplicación Laravel. Por ejemplo, para crear una nueva aplicación Laravel en un directorio llamado “example-app”, puede ejecutar el siguiente comando en su terminal:

curl -s https://laravel.build/example-app | bash

Por supuesto, puedes cambiar “example-app” en esta URL por lo que quieras, solo asegúrate de que el nombre de la aplicación solo contenga caracteres alfanuméricos, guiones y guiones bajos. El directorio de la aplicación Laravel se creará dentro del directorio desde el que ejecutes el comando.

La instalación de Sail puede tardar varios minutos mientras se construyen los contenedores de aplicaciones de Sail en su máquina local.

Una vez creada la aplicación, puedes navegar hasta el directorio de la aplicación e iniciar Laravel Sail. Laravel Sail ofrece una interfaz de línea de comandos sencilla para interactuar con la configuración de Docker predeterminada de Laravel:

cd example-app./vendor/bin/sail up

Una vez que se hayan iniciado los contenedores Docker de la aplicación, debes ejecutar las migraciones de la base de datos de tu aplicación :

./vendor/bin/sail artisan migrate

Finalmente, puedes acceder a la aplicación en tu navegador web en: http://localhost .

Para continuar aprendiendo más sobre Laravel Sail, revise su documentación completa .

Desarrollo dentro de WSL2

Por supuesto, deberá poder modificar los archivos de la aplicación Laravel que se crearon dentro de su instalación de WSL2. Para lograrlo, recomendamos usar el editor de código Visual Studio de Microsoft y su extensión propia para desarrollo remoto .

Una vez instaladas estas herramientas, puede abrir cualquier aplicación Laravel ejecutando el code .comando desde el directorio raíz de su aplicación usando la Terminal de Windows.

Navegar en Linux

Si está desarrollando en Linux y Docker Compose ya está instalado, puede usar un comando de terminal simple para crear una nueva aplicación Laravel.

En primer lugar, si utiliza Docker Desktop para Linux, debe ejecutar el siguiente comando. Si no utiliza Docker Desktop para Linux, puede omitir este paso:

docker context use default

Luego, para crear una nueva aplicación Laravel en un directorio llamado “example-app”, puedes ejecutar el siguiente comando en tu terminal:

curl -s https://laravel.build/example-app | bash

Por supuesto, puedes cambiar “example-app” en esta URL por lo que quieras, solo asegúrate de que el nombre de la aplicación solo contenga caracteres alfanuméricos, guiones y guiones bajos. El directorio de la aplicación Laravel se creará dentro del directorio desde el que ejecutes el comando.

La instalación de Sail puede tardar varios minutos mientras se construyen los contenedores de aplicaciones de Sail en su máquina local.

Una vez creada la aplicación, puedes navegar hasta el directorio de la aplicación e iniciar Laravel Sail. Laravel Sail ofrece una interfaz de línea de comandos sencilla para interactuar con la configuración de Docker predeterminada de Laravel:

cd example-app./vendor/bin/sail up

Una vez que se hayan iniciado los contenedores Docker de la aplicación, debes ejecutar las migraciones de la base de datos de tu aplicación :

./vendor/bin/sail artisan migrate

Finalmente, puedes acceder a la aplicación en tu navegador web en: http://localhost .

Para continuar aprendiendo más sobre Laravel Sail, revise su documentación completa .

Cómo elegir sus servicios de navegación

Al crear una nueva aplicación Laravel a través de Sail, puede usar la withvariable de cadena de consulta para elegir qué servicios se deben configurar en el docker-compose.ymlarchivo de su nueva aplicación. Los servicios disponibles incluyen mysql, pgsql, mariadb, redis, memcached, meilisearch, typesense, minio, selenium, y mailpit:

curl -s "https://laravel.build/example-app?with=mysql,redis" | bash

Si no especifica qué servicios desea configurar, se configurará una pila predeterminada de mysql, redis, meilisearch, mailpity .selenium

Puede indicarle a Sail que instale un Devcontainer predeterminado agregando el devcontainerparámetro a la URL:

curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bash

Soporte IDE

Usted es libre de utilizar cualquier editor de código que desee al desarrollar aplicaciones Laravel; sin embargo, PhpStorm ofrece un amplio soporte para Laravel y su ecosistema, incluido Laravel Pint .

Además, el complemento Laravel Idea PhpStorm mantenido por la comunidad ofrece una variedad de útiles ampliaciones de IDE, que incluyen generación de código, finalización de sintaxis Eloquent, finalización de reglas de validación y más.

Próximos pasos

Ahora que ha creado su aplicación Laravel, es posible que se pregunte qué debe aprender a continuación. En primer lugar, le recomendamos encarecidamente que se familiarice con el funcionamiento de Laravel leyendo la siguiente documentación:

• Ciclo de vida de la solicitud
• Configuración
• Estructura del directorio
• Interfaz
• Contenedor de servicios
• Fachadas

La forma en que quieras usar Laravel también determinará los próximos pasos en tu recorrido. Hay varias formas de usar Laravel y, a continuación, exploraremos dos casos de uso principales para el marco.

¿Es nuevo en Laravel? Visite el Laravel Bootcamp para realizar un recorrido práctico por el marco mientras lo guiamos en la creación de su primera aplicación Laravel.

Laravel, el framework de pila completa

Laravel puede servir como un framework full stack. Por framework “full stack” queremos decir que vas a usar Laravel para enrutar solicitudes a tu aplicación y renderizar tu frontend a través de plantillas Blade o una tecnología híbrida de aplicación de página única como Inertia . Esta es la forma más común de usar el framework Laravel y, en nuestra opinión, la forma más productiva de usar Laravel.

Si así es como planeas usar Laravel, quizás quieras consultar nuestra documentación sobre desarrollo de interfaz , enrutamiento , vistas o el ORM Eloquent . Además, quizás te interese conocer paquetes comunitarios como Livewire e Inertia . Estos paquetes te permiten usar Laravel como un marco de trabajo de pila completa mientras disfrutas de muchos de los beneficios de la interfaz de usuario que brindan las aplicaciones JavaScript de una sola página.

Si está utilizando Laravel como un marco de trabajo completo, también le recomendamos encarecidamente que aprenda a compilar el CSS y JavaScript de su aplicación usando Vite .

Si desea comenzar a desarrollar su aplicación, consulte uno de nuestros kits de inicio de aplicaciones oficiales .

Laravel, la API backend

Laravel también puede servir como backend de API para una aplicación de página única o una aplicación móvil de JavaScript. Por ejemplo, puede utilizar Laravel como backend de API para su aplicación Next.js. En este contexto, puede utilizar Laravel para proporcionar autenticación y almacenamiento/recuperación de datos para su aplicación, al mismo tiempo que aprovecha los potentes servicios de Laravel, como colas, correos electrónicos, notificaciones y más.

Si así es como planeas usar Laravel, quizás quieras consultar nuestra documentación sobre enrutamiento , Laravel Sanctum y Eloquent ORM .

¿Necesitas una ventaja inicial para construir el andamiaje de tu backend de Laravel y el frontend de Next.js? Laravel Breeze ofrece una pila de API y una implementación del frontend de Next.js para que puedas empezar en minutos.