Crear un proyecto Laravel con Composer

22 de enero de 2018
PHP

Usamos la línea de comandos para crear un proyecto de aplicación Laravel 5.5, usando Composer. Iniciamos el servidor local para desarrollo.

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:

PHP 7: Necesitamos la última versión del lenguaje PHP: 7, ya que es un requisito del propio Laravel 5.5. Para instalar PHP 7 puedes seguir uno de los pasos que se explican en el Manual de PHP.
Composer: El gestor de dependencias de PHP, composer, es otro de los requisitos para comenzar. En el Manual de Composer puedes ver las instrucciones para la instalación.

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, https://desarrolloweb.com/articulos/instalar-homestead-para-laravel5.html 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.

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 los cursos: Laravel desde cero en EscuelaIT 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.