Administrar las importaciones de datos desde archivos de Excel a menudo puede ser un proceso engorroso en aplicaciones PHP. Ya sea que esté creando un CRM, un sistema de inventario o cualquier aplicación basada en datos, manejar archivos de Excel con varias estructuras y formatos es un requisito común. Para facilitar este proceso, me complace presentarles ExcelMapper, una biblioteca PHP diseñada para simplificar el mapeo, el análisis y la importación de datos de Excel en sus aplicaciones PHP.

En este artículo, lo guiaré a través de las características clave de ExcelMapper, le mostraré cómo instalarlo y configurarlo y le brindaré algunos ejemplos prácticos para ayudarlo a comenzar.

Instalación

Instalar ExcelMapper es sencillo usando Composer. Si aún no has instalado Composer, puedes hacerlo aquí. Una vez que Composer esté instalado, puede requerir ExcelMapper en su proyecto:

composer require esmaeil/excelmapper

Empezando
Comencemos creando un ejemplo básico de cómo usar ExcelMapper para importar datos desde un archivo de Excel.

Paso 1: Prepare su archivo de Excel
Imagina que tienes un archivo Excel clientes.xlsx con la siguiente estructura:

| First Name | Last Name | Phone Number |
|------------|-----------|--------------|
| John       | Doe       | ۱۲۳۴۵۶۷۸۹۰   |
| Jane       | Smith     | 9876543210   |

Paso 2: Crear un analizador personalizado (opcional)
ExcelMapper viene con DefaultParser que simplemente devuelve el valor de la celda. Sin embargo, es posible que desees crear analizadores personalizados para manejar una lógica más compleja, como formatear números de teléfono o dividir nombres completos.

Aquí hay un ejemplo de un analizador personalizado que convierte dígitos persas/árabes a dígitos en inglés:

namespace ExcelMapper\Parsers;

use ExcelMapper\Interfaces\ColumnParserInterface;
use ExcelMapper\Utils\DataHelper;

class DigitConversionParser implements ColumnParserInterface
{
    public function parse($value)
    {
        return DataHelper::convertDigits($value);
    }
}

Paso 3: Definir asignaciones de columnas
A continuación, defina cómo se debe asignar y analizar cada columna de su archivo de Excel:

use ExcelMapper\DataProcessor\ExcelDataProcessor;
use ExcelMapper\Readers\ExcelReader;
use ExcelMapper\Parsers\DefaultParser;
use ExcelMapper\Parsers\DigitConversionParser;

// Define custom column mapping
$mapping = [
    ['first_name', DefaultParser::class],
    ['last_name', DefaultParser::class],
    ['phone_number', DigitConversionParser::class], // Convert digits to English
];

Ejemplo de uso de ExcelMapper

// Read Excel file
$reader = new ExcelReader();
$sheetData = $reader->read('path_to_file.xlsx');

// Process the data
$processor = new ExcelDataProcessor();
$processor->process($sheetData, $mapping, function($mappedData) {
    // Handle the mapped data (e.g., save to database)
    print_r($mappedData);
});

Extensión de ExcelMapper
ExcelMapper está diseñado para ser extensible. Puede agregar fácilmente sus propios analizadores y lectores o modificar los existentes para adaptarlos a sus necesidades específicas. Por ejemplo, puede crear un lector personalizado para archivos CSV o ampliar la clase ExcelDataProcessor para agregar pasos de procesamiento adicionales.

Conclusión
ExcelMapper es una herramienta potente y flexible para gestionar las importaciones de datos de Excel en PHP. Con sus asignaciones de columnas personalizables y su arquitectura extensible, puede manejar una amplia gama de casos de uso, desde simples importaciones de datos hasta transformaciones de datos complejas.

Si tiene alguna pregunta, comentario o contribución, no dude en abrir un problema o realizar una solicitud en GitHub. ¡Hagamos juntos la importación de datos en PHP más fácil!

GitHub