Cambios importantes de cara a FacturaScripts 2023.1

La siguiente actualización de FacturaScripts, la versión 2023.1, que llegará previsiblemente la semana que viene, incorpora muchos cambios a nivel interno para simplificar la programación. Aquí recopilamos algunos de ellos.

No rompe nada

Los cambios introducidos no rompen compatibilidad hacia atrás, por lo que si tu plugin funcionaba con la versión 2023.07, también lo hará con la 2023.1.

Fin de soporte de PHP 7.2

En esta actualización hemos elevado los requisitos mínimos a PHP 7.3. Por lo que si todavía estabas usando la 7.2 si que dejará de funcionar. Ten en cuenta que desde hace un montón de versiones estamos avisando con mensajes de advertencia en cada página de FacturaScripts.

PHP 8.2

Aunque PHP 8.2 está soportado, lo cierto es que no recomendamos su uso. Cuando se activan todos los errores todavía hay muchos avisos en esta versión. El principal problema son los modelos, cuando la tabla tiene campos nuevos con respecto al modelo, cargamos esos datos de cierta forma que a PHP ya no le gusta y que retirarán en la versión 8.3.

Estamos trabajando en nuevos modelos para solucionar este problema y de paso acercarnos a otros frameworks como Laravel.

Tools como reemplazo a ToolBox y AppSettings

Hace un par de versiones creamos la nueva clase Tools para reemplazar a ToolBox y fusionar muchas de las funciones que están dispersas en otras clases. Ahora hemos marcado tanto ToolBox como AppSettings como deprecated, por lo que hay que empezar a reemplazarlas en los plugins.

Aquí tienes un par de ejemplos de reemplazos para añadir mensajes al log:

// ANTES
$this->toolBox()->i18nLog()->notice('hola-mundo');

// AHORA
Tools::log()->notice('hola-mundo');

Para escapar html:

// ANTES
$this->descripcion = $this->toolBox()->utils()->noHtml($this->descripcion);

// AHORA
$this->descripcion = Tools::noHtml($this->descripcion);

Para llamar al traductor y traducir una cadena:

// ANTES
$this->title = $this->toolBox()->i18n()->trans('hola-mundo');

// AHORA
$this->title = Tools::lang()->trans('hola-mundo');

Para obtener opciones del panel de control:

// ANTES
$this->coddivisa = $this->toolBox()->appSettings()->get('default', 'coddivisa');

// AHORA
$this->coddivisa = Tools::settings('default', 'coddivisa');

Para fechas:

// ANTES
$this->fecha = date(ModelCore::DATE_STYLE);
$yesterday = date(ModelCore::DATE_STYLE, strtotime('-1 day'));

// AHORA
$this->fecha = Tools::date();
$yesterday = Tools::date('-1 day');

Para fecha y hora:

// ANTES
$this->fecha_hora = date(ModelCore::DATETIME_STYLE);
$creation_date = date(ModelCore::DATETIME_STYLE, strtotime('-1 hour'));

// AHORA
$this->fecha = Tools::dateTime();
$yesterday = Tools::dateTime('-1 hour');

Nuevas opciones

El nuevo core incluye mejoras en el enrutado, gestión de errores y las tareas programadas, así como una nueva cola de trabajo:

• Opciones de enrutado.
• Gestión de errores.
• Tareas programadas en el cron.
• Nueva cola de trabajos.