Saltar al contenido
Facturador

Migrar de Pro 7 a Pro 9

Si ya tienes Pro 9 y solo quieres actualizar a la última versión, esta no es tu guía: sigue la Actualización estándar.

Accesos Rápidos

Antes de empezar

  • Necesitas una suscripción activa para acceder al repositorio de Pro 9.
  • Genera un respaldo de la base de datos y de la carpeta storage (Generar copias de seguridad).
  • Si es posible, prueba la migración primero en un servidor de pruebas y valida las funciones críticas de tu flujo de trabajo (emisión, envío a SUNAT, PDF, caja) antes de hacerlo en producción.

Cambios en Dependencias y Versiones de Laravel

⚠️ IMPORTANTE:
Pro 9 migra la base de código de Laravel 5.7 a Laravel 9.x, con PHP 8.2 como versión mínima en los servidores. También se actualizaron la mayoría de las dependencias para mantener compatibilidad con Laravel 9 y Symfony 6.

En caso de detectar cualquier incidencia, incompatibilidad o comportamiento inesperado, repórtelo lo más rápido posible para obtener soporte.

Upgrade mayor: Laravel 5.7 → 9.x.

PHP: de 7.1.3 a PHP 8.2 (imágenes buhola/*:8.2.35).

Librerías: la mayoría actualizadas a versiones compatibles con Laravel 9/Symfony 6.

Paquetes reemplazados:

barryvdh/laravel-cors → fruitcake/laravel-cors

fzaninotto/faker → fakerphp/faker

Paquetes nuevos: laravel/ui, laravel/sail.

Estructura de autoload: migrada de classmap → PSR-4 con Database\Factories y Database\Seeders.


Cambios en General de Laravel

Paquete Antes Después Actualización ¿Para qué sirve?
laravel/framework 5.7.* ^9.0 Actualizado El framework Laravel en sí (MVC, routing, ORM, etc.) para crear apps.
php ^7.1.3 ^8.0 Laravel 9 exige PHP 8.0 Lenguaje base requerido

Cambios en dependencias de Laravel

Paquete Antes Después Actualización ¿Para qué sirve?
barryvdh/laravel-dompdf ^0.8.4 ^2.0 Actualizado Generar PDFs desde vistas Blade/HTML
barryvdh/laravel-cors ^0.11.3 N/A Reemplazado Middleware CORS (Cross-Origin Resource Sharing)
fruitcake/laravel-cors N/A ^2.0.5 Nuevo Middleware CORS oficial en Laravel 7+
binarytorch/larecipe ^2.4 ^2.6 Actualizado Genera documentación tipo Docs UI para Laravel
graham-campbell/markdown ^11.2 ^13.0 Actualizado Renderizar Markdown a HTML con facilidad
guzzlehttp/guzzle ^6.0 ^7.2 Actualizado Cliente HTTP para consumir APIs
hyn/multi-tenant 5.* ^5.8 Actualizado Manejo de multi-tenancy (multi-clientes) en Laravel
ifsnop/mysqldump-php ^2.9 ^2.11 Actualizado Generar backups SQL programáticamente
intervention/image ^2.5 ^2.7 Actualizado Manipulación de imágenes (resize, crop, filtros)
jenssegers/agent ^2.6 ^3.6 Actualizado Detecta dispositivo/navegador/sistema operativo
laravel/tinker ^1.0 ^2.7 Actualizado Consola interactiva REPL para Laravel
laravelcollective/html ^5.4.0 ^6.2 Actualizado Helpers para formularios y HTML en Laravel
mercadopago/dx-php 2.0.0 ^2.5 Actualizado SDK oficial de Mercadopago
mpdf/mpdf ^8.0.0 ^8.1.13 Actualizado Generación avanzada de PDFs desde HTML
mpride/qrcode ^1.0 ^1.2 Actualizado Generar códigos QR dentro de PDFs
nwidart/laravel-modules ^5.0 ^9.0 Actualizado Modulariza y organiza Laravel en módulos independientes
picqer/php-barcode-generator ^2.0 ^2.2 Actualizado Generación de códigos de barras
rap2hpoutre/laravel-log-viewer ^1.3 ^2.2 Actualizado Visualizar logs desde el navegador
robrichards/xmlseclibs 3.0.* ^3.1 Actualizado Seguridad y firmas digitales XML
setasign/fpdi ^1.8.* ^1.8 Operación modernizada Generación de PDFs básica
setasign/fpdf ^2.0 ^2.3 Actualizado Importar y manipular PDFs existentes
stevebauman/location ^6.3 ^6.6 Actualizado Detecta la ubicación geográfica por IP
symfony/process ^4.4 ^6.2 Actualizado Ejecuta comandos/procesos en el servidor
thiagoalessio/tesseract-ocr ^2.7 ^2.9 Actualizado Interfaz Tesseract (extraer texto de imágenes)
zanysoft/laravel-zip ^1.0 ^2.0 Actualizado Manejo de archivos ZIP en Laravel
laravel/ui N/A ^4.0 Nuevo Scaffolding de la interfaz (Bootstrap/Vue/etc.)

Cambios en dependencias de Desarrollo y Testing en Laravel

Paquete Antes Después Actualización ¿Para qué sirve?
fzaninotto/faker ^1.4 N/A Reemplazado Generación de datos falsos (faker clásico, abandonado)
fakerphp/faker N/A ^1.9.1 Nuevo Reemplazo oficial de Faker para Laravel 8/9
phpunit/phpunit ^7.0 ^9.5.10 Actualizado Framework de testing unitario
nunomaduro/collision ^2.0 ^6.1 Actualizado Mejora errores en CLI con mensajes claros
laravel/dusk ^4.0 ^7.0 Actualizado Testing de navegadores web con automatización
barryvdh/laravel-debugbar ^3.2.3 ^3.6 Actualizado Barra de debug visual en el navegador
filp/whoops ^2.0 ^2.14 Actualizado Pantallas de error con stacktrace bonito
mockery/mockery ^1.0 ^1.4.4 Actualizado Framework de mocks para testing
laravel/sail N/A ^1.0.1 Nuevo Entorno Docker oficial de Laravel

Actualización de dependencias

Ingresar como usuario root, ir a la carpeta del proyecto y apuntar el repositorio a Pro 9:

git remote set-url origin https://git.buho.la/facturaloperu/facturador/pro9.git
git fetch -p origin
git checkout main
git reset --hard origin/main

⚠️ Atención: git reset --hard descarta cualquier cambio local en los archivos del proyecto (por ejemplo, plantillas PDF modificadas directamente). Si tienes personalizaciones, guárdalas antes con git stash o cópialas fuera del proyecto.

NOTA: Si hay cambios en el storage que impiden el cambio de rama puede ejecutar: git checkout -- storage/app/public/skins/*.css

Script de Actualización

Verificar que se encuentre el script upgrade-script.sh dentro del proyecto y darle permisos de ejecución:

chmod +x upgrade-script.sh

NOTA: El script detecta automáticamente los contenedores (fpm, supervisor, scheduling, mariadb, nginx) y crea un respaldo automático de docker-compose.yml. Solo requerirá la contraseña root de la base de datos (la puede encontrar en el archivo .env en DB_PASSWORD).

Ejecutamos el script:

./upgrade-script.sh

El script descargará las nuevas imágenes de PHP 8.2.35 (buhola/*), recreará los servicios PHP, reinstalará las dependencias de Composer, recreará los usuarios tenancy y verificará el correcto funcionamiento del sistema.


Comandos para actualizar (Método Manual)

Si prefieres realizar la actualización de forma manual paso a paso:

Detenemos los contenedores o servicios PHP:

docker compose down

Editamos el archivo docker-compose.yml y actualizamos las imágenes a PHP 8.2.35:

  • FPM: rash07/php-fpm:2.0 (o rash07/php-fpm:8.2) → buhola/php-fpm:8.2.35
  • Scheduling: rash07/scheduling (o rash07/scheduling:8.2) → buhola/scheduling:8.2.35
  • Supervisor: rash07/php7.4-supervisor (o rash07/supervisor-php:8.2) → buhola/supervisor-php:8.2.35

Levantamos los contenedores con las imágenes actualizadas con el comando:

docker compose up -d

Ingresamos al contenedor fpm con el comando:

docker exec -it <CONTAINER_FPM> bash

Dentro del contenedor fpm eliminamos la carpeta vendor (se mantiene composer.lock para preservar las versiones exactas):

rm -rf vendor

Instalamos las dependencias con Composer:

composer install

Dentro del contenedor fpm otorgamos permisos con los siguientes comandos:

mkdir -p bootstrap/cache
mkdir -p storage/framework/{cache,sessions,testing,views}
chown -R www-data:www-data storage bootstrap/cache
chmod -R 775 storage bootstrap/cache

Dentro del contenedor fpm ejecutamos el comando:

composer dump-autoload

Ingresamos al contenedor mariadb con el comando:

docker exec -it <CONTAINER_MARIADB> bash

Dentro del contenedor mariadb iniciamos sesión root en la base de datos con el comando:

mysql -u root -p

Dentro del contenedor mariadb ingresamos a la base datos mysql con este comando:

USE mysql;

Dentro del contenedor mariadb en la base de datos mysql ingresamos la siguiente función:

DELIMITER $$

CREATE PROCEDURE drop_tenancy_users()
BEGIN
    DECLARE done INT DEFAULT FALSE;
    DECLARE username VARCHAR(100);
    DECLARE userhost VARCHAR(100);
    DECLARE cur CURSOR FOR
        SELECT User, Host FROM mysql.user WHERE User LIKE 'tenancy_%';
    DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = TRUE;

    OPEN cur;

    read_loop: LOOP
        FETCH cur INTO username, userhost;
        IF done THEN
            LEAVE read_loop;
        END IF;
        SET @s = CONCAT('DROP USER IF EXISTS `', username, '`@`', userhost, '`;');
        PREPARE stmt FROM @s;
        EXECUTE stmt;
        DEALLOCATE PREPARE stmt;
    END LOOP;

    CLOSE cur;
END$$

DELIMITER ;

Dentro del contenedor mariadb ejecutamos la función con el siguiente comando:

CALL drop_tenancy_users();

Dentro del contenedor mariadb borramos la función utilizada con el siguiente comando:

DROP PROCEDURE drop_tenancy_users;

Dentro del contenedor mariadb ejecutamos el comando:

FLUSH PRIVILEGES;

Ingresamos al contenedor fpm con el comando:

docker exec -it <CONTAINER_FPM> bash

Dentro del contenedor fpm refrescamos las contraseñas y user tenancy con el comando:

php artisan passwords

Dentro del contenedor fpm recreamos las bases de datos tenancy con el comando:

php artisan tenancy:recreate

Dentro del contenedor fpm optimizamos con el siguiente comando:

php artisan optimize:clear

Dentro del contenedor fpm otorgamos permisos con el siguiente comando:

chmod -R 777 vendor/mpdf

Y por último ejecute:

php artisan migrate && php artisan tenancy:migrate && php artisan config:cache && php artisan cache:clear && php artisan optimize:clear

Finalmente el sistema está actualizado.