5.3. Instalación de Laravel
En esta sección vamos a describir el proceso de instalación de Laravel en un servidor local para desarrollo.
Como es loǵico, hay dos posibilidades:
- Usar un servidor local y configurarlo adecuadamente para que Laravel funcione.
- Usar un servidor virtualizado mediante.
Docker es la solución de virtualización más utilizada acualmente, y la recomendada por Laravel.
5.3.1. Instalación nativa en servidor local
No es recomendable instalar Laravel de forma nativa en tu servidor local porque requiere una fuerte configuración del servidor. Tendrás que instalar bastante librerías que consumirán recursos de tu máquina sin necesidad, tales como OpenSSL, Mbstring o Tokenizer.
También necesitarás instalar composer, la herramienta de resolución de dependencias de PHP.
Por todo ello, los desarrolladores de Laravel aconsejan virtualizar el servidor.
Esto lo podemos hacer mediante Vagrant o Docker. Discutiremos estas dos opciones más adelante.
Si, aún así, estás decidido a instalar Laravel de forma nativa en tu servidor local, sigue estos pasos:
Paso 1
Instala todo el software de servidor necesario para que Laravel funcione.
Empieza por instalar composer, la herramienta de instalación de dependencias de PHP. Después, durante la instalación de Laravel, el propio composer se encargará de instalar el resto del software necesario. Si no puede instalar algo, ya te avisará para que lo hagas tú manualmente.
Paso 2
Descarga Laravel usando composer.
$ composer global require "laravel/installer"
Paso 3
Instala una copia de Laravel limpia y lista para usar (en un directorio accesible por Apache o el servidor web que estés usando, claro). Puede ser que tengas que añadir el comando laravel al PATH del sistema.
$ laravel new <nombre-aplicación>
Por ejemplo:
$ laravel new blog
No olvides dar los permisos necesarios a tus archivos y directorios.
Problemas frecuentes
Lamentablemente, la lista de posibles problemas que pueden surgir durante una instalación nativa de Laravel son tantos y tan variados, dependiendo de la configuración de tu servidor, que sería imposible dar una lista exhaustiva.
Te vuelvo a recordar que los desarrolladores de Laravel desaconsejan instalarlo de este modo, pero allá tú.
Si sigues empeñado/a en hacerlo, puedes intentar seguir alguna de estas guías:
5.3.2. Laravel con Docker
Docker, como ya sabes, es una tecnología que solo virtualiza los servicios de software que nuestra aplicación necesita para funcionar en lugar de la máquina completa, como haría VirtualBox, por ejemplo.
Los servicios virtualizados se agrupan en conjuntos llamados images. Cuando una image se instancia (como quien instancia una clase en programación orientada a objetos), pasan de denominarse containers.
Laravel recomienda que todos los nuevos desarrollos. Y no solo eso, sino que desde Laravel 9 proporciona una herramienta llamada Sail, que permite desplegar un Laravel basado en Docker en cuestión de segundos.
Los pasos necesarios para lograrlo son:
Paso 1
Asegúrate de tener instalado docker y docker-compose en tu ordenador (claro).
Además, si trabajas con Windows, deberías instalar Docker Desktop y Windows Subsystem for Linux 2 (WSL2). Si trabajas con Linux, nada de esto es necesario, aunque Docker Desktop puede ser interesante.
Paso 2
Ahora vamos a instalar las imágenes Docker necesarias.
Simplemente, ve a tu carpeta de trabajo y teclea este comando:
$ curl -s https://laravel.build/mi-app | bash
(Por supuesto, puedes cambiar “mi-app” por el nombre que tú quieras).
La instalación de todas las imágenes necesarias puede tardar un poco.
Paso 3
Levanta tu servidor:
$ cd mi-app (o el directorio que hayas elegido)
$ ./vendor/bin/sail up
También puedes lanzarlo así:
$ sail up -d
¡Has terminado! El comando sail up levantará todos los contenedores Docker necesarios y pondrá en marcha tu Laravel basado en Docker.
A partir de ahora, puedes acceder a tu aplicación tecleando http://localhost en tu navegador web.
Cuando quieras detener tu servidor, solo pulsa CTRL+C o teclea:
$ sail stop