Exportador Nativos de Base de Datos

La versión de PiecesPHP (v7.0.4 en adelante) introdujo un nuevo motor nativo en PHP para la exportación y volcado de la base de datos (PiecesPHP\Core\Database\Export\Exporter). Este motor reemplaza la dependencia del binario del sistema mysqldump, lo que garantiza que los respaldos funcionen en cualquier sistema operativo independientemente de si los utilitarios de línea de comandos de bases de datos de bajo nivel están instalados.

---

⚡ Opciones de Exportación

El sistema de exportación (Exporter) soporta configuraciones flexibles mediante dos interfaces principales: FormatPluginInterface (Cómo se formatea la salida) y OutputPluginInterface (A dónde y cómo se guarda / comprime).

Formatos Soportados (PiecesPHP\Core\Database\Export\Plugins\)

• SqlFormat: El tradicional dump relacional DDL / DML (.sql).
• JsonFormat: Exportación serializada de array list (.json).
• CsvFormat: Valores separados por comas para cada tabla (.csv).
• XmlFormat: Esquema de jerarquía clásica (.xml).
• PhpFormat: Exportación en arreglos de sintaxis PHP (.php).

Motores de Compresión / Salida

• FileOutput: Escritura de texto plano al disco.
• GzipFileOutput: Stream comprimido (.gz).
• ZipFileOutput: Archivo ZIP estándar (.zip).
• Bz2FileOutput: Compresión Bzip2 (.bz2).
• MemoryOutput: Guardar el resultado en memoria sin tocar disco permanente.

---

🛠️ Uso Básico

use PiecesPHP\Core\BaseModel;
use PiecesPHP\Core\Database\Export\Exporter;
use PiecesPHP\Core\Database\Export\Plugins\SqlFormat;
use PiecesPHP\Core\Database\Export\Plugins\GzipFileOutput;
use PiecesPHP\Core\Database\Export\Enums\DataStyle;
use PiecesPHP\Core\Database\Export\Enums\TableStyle;

// 1. Obtener la conexión a DB actual
$db = clone (new BaseModel())->getDatabase();
$dbName = clone current(explode(';', (explode('dbname=', $db->getDSN())[1] ?? '')) ?: []);

// 2. Crear instancia del exportador
$exporter = new Exporter($db, $dbName);

// 3. Elegir formato y medio de salida (SQL + GZIP)
$exporter->setFormatPlugin(new SqlFormat());
$outputPlugin = new GzipFileOutput();
$exporter->setOutputPlugin($outputPlugin);

// 4. Ejecutar la exportación
$exporter->export([
    'filename' => basepath('dumps/respaldo-hoy.sql.gz'),
    'include_data' => true,
    'include_views' => true,
    'routines' => true,
    'remove_definer' => true, // Para facilitar la importación en otros hosts
    'table_style' => TableStyle::DROP_CREATE,
    'data_style' => DataStyle::INSERT,
    'single_transaction' => true,
    'triggers' => true,
]);

// 5. Validar resultado
if (file_exists($outputPlugin->getFilename())) {
    echo "¡Respaldo Exitoso!";
} else {
    print_r($exporter->getErrors());
}

---

🔒 Filtros Avanzados (Transformaciones y Exclusiones)

Una de las principales ventajas funcionales de la librería nativa es la capacidad de modificar los datos durante la lectura, antes de que se escriban en el dump (muy útil para pseudo-anonimizar u ocultar secretos empresariales al mandar respaldos de producción a desarrollo).

Excluir Tablas enteras o usar un WHERE global

Puedes ignorar tablas por completo con exclude_tables, o aplicar un formato de búsqueda restrictiva mediante where global.

$exporter->export([
    ...
    'exclude_tables' => [
        'pcs_logs', 
        'pcs_cache'
    ],
    'where' => [
        "TABLE_NAME" => "id > 100 AND estado = 'ACTIVO'"
    ]
]);

Mutaciones en tiempo real (transformations)

Puedes enviar un closure para transformar un tipo de campo antes de serializar un insert. Por ejemplo, encriptar forzadamente y de forma irreversible las contraseñas antes de que salgan de la BBDD.

use App\Model\UsersModel;
use PiecesPHP\Core\BaseHashEncryption;

$exporter->export([
    // ...
    'transformations' => [
        // Apuntar a una columna específica de una tabla concreta
        UsersModel::TABLE => [
            'password' => function ($val) {
                // Ofuscamos el password o inyectamos uno demo
                return BaseHashEncryption::encrypt($val, 'DEFAULT_DEMO_KEY');
            },
        ],
    ],
]);