Instalar y Configurar Laravel PHP Framework - Mi Primer Proyecto

Laravel

En esta entrada quiero compartir parte de mi proceso de aprendizaje en el mundo de Laravel, esto es sólo una guía de iniciación de primeros pasos para instalar y configurar Laravel en una máquina con Ubuntu Linux 16.04 LTS Xenial Xerus y así poder iniciar nuestro Primer Proyecto.

Requisitos:

• Ubuntu Linux 16.04 LTS Xenial Xerus
• VirtualBox 5.2.30
• Vagrant 2.2.4
• PHP 7.3 (sudo apt install php7.3 php7.3-zip php7.3-mbstring php7.3-xml)
• Composer 1.8.6
• Ganas de aprender

La estrategia que voy a compartir aquí es la que en mi opinión se adapta bien para el desarrollo de proyectos en Laravel dentro de un equipo de desarrollo que hace uso de sistemas de control de versiones como Git, ya sea en GitHub o en GitLab. Esto permite que todo el equipo de desarrollo tengan acceso a la misma base de código fuente del proyecto Laravel con fácil configuración del entorno donde se ejecuta pensando a futuro en realizar configuraciones para Integración Continua y Despliegue Continuo.

Paso1 - Homestead Vagrant Box:

Cumpliendo con los requisitos anteriormente mencionados procedemos a instalar el Homestead Vagrant Box, esto nos permite tener una Maquina Virtual preconfigurada con todos los requerimientos para ejecutar aplicaciones en Laravel, ademas podemos configurar facilmente esta maquina virtual mediante el uso de archivos YAML.

promt$ vagrant box add laravel/homestead

Verificar que el vagrant box ha sido instalado:

promt$ vagrant box list
laravel/homestead   (virtualbox, 8.0.0-beta)

Paso 2 - Instalar CLI Laravel:

Para poder crear projectos en Laravel, podemos instalar el CLI de Laravel el cual nos permite a partir de un scallfold crear un Projecto Vacío con la estructura de Laravel.

promt$ composer global require laravel/installer

Despues de realizar este proceso de instalación, tenemos que agregar al PATH la rutal al directorio .composer/vendor/bin donde se instalan los paquetes y así poder usar de forma global el CLI de Laravel, agregar al archivo /etc/profile lo siguiente:

## Composer bin packages
export COMPOSER_BIN=$HOME/.config/composer/vendor/bin    
PATH=$PATH:$COMPOSER_BIN
export PATH

Listo, finalmente actualizar nuestro PATH y verificamos la version del CLI de Laravel instalado:

promt$ source /etc/profile

promt$ laravel -V
Laravel Installer 2.1.0

Paso 3 - Crear Proyecto:

Ahora que ya tenemos instalado el CLI de Laravel, el siguiente paso es crear un proyecto usando el comando que nos permite desde un scafflod crear un proyecto en Laravel vacío:

promt$ laravel new mi-proyecto
promt$ ls
mi-proyecto

mi-proyecto

Paso 4 - Homestead por Proyecto:

En este punto vamos a instalar y configurar los archivos necesarios para ejecutar nuestro proyecto en el Homestead Box de Vagrant, para esto tenemos que instalar el paquete homestead en nuestro proyecto:

promt$ composer require laravel/homestead --dev

Cuando ya tenemos instalado el paquete de homestead en nuestro proyecto, ahora lo que tenemos que hacer es generar los archivos Vagrantfile y Homestead.yaml, usando el comando make:

promt$ php vendor/bin/homestead make

Paso 5 - Configurar Hostname:

Cuando configuramos Homestead en nuestro proyecto, por defecto se asigna la IP 192.168.10.10 y el nombre de dominio homestead.test, ahora, tenemos que configurar nuestro archivo de hostname en nuestra maquina Linux Ubuntu agregando esta información al archivo /etc/hosts:

192.168.10.10  homestead.test

Paso 6 - Ejecutar Proyecto:

Finalmente podemos ejecutar nuestro proyecto usando Vagrant con el siguiente comando:

promt$ vagrant up

Con esto ejecutamos una maquina virtual con nuestro proyecto, para poder acceder y visualizar el proyecto usamos un navegador web para acceder al dominio configurado por defecto:

http://homestead.test/

Mi Primer Proyecto

Eso es todo:

Listo, con esto ya tenemos una instalación y configuración básica para iniciar nuestro aprendizaje en el mundo de Laravel, queda mucho por aprender, a continuación dejo unos enlaces de referencia donde podemos encontrar información adicional sobre Laravel.


Repositorio Final:
https://github.com/sebaxtian/mi-proyecto


Referencias:

Vagrant Docs
Laravel Docs
Homestead Docs