Guía para Migrar a Pro 7.2 o Superior

Accesos Rápidos

<p>Utiliza el script automático para migrar tu sistema de forma rápida y segura.</p>

<p>Sigue el proceso paso a paso si prefieres realizar la actualización manualmente.</p>

<p>Revisa todas las librerías actualizadas y sus nuevas versiones.</p>

Cambios en Dependencias y Versiones de Laravel Pro7

⚠️ IMPORTANTE:
Se ha realizado una actualización mayor del Pro7, migrando la base de código desde Laravel 5.7 a Laravel 9.x, con un requerimiento mínimo de PHP 8. Además, se han actualizado la mayoría de las dependencias y librerías para garantizar compatibilidad con las versiones más recientes de Laravel y Symfony.

Esta actualización implica cambios profundos en el core del sistema. Aunque se ha realizado una validación completa y las pruebas no han mostrado errores, recomendamos ser cuidadoso y validar las funciones críticas de su flujo de trabajo en un entorno de pruebas antes de actualizar en producción.

En caso de detectar cualquier incidencia, incompatibilidad o comportamiento inesperado, por favor repórtelo lo más rápido posible para obtener soporte y una solución inmediata.

Upgrade mayor: Laravel 5.7 → 9.x.

PHP: de 7.1.3 a PHP 8 mínimo.

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

Cambios en dependencias de Laravel

Cambios en dependencias de Desarrollo y Testing en Laravel

Actualización de dependencias

Ingresar como usuario root, nos dirigimos a la carpeta del servicio y cambiamos a la rama de actualización con el siguiente comando:

git remote set-url origin https://git.buho.la/facturaloperu/facturador/pro9.git

git fetch -p

git reset --hard origin/main

git pull origin main

git fetch all

git checkout main

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

Script de Actualización

Verificar si se encuentra el script upgrade-script.sh dentro del proyecto y darle permisos necesarios con el siguiente comando:

chmod +x upgrade-script.sh

NOTA: Verificar el número de servicio de los contenedores fpm y mariadb dentro del archivo docker-compose.yml dentro del proyecto, también es importante tener la contraseña root de la base de datos la puede encontrar el .env.

Ejecutamos el script con el comando ./upgrade-script.sh e ingresamos el número del servicio y la contraseña root de la base de datos.

Finalmente actualizará su sistema.

Comandos para actualizar

Detenemos los contenedores con el comando:

docker compose down

Entramos al archivo docker-compose.yml y actualizamos las imágenes:

rash07/php-fpm:2.0 → rash07/php-fpm:8.2

rash07/scheduling → rash07/scheduling:8.2

rash07/php7.4-supervisor → rash07/supervisor-php:8.2

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 borramos las siguientes carpetas con el comando:

rm -rf vendor node_modules composer.lock package-lock.json

Dentro del contenedor fpm instalamos las nuevas dependencias con el comando:

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 ultimo ejecutar:

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

Finalmente el sistema está actualizado.