depurar-y-testear

Skill: Depurar y Testear en FacturaScripts

Activar el modo debug

Editar config.php en la raíz de FacturaScripts:

define('FS_DEBUG', true);

Esto activa la barra de debug en la parte inferior derecha con información de queries, logs y errores.

Mostrar mensajes y errores

use FacturaScripts\Core\Tools;

// Info (mensaje informativo)
Tools::log()->info('Mensaje informativo');

// Warning
Tools::log()->warning('Atención: algo no está bien');

// Error
Tools::log()->error('Ha ocurrido un error');

// Error con traducción
Tools::log()->error('campo-obligatorio', ['%field%' => 'Nombre']);

// Mostrar en la interfaz (toast)
Tools::log('audit')->info('Acción completada');

Ver logs

Los logs se almacenan en la tabla logmessages y se pueden ver desde Administrador → Log.

Reconstruir Dinamic

Cuando los cambios no se reflejan, hacer clic en Administrador → Plugins → Reconstruir o activar/desactivar el plugin.

Tests unitarios con PHPUnit

Atajo con fsmaker

Para generar el archivo de test base y ejecutarlos, usa:

# Crear un nuevo test
fsmaker test

# Ejecutar todos los tests del proyecto
fsmaker run-tests

Archivo: Test/MiPluginTest.php

<?php

namespace FacturaScripts\Test\Plugins;

use FacturaScripts\Plugins\MiPlugin\Model\NombreModelo;
use PHPUnit\Framework\TestCase;

final class NombreModeloTest extends TestCase
{
    public function testCrearRegistro(): void
    {
        $modelo = new NombreModelo();
        $modelo->name = 'Test';
        $this->assertTrue($modelo->save());
        $this->assertNotEmpty($modelo->id);

        // Limpiar
        $this->assertTrue($modelo->delete());
    }

    public function testValidacion(): void
    {
        $modelo = new NombreModelo();
        $modelo->name = ''; // Inválido
        $this->assertFalse($modelo->save());
    }
}

Ejecutar los tests:

composer test
# O directamente:
vendor/bin/phpunit

Verificar estilo de código

# Verificar
composer cs-check

# Corregir automáticamente
composer cs-fix

# Análisis estático
composer phpstan