> Manuales > Manual de Laravel

Vamos a comenzar un proyecto de Laravel desde cero, usando la línea de comandos y Composer. Además arrancaremos el proyecto con un servidor local para desarrollo integrado.

Crear un proyecto Laravel con Composer

Distintos modos de instalar Laravel

Existen distintos modos de instalar Laravel. En el manual estamos repasando varios de ellos. De hecho en este artículo te presentaremos el primero, pero antes de comenzar queremos aclarar unos puntos.

Laravel es un framework en constante evolución y a lo largo de las distintas versiones han aparecido diversos mecanismos para la instalación de nuevos proyectos. Un proyecto es básicamente una carpeta de tu ordenador donde se colocarán los códigos de base del framework y a partir de la cual empezarás a escribir tu propio código para crear tu aplicación web. En los primeros artículos del manual vamos justamente a explicar algunos de estos modos de creación de nuevos proyectos. A esto le llamamos "instalación de Laravel".

Pero además de la carpeta con el código del framework, a partir de la cual comenzarás a escribir tu aplicación, tienes que saber que existen diversos entornos para desarrollar con Laravel, unos más básicos y otros más avanzados. Dependiendo del entorno con el que vas a trabajar, el mecanismo de instalación de tu proyecto puede variar un poco.

Entornos para desarrollo con Laravel

En el momento actual puedes ejecutar tu proyecto Laravel en estos entornos de desarrollo, desde el más simple al más complejo:

De momento esas son las opciones que tenemos. Tendrás que decantarte por alguna de ellas. Pero si tienes PHP instalado en tu ordenador, en principio no necesitarías nada más, porque el propio PHP incluye el servidor integrado y como base de datos en la etapa de desarrollo puedes usar SQLite, por lo que en principio no necesitas MySQL.

No te preocupes por usar SQLite porque no sea la base de datos que vayas a tener en tu despliegue de Laravel en producción, ya que Laravel usa un ORM y el motor de base de datos que tengas es indiferente, ya que por dentro implementa una abstracción de la base de datos.

Lo que sí vas a necesitar es la instalación de Composer para PHP, ya que cualquier desarrollo moderno con este lenguaje requiere el gestor de dependencias instalado en tu sistema. Puedes encontrar más información en el Manual de Composer.

No es nuestra intención abrumarte con las posibilidades, sino darte una visión general. Todas las hemos descrito en capítulos más adelante en el Manual de Laravel, por lo que no te preocupes, ya que las irás conociendo a su debido tiempo.

Ahora bien, si tu pregunta es ¿Qué entorno es el mejor para mi? pues depende un poco de tu experiencia en el mundo del desarrollo y PHP, así como la pontencia de tu ordenador. Trabajar con Docker o con una máquina virtual Homestead siempre requiere un ordenador con una cantidad un poco mayor de memoria RAM (por tener que levantar las virtualizaciones donde se ejecutarán los proyectos de Laravel). Esas opciones son un poco más avanzadas y tienen más dificultad, aunque también tiene algunas ventajas. Las otras opciones de entornos de desarrollo son muy similares en prestaciones, aunque la del servidor integrado de PHP es la más rápida y fácil.

