MANUAL DE INSTALACIÓN

Facturador PRO

Factúralo Perú
2018
Requisitos de instalación
En la siguiente tabla se muestran las tecnologías implementadas en el aplicativo. Para
poder hacer un despliegue sin problemas se recomienda contar con las versiones
específicas para PHP y Mysql.

Tecnología Versión

PHP 7.2

Mysql 5.7

Laravel 5.6

Posibles entornos de trabajo

Se puede contar con diferentes tecnologías sobre la cual desplegar el aplicativo, pudiendo
nombrar algunas como lo son Windows Server, Ubuntu Server, Apache o Nginx, Hosting o
VPS, se recomienda y es mucho más práctico contar con un servidor propio o servicio
adquirido donde pueda gestionar las versiones de las tecnologías recomendadas para hacer
uso del aplicativo sin ningún problema.
Entorno LAMP (Linux, Apache, Mysql y PHP)
Si desea implementar sobre un servidor Linux “desde cero”​ debe:

● Contar con dominio activado en conjunto con el servidor (obligatorio)

● Contar con acceso SSH
● Contar con acceso root
● Instalar php 7.2 y todas las librerías requeridas por el aplicativo y Laravel
● Si no se instala Apache2 en conjunto con php 7.2, instalarlo individualmente
● Instalar Mysql, si lo desea PhpMyAdmin para hacer las primeras pruebas de base de
datos
● Instalar Git, Curl, Composer
● Configurar el VirtualHost

La manera de trabajar con el servidor Linux es mediante SSH, de manera que se acceda y
se pueda gestionar totalmente los requerimientos. Puede ser accedido con una herramienta
llamada Putty (multiplataforma) u otras con soporte SSH, desde una misma consola Linux o
si cuenta con ssh en windows también desde una terminal de comandos, cmd o cualquier
otra.

Suponiendo que ya ha accedido, procedemos con las instalaciones, en el siguiente

tomaremos como ejemplo Ubuntu 16.04.

Ubuntu no cuenta con la versión 7.2 de php de manera nativa por lo que se debe seguir un
par de pasos para agregar un repositorio y luego proceder con la instalación, ellos son

Para poder ejecutar los siguientes comando debe acceder a la terminal como usuario root.

● apt-get update

Para poder agregar un PPA, ejecute los siguientes:

● apt-get install software-properties-common

● apt-get install python-software-properties

Para agregar el PPA, en algunos casos solicitará confirmar con enter

● add-apt-repository ppa:ondrej/php
● apt-get update

Procedemos a Instalar ​PHP​​, aunque se instalar algunas librerías junto con PHP, se agregan
para asegurar la instalación

● apt-get install php7.2 php7.2-mbstring php7.2-soap php7.2-zip

php7.2-mysql php7.2-curl php7.2-gd php7.2-xml
Si no se instala Apache ejecutar

● apt-get install apache2

Instalamos ​Mysql​​, phpmyadmin opcional

● apt-get install mysql-server-5.7 mysql-client-5.7 phpmyadmin

Se le solicitara contraseña dos veces, con su confirmación, tanto para mysql como para
phpmyadmin

Instalamos ​Curl ​y ​Git

● apt-get install git

● apt-get install curl

Si todo avanza correctamente, accediendo la ip pública de su servidor debe mostrar una

pantalla parecida a la siguiente

Figura 1. Interfaz inicial Apache

Antes de descargar el proyecto es necesario instalar Composer

● apt-get install composer

Ahora deberá ubicarse en la carpeta /var/www/html/ ​para descargar el proyecto en esa

ubicación, en este punto con el usuario Root puede dar permisos a esa misma ruta con el
comando ​chmod -R ​y continuar con el usuario normal, puede acceder a la ruta con

● cd /var/www/html/

Una vez ubicado allí con la herramienta git, si ya se le ha compartido acceso a repositorio
ejecute lo siguiente:

● git clone https://gitlab.com/eriquegasparcarlos/multifacturalo.git

Esto creará una carpeta llamada multifacturalo, luego de la descarga puede entrar en la
carpeta con ​cd multifacturalo​​, dentro de ella puede ejecutar lo siguiente para configurar el
archivo .env

● cp .env.example .env

De esta manera creará el archivo .env a partir del ejemplo, donde deberá editar las líneas

● APP_URL_BASE=multifacturalo.oo
● DB_DATABASE=multifacturalo
● DB_USERNAME=root
● DB_PASSWORD=

Donde APP_URL_BASE corresponde a su dominio, DB_DATABASE será el nombre que le

