Instalación Laravel

icon picker
Cómo instalar proyectos existentes de Laravel

Si estamos trabajando en un proyecto de Laravel y usamos Git para el control de versiones, debemos saber unas cosas antes de clonar e intentar correr nuestro proyecto.
Por defecto, el archivo .gitignore no tomará en cuenta la carpeta “vendor” de Laravel, y tampoco el archivo .env (el cual es muy importante). Por ello, al clonar nuestro proyecto (usando git clone https://github.com/usuario/nombre-proyecto) debemos hacer unos pequeños ajustes para correr nuestra app. Aquí los enlistaré.
Nota: este tutorial supone que tenemos instalado Composer globalmente, aunque si queremos comprobarlo
composer - V
También seria conveniente comprobar la versión de PHP
php -v
Si te dice “… no se reconoce como un comando interno o externo,programa o archivo por lotes ejecutable” es porque no agregaste la o las carpetas a la PATH o no has guardado cambios.

Instalar las dependencias usando Composer

Una vez clonado nuestro proyecto, abriremos una terminal y nos situaremos en dicha carpeta. Una vez estando ahí ejecutaremos:
$ composer install
Automáticamente composer leerá el archivo composer.json y comenzará a instalar todas las dependencias. Así es como se ve:
Instalar dependencias de Laravel
Instalar dependencias de Laravel
Una vez que termine podemos seguir con el siguiente paso

Archivo de configuración de Laravel

Cada nuevo proyecto con Laravel, por defecto tiene un archivo .env con los datos de configuración necesarios para el mismo, cuando utilizamos un sistema de control de versiones como git, este archivo se excluye del repositorio por medidas de seguridad .
Sin embargo existe un archivo llamado .env.example que es un ejemplo de como crear un el archivo de configuración, podemos copiar este archivo desde la consola con:
$ cp .env.example .env
De esta forma ya tenemos el archivo de configuración de nuestro proyecto.
Una vez creado, procederemos a editarlo. Pero para ahorrarnos tiempo, también abriremos el archivo .env.example que contiene un ejemplo de las variables. Luce así:
Archivo .env ejemplo Laravel
Archivo .env ejemplo Laravel
Copiaremos todo el contenido en el archivo creado anteriormente, así:
archivo env para producción
archivo env para producción
A éste es el que editaremos. Pondremos nuestras contraseñas, usuarios, rutas, etcétera. Por lo regular sólo se editan las credenciales de las bases de datos:

Ejemplo de configuración base de datos Laravel
Ejemplo de configuración base de datos Laravel
Cuando terminemos, sólo guardaremos el fichero para proceder con el paso final.

Generar una clave

Laravel necesita una clave única para nuestros proyectos. La generaremos usando el comando:
$ php artisan key:generate
Esperaremos un momento y se habrá creado nuestra clave:
Crear clave para Laravel
Crear clave para Laravel
Y, si miramos nuestro archivo .env, veremos que tiene la clave dentro de él.
Archivo .env modificado con la clave generada
Archivo .env modificado con la clave generada

Base de datos y migraciones

Por lo general las bases de datos en los proyectos de Laravel se crean haciendo uso de las migraciones.
Si el proyecto que estas instalando tiene definida una base de datos para su funcionamiento, por ejemplo MySql, debes primero crearla en tu servidor local.
Desde la consola (usando MySql) podrías hacer algo similar a esto
mysql -uroot -psecret
root es tu usuario de base de datos y secret tu contraseña de MySql
Con esto habrás ingresado a la consola de MySql y desde ahí creas la base de datos con:
mysql> CREATE DATABASE tu_base_de_datos;
Posteriormente debes agregar las credenciales al archivo .env
DB_HOST=localhost
DB_DATABASE=tu_base_de_datos
DB_USERNAME=root
DB_PASSWORD=
Finalmente estarás habilitado para ejecutar la migración desde la consola usando artisan
$ php artisan migrate
Si además el proyecto cuenta con seeders que requieras ejecutar puedes usar el siguiente flag
$ php artisan migrate --seed

Assets

Laravel cuenta con elixir, una herramienta para configurar los assets de cada proyecto, su uso es opcional, y no aplica para todos los proyectos, asegúrate de verificar con el desarrollador si es necesario en el proyecto que intentas instalar.
Esta herramienta hace uso de gulp.
En este caso deberás seguir dos pasos mas antes de poder visualizar tu proyecto.
Primero ejecutar

Esto instalará todas las herramientas necesarias, posteriormente debes instalar las dependencias utilizando
bower install

Puesta en marcha

Finalmente después de revisar cada una de estas configuraciones y haber ejecutado todos los comandos necesarios, puedes ingresar a la url de tu proyecto y no deberías tener ningún problema para verlo en funcionamiento.
Espero que este tutorial te sea de mucha ayuda y puedas configurar tus proyectos sin ningún problema.
Recuerda dejar tus dudas en la sección de comentarios y no olvides compartir el contenido en redes sociales.

image.png
Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.