Yo de hecho recomendaría incluso usar el servidor integrado de Laravel con ``php artisan serve``` incluso antes que usar un Xampp, ya que te levantará el proyecto en la raíz de localhost, en un puerto aparte, por lo que no tendrás problemas con las carpetas donde hayas colocado tu proyecto Laravel. Laragon en Windows está mejor que Xampp, porque permite crear virtual host para no tener problemas con las carpetas. Si estás en Mac la solución más adecuada y sencilla, que requiere menos recursos del ordenador, es Valet. Si estás en Linux ahí te recomendaría irte directamente a un Homestead o Sail. Personalmente de un tiempo para aquí vengo trabajando con Sail en Mac, por la comodidad.

Mecanismos de instalación de Laravel dependiendo del entorno

Antes de terminar con estas notas previas queremos decir que los mecanismos de instalación de Laravel que hemos descrito en este artículo y el siguiente te pueden servir para cualquiera de los entornos de desarrollo que hemos comentado, excepto en el caso de que pienses usar Docker con Laravel Sail.

Si piensas usar Sail te recomendamos que vayas directamente al artículo con la guía de Laravel Sail, ya que te enseñará a instalar Laravel mediante un comando que se encargará de crear los contenedores en el proceso de instalación del proyecto.

Si ya tienes un proyecto Laravel creado donde no se instaló con el procedimiento de Sail también puedes usar Sail a posteriori. También está explicado cómo hacerlo en la guía de Sail.

Procedimiento de instalación de Laravel con Composer

En este artículo del Manual de Laravel te vamos a explicar a crear un proyecto con Laravel de una manera cómoda, para comenzar a desarrollar un proyecto con este framework de PHP. Usaremos la línea de comandos y Composer, el gestor de dependencias tradicional de PHP, pues es el método más eficiente en la actualidad.

Este procedimiento se realizará mediante la consola de comandos. Puede ser cualquier consola de comandos que tengas a mano, aunque no sería recomendable la antigua "cmd" de Microsoft. En todo caso recomendamos en Windows la consola "Power Shell" o quizás si lo prefieres otras alternativas como "Git Bash" o "Commander". En Linux y Mac usarás la consola que prefieres, pues todas son perfectamente válidas.

Al final del texto de este artículo podrás ver un vídeo donde se resumen los pasos que vamos a relatar a continuación y que te vendrá muy bien asistir en caso que tengas algunas dudas, pues el contenido está expuesto con mayor detalle que en este resumen de los pasos en texto.

Requisitos para instalar Laravel vía Composer

Para instalar Laravel en un nuevo proyecto de aplicación necesitamos cubrir un par de requisitos fundamentales:

Si estabas pensando en instalar Laravel 9 debes tener en cuenta que los requisitos son distintos. Laravel 9 solo funciona en PHP 8 en adelante.

La manera de comprobar si ya tienes estos softwares instalados en tu ordenador es, a través de la consola, lanzar un par de comandos.

Para saber si tenemos PHP instalado, al menos en PHP 7. Tienes el comando:

php --version

Para saber si tienes Composer, con una versión actualizada, puedes usar el comando:

composer --version

Comando para iniciar el proceso de instalación de Laravel

Se supone que en este paso vamos a comenzar un proyecto desde cero, en el que queremos instalar Laravel para comenzar a desarrollar.

Nos dirigimos a la carpeta de nuestro ordenador donde queremos instalar Laravel. Puede ser cualquier carpeta donde guardes tus proyectos. El comando para crear el proyecto depende de Composer. Es el siguiente:

composer create-project laravel/laravel mi-proyecto-laravel

En el siguiente comando tenemos "composer" que es el programa que se encarga de instalar Laravel en el nuevo proyecto. "create-project" es el subcomando de composer para crear un nuevo proyecto. "laravel/laravel" es el nombre del proyecto de base que vamos a usar para este nuevo proyecto creado en local, indica que es un proyecto llamado "laravel" que pertenece a la organización "laravel". Por último "mi-proyecto-laravel" es el nombre del proyecto que estamos creando.

Opcionalmente podríamos también indicar la versión de Laravel que queremos instalar, por ejemplo:

composer create-project laravel/laravel mi-proyecto-laravel 5.5.*

Este comando te creará la carpeta de tu nuevo proyecto, que tendrá el nombre en este caso de "mi-proyecto-laravel" y dentro de tal directorio colocará todos los archivos del proyecto Laravel. Podrá tardar un rato, dependiendo de la velocidad de tu conexión a Internet y de la del propio ordenador.

Nota: Otra alternativa frecuente de instalar Laravel es hacerlo a través de Homestead, creando una máquina virtual para este proyecto, en la que puedes tener todo de manera independiente, de modo que las configuraciones de un proyecto no afecten al otro. Esto se explicó a realizar en el artículo de Laravel Homestead, sin embargo, también podríamos seguir el procedimiento visto aquí y luego instalar Homestead como dependencia. Encuentras más información también en el vídeo que ves al final de este artículo.

Dados los requisitos de cada versión de Laravel, si no satisfacen con los que tienes en tu máquina, posiblemente no se instale la versión más reciente del framework. Por ejemplo, si tienes funcionando PHP 7.4 se instalará la versión 8 del framework. En el caso de necesitar instalar Laravel 9 o posteriores, tendrás que actualizar primero la versión de PHP que tienes en tu máquina. Otra vía sería instalar Laravel mediante Sail, ya que usando Docker se podrá ejecutar cualquier versión de PHP, independientemente de la que tengas instalada en tu ordenador.

Poner en marcha el proyecto Laravel con el servidor integrado en PHP 7

Realmente a partir de este punto no necesitamos nada más para poder poner en marcha el proyecto Laravel, ya que el propio PHP 7 dispone de un servidor integrado. Es decir, aunque puedas servir Laravel desde servidores web de terceros, como Apache o Nginx, no es necesario para la etapa de desarrollo, ya que PHP ya viene con un servidor que podemos lanzar desde la línea de comandos.

Puedes hacerlo mediante el siguiente comando:

php artisan serve

Al ejecutar ese comando nos aparecerá un mensaje con la ruta del servidor recién instanciado, algo como http://127.0.0.1:8000 (lo de ":8000" es el puerto, por si no has visto nunca una dirección acabada así). La salida de la consola será más o menos como la que ves en esta imagen:

Abriendo esa URL anunciada para nuestro servidor, con tu navegador preferido, deberías ver la página de bienvenida de una aplicación recién instalada con Laravel.

Nota: obviamente este servidor integrado en PHP está bastante limitado. Aunque la aplicación PHP podrá ejecutarse y funcionar en local para el desarrollo, en entornos de producción lo normal será instalar esta aplicación encima de un servidor web potente, como Apache o Nginx.

Con estas indicaciones tienes lo necesario para comenzar a usar Laravel. Puedes encontrar mucha más información para dominar este framework en el Manual de Laravel. Además, si deseas formación guiada y por vídeo te recomendamos: Curso de Laravel desde cero y el Desarrollo de APIs RESTful con Laravel también en EscuelaIT.

A continuación puedes ver un vídeo donde se muestra todo este proceso de configuración del proyecto Laravel.

Miguel Angel Alvarez

Fundador de DesarrolloWeb.com y la plataforma de formación online EscuelaIT. Com...

Manual