de a la base de datos principal, DB_USERNAME y DB_PASSWORD equivalen al usuario
creado anteriormente en la instalación de mysql.

Seguidamente:

● php artisan key:generate

Luego deberá registrar la base de datos mediante phpmyadmin, accediendo a la ruta

sudominio.com/phpmyadmin ​con el usuario root y contraseña agregada en la instalación
entrará en el panel, la siguiente imagen muestra la sección de creación de una nueva base
de datos.
 Figura 2. Crear base de datos mediante phpmyadmin

Si todo marcha bien es hora de agregar los paquetes faltante en el proyecto y ejecutar las
migraciones.

Ingrese a la carpeta del proyecto:

● cd /var/www/html/multifacturalo
● composer install
● php artisan migrate --seed

Puede verificar actualizando phpmyadmin, en la lista de la izquierda se mostrará la base de

datos creada y la derecha las tablas generadas.

Ahora es turno de configurar el VirtualHost para que el proyecto se ejecute directamente

sobre su dominio.

Como usuario root nuevamente dirigirse a la ruta de configuraciones de apache y crear un

nuevo archivo, ejecute lo siguiente

● cd /etc/apache2/sites-availables/
● touch multifacturalo.conf
● cd sites-availables
● nano multifacturalo.conf

Se abrirá un editor de textos en la consola donde deberá agregar lo siguiente:

<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot /var/www/html/​multifacturalo​/public
​ServerName sudominio.com
ServerAlias *.sudominio.com

<Directory /var/www/html/​multifacturalo​/public>
Options +FollowSymlinks
AllowOverride All
Require all granted
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Donde ​sudominio.com equivale al dominio adquirido luego debera guardar, puede hacerlo
con las teclas ​ctrl+x donde se le pedirá confirmación, deberá presionar la tecla ​Y y ​enter, ​al
finalizar solo debe ejecutar los siguientes comandos.

● a2dissite 000-default.conf
● a2ensite multifacturalo.conf
● service apache2 restart

Con estos pasos podrá observar el aplicativo en su dominio, en algunos casos si tiene
problemas para observar el aplicativo puede deberse a los permisos en las carpetas del
proyecto, principalmente storage y cache requieren el siguiente comando

● cd /var/www/html/multifacturalo
● chmod -R 755 storage
● chmod -R 755 bootstrap/cache

También es necesario ejecutar el siguiente comando para establecer la ruta de los archivos
cargados de la empresa

● php artisan storage:link

Entorno WAMP (Windows, Apache, Mysql y PHP)
En esta ocasión se hará uso de Laragon para realizar la instalación en windows. ​Laragon es
una suite de desarrollo para PHP que funciona sobre Windows diseñado especialmente
para trabajar con Laravel. Similar a otras herramientas como Xampp o Wamp, Laragon nos
permite crear un entorno de desarrollo con estas características:

● Cmder (Consola para Windows)

● Git
● Node.js
● npm
● SSH
● Putty
● PHP 7 / 5.6
● Extensiones de PHP
● xDebug
● Composer
● Apache
● MariaDB/MySQL
● phpMyAdmin
● Soporte para Laravel y Lumen
● Gestión automática de Virtualhosts.

Puede descargarlo a través del siguiente enlace: ​laragon.org/download

Instalación Laragon
Una vez descargado laragon, ejecute el programa, visualizará la siguiente ventana,

● Seleccione “Ejecutar”.

Figura 3. Ejecutar laragon

● Elija el idioma del programa

Figura 4. Idioma

● Clic en el botón “Siguiente”

Figura 5. Asistente

● Elija la ubicación en la cual se instalará el programa

Figura 6. Ubicación
● Seleccione las opciones, de clic en “Siguiente”

Figura 7. Opciones

● Seleccione “Instalar”

Figura 8. Instalar

● Espere a que culmine la instalación

Figura 9. Progreso instalación

 ● Clic en Finalizar para culminar la instalación

Figura 10. Instalación finalizada

Configuración Laragon
Laragon crea un dominio por cada proyecto que se encuentre ubicado en la carpeta www, a
continuación se muestra la configuración para cambiar el dominio.

Diríjase al ícono con forma de engranaje, de clic, le mostrará la siguiente ventana, en la

parte inferior “Hostname”, podrá cambiarlo.
● Ejemplo: {name}.test - {name}.oo - {name}.pe

Figura 11. Configuración Hostname

Diríjase a la pestaña Servicios & Puertos, para cambiar el puerto de apache, mysql, o
cambiar de servidor, dependiendo de sus requerimientos.

Figura 12. Configuración Apache - Mysql

A continuación deberá activar la extensión ​SOAP, ​diríjase a laragon y seleccione la opción

