Manual de Instalación

Facturador PRO

facturaloperu.com
2018
1
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 php7.2 y todas las librerias requeridas por el aplicativo y Laravel
Si no se instala Apache2 en conjunto con php7.2, instalarlo
Instalar Mysql, si lo desea PhpMyAdmin para hacer las primeras pruebas de base de datos
Instalar Git, Curl, Composer
Configurar el VirtualHost

2
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

como usuario Root antes que nada;

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 libapache2-php7.2

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

3
apt-get install curl

Si todo avanza correctamente, accediendo a su dominio debe mostrar una pantalla

parecida a la siguiente

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/

ya 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, dentro puede ejecutar lo siguiente para configurar el archivo .env

4
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.

a continuación

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 1. Crear base de datos mediante phpmyadmin

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

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

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

datos creada. Es turno de configurar el VirtualHost para que el proyecto se ejecute
directamente sobre su dominio.

5
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
a2enmod rewrite
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

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

php artisan storage:link

Proceso usando Laragon

Si desea probar el aplicativo en local, puede descargar la herramienta Laragon, la cual le

ofrece todos los requerimientos básicos y con unos cuantos clics tendrá el aplicativo
ejecutándose en su máquina sin problemas.

Debe descargarlo a través de ​laragon.org/download​ esta herramienta le ofrece:

Apache 2 o Nginx
Mysql 5.7
php 7.2
Composer
Git
HeidiSql
Entre otras

una vez instalado deberá activar la extensión ​PHP-SOAP, ​puede activarlo desde el panel de
herramientas si lo ha instalado sobre windows, clic derecho sobre el botón de notificación de
Laragon, ubicar el mouse sobre PHP, sobre Extensiones y pulsar sobre Soap

Figura 1. Habilitando SOAP en Laragon

Desplegar el proyecto en la carpeta ​laragon/www/ y reiniciar el servicio de Apache para

que Laragon reconozca el proyecto y automáticamente pueda acceder a la url que tendrá el
mismo nombre que su carpeta de proyecto.

7
 Figura 2. Recargar Apache

Para dirigirse a la url Laragon ofrece una manera mediante el mismo botón de notificación,
mediante www le aparecerá un menú con el nombre del aplicativo, al pulsar sobre el será
llevado al navegador directo al aplicativo.

Figura 3. Ubicando url mediante www

Despliegue y recomendaciones

8
Si el Aplicativo es obtenido mediante un archivo comprimido, este contará con todo lo
necesario listo para hacer el despliegue y comenzar a utilizar, evitará realizar comandos
típicos de una instalación de Laravel como lo son:

composer install
php artisan key:generate
php artisan migrate

Se dejará una carpeta que contiene un archivo con la extensión .sql, este debe ser
importado a Mysql, en algunos casos se debe crear con anterioridad el nombre de la base
de datos, si utiliza algún gestor de base de datos como PhpMyAdmin, HeidiSql, Navicat,
entre otros le será mucho más cómoda la importación, si por el contrario solo puede hacerlo
mediante la línea de comandos, la documentación de Mysql le puede servir en el tema,
algunos de los comandos a utilizar serán por ejemplo:

mysql -u root -p (para ingresar a la línea de comandos Mysql)

create database <nombre>; (para crear la base de datos con el nombre indicado)
use <nombre>; (acceder a la base de datos para ejecutar consultas por ejemplo “select *
from users”)
source (para ejecutar un archivo .sql)

Alojar el proyecto será únicamente descomprimirlo en la carpeta que esté predeterminada

para ver el sitio en la web, en algunos casos puede llamarse www, html, public_html entre
otros, dependerá si lo está alojando en un hosting compartido, servidor, o herramienta sea
Xampp, Laragon, etc.

Una vez colocado en la carpeta correcta deberá configurar el archivo .env que se encuentra
en la carpeta raíz del proyecto, deberá editar las siguiente sección:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=facturaloperu
DB_USERNAME=root
DB_PASSWORD=secret

Cambiando los campos de ​DB_DATABASE DB_USERNAME y ​DB_PASSWORD ​por los

correspondientes.

Podemos resumir entonces que para hacer un despliegue solo requiere descomprimir el
archivos sobre el servidor web, importar la base de datos, configurar el archivo .env y si esta
todo correcto solo tendrá que dirigirse a la url y comenzar a utilizar el aplicativo.

9
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.

10