“Menú”, realice lo que visualiza en la imágen.

Figura 13. Habilitar SOAP

Configuración del proyecto
En la carpeta www de laragon encontrará todo sus proyectos, puede ubicarla en el directorio
que seleccionó al momento de la instalación o siguiendo los pasos de la imágen.

Figura 14. Directorio

En este caso ahi se realizará la instalación del proyecto, use la terminal de laragon y
ubíquese en la carpeta “F:\laragon\www”, la ubicación cambiará dependiendo de donde
haya instalado el programa.

Cuando se encuentre en dicha ruta, ejecute el siguiente comando:

● git clone ​https://gitlab.com/eriquegasparcarlos/multifacturalo.git

Le solicitará su usuario y password de gitlab, debe escribirlos para que puede continuar el
proceso.

Figura 15. Clonar proyecto

Cuando termine de descargar el proyecto, ingrese a la carpeta del proyecto, use el siguiente
comando en la terminal.
● cd multifacturalo

Ubicado en la carpeta del proyecto, instale las dependencias, ejecutando el siguiente

comando.
● composer install

Figura 16. Instalar dependencias

Consecuentemente debe crear el archivo ​.env dentro de la carpeta del proyecto, tome como
referencia las variables que se encuentran en el archivo ​.env.example, ​tenga en cuenta que
la variable ​APP_URL_BASE ​de tener el valor que asignó anteriormente en la configuración
del ​Hostname​​, en este caso es ​APP_URL_BASE=multifacturalo.oo​​, donde multifacturalo
es el nombre de la carpeta del proyecto.

Figura 17. Archivo .env

Ahora debe crear la base de datos principal, en este caso se llamará ​multifacturalo​​, y así
debe estar configurada en el archivo .env.

Figura 18. Crear base de datos

Después de ello, diríjase a la carpeta de su proyecto usando la terminal, y ejecute los

siguientes comandos.
● php artisan key:generate
● composer dump-autoload
● php artisan migrate --seed
● php artisan storage:link

Figura 19. Configuración BD

Si todo se realizó correctamente, ya tendrá las tablas del usuario principal creadas, y podrá
acceder mediante la web, al proyecto.

Accesos:
● usuario: ​admin@gmail.com
● contraseña: 123456

Figura 20. Login Principal

Cuando acceda a la aplicación podrá crear los clientes, en este caso crearemos uno de
prueba con los parámetros que se muestran en la imágen.

Más información, puede consultar el ​Manual de Usuario​.

Figura 21. Registrar cliente

Al crear el cliente, se generará automáticamente su base de datos, por lo tanto, cada cliente
tendrá su base de datos, ahora hay que configurar los hosts en laragon.

Para realizar la configuración de los hosts diríjase a laragon y en la esquina superior

derecha, de clic en la letra “h”.

Figura 22. Ubicar hosts

Se le abrirá el archivo de hosts, en el cual debe escribir lo siguiente.

● 127.0.0.1 miprueba.multifacturalo.oo

Donde miprueba es el subdominio que se registró al momento de crear el cliente, por lo

tanto cada vez que registre un cliente debe registrar su subdominio en el archivo hosts.

Figura 23. Archivo hosts

Guarde los cambios y reinicie laragon. Ahora podrá acceder al aplicativo y realizar sus
operaciones.
● Url prueba: ​http://miprueba.multifacturalo.oo:8084/login

Figura 24. Login cliente

Soporte y mantenimiento

Actualizaciones

Existe una vía práctica de actualización, utilizando la herramienta git, se puede utilizar si el
sistema ha sido descargado en el servidor de producción mediante la misma, de no ser así,
las actualizaciones se realizarán de manera manual sobre el proyecto, como la primera
entrega, será entregado un archivo comprimido el cual vendrá con la lista de archivos
actualizados de manera que tendrá que reemplazar dichos archivos, o bien podrá
reemplazar el proyecto completo.

Soporte

Existen algunos manuales creados para comprender el uso del sistema que le será enviado
vía email, además estarán disponibles en todo momento en la web, bien sea vía Google
Drive, Google Docs, Dropbox, entre otros.

Contará también con una sesión en Slack donde estará disponible un grupo para comunicar
los eventos o inconvenientes y será atendido a la mayor brevedad posible.

Sugerencias
Si desea realizar modificaciones al proyecto, por ejemplo cambios de diseño en el pdf, u
otros, realicelo un servidor diferente al que se le haya hecho la instalación, ello con el fin de
que cuando haya actualizaciones por parte de Factúralo Perú, puede obtenerlas sin ningún
inconveniente.