# zip.dkh: crear y extraer archivos zip `zip.dkh` comprime carpetas en `.zip`, agrega archivos a un zip, lo extrae y lista su contenido. Usa `System.IO.Compression` de .NET a través de `Devkron.Ext.Base.dll` y viene con la distribución de Devkron 2.0. ## Cuándo usarla - Respaldar la carpeta de un sitio o los XML de un mes antes de borrarlos. - Entregar al usuario varios archivos en una sola descarga (los XML y PDF de sus facturas). - Instalar o actualizar algo que llega comprimido. ```dkl #include "zip.dkh" ``` ## Funciones | Función | Devuelve | Descripción | |---|---|---| | `zip.create(carpeta, archivo_zip)` | — | Comprime todo el contenido de `carpeta` (con subcarpetas); si el zip ya existe, lo reemplaza | | `zip.add(archivo_zip, archivo, nombre_dentro)` | — | Agrega `archivo` con el nombre `nombre_dentro` (si ya existe esa entrada, la reemplaza); crea el zip si no existe. Con `""` usa el nombre del archivo | | `zip.extract(archivo_zip, carpeta)` | — | Extrae todo en `carpeta` (la crea), sobrescribiendo | | `zip.list(archivo_zip)` | lista | Un registro por entrada, ordenado por nombre: `name`, `size` (bytes sin comprimir), `compressed`, `date` (`AAAAMMDD.HHMMSS`), `is_dir` (1/0) | - `nombre_dentro` puede llevar carpetas (`"2026-10/F-1.xml"`). Las barras invertidas se convierten en `/`. - Las entradas no llevan el nombre de la carpeta de origen: `zip.create("cfdi", …)` guarda `2026-10/F-1.xml`, no `cfdi/2026-10/F-1.xml`. ## Ejemplo: empaquetar los XML de un mes Con la carpeta `cfdi/2026-10/` (`F-1.xml`, `nota.txt` y `dia27/F-2.xml`). Usa `dir.files_deep` de [fs.dkh](/es/devkron/2.0/bibliotecas/estandar/fs.md) para buscar en las subcarpetas: ```dkl #include "dkli.dkh" #! program "respaldo xml" { #include "functions.dkh" #include "serialize.dkh" #include "fs.dkh" #include "zip.dkh" destino = "respaldo-2026-10.zip" if file.exists(destino) { do file.delete(destino) } ref xmls = dir.files_deep("cfdi/2026-10", "*.xml") for i=0; i {1} Error en 'zip.extract. (zip.extract: no existe el archivo 'no-existe.zip'Exception has been thrown by the target of an invocation.) [zip.dkl][Ln= 27] ``` Para entregar el zip como descarga en un servicio web use `httpres.file(ruta, "application/zip", "respaldo.zip")` de [http.dkh](/es/devkron/2.0/bibliotecas/estandar/http.md). ## Errores | Mensaje | Causa | |---|---| | `zip.create: no existe la carpeta '…'` | La carpeta de origen no existe | | `zip.add: no existe el archivo '…'` | El archivo que se agrega no existe | | `zip.extract: no existe el archivo '…'` / `zip.list: no existe el archivo '…'` | El zip no existe | ## Advertencias - `zip.extract` sobrescribe sin preguntar los archivos que ya existen en la carpeta de destino. Extraiga en una carpeta vacía o temporal. - Un zip que suben los usuarios puede ocupar mucho más al descomprimirse. Revise antes con `zip.list` la suma de `size` y rechace los que pasen de un límite razonable. Las entradas que intentan salir de la carpeta (`../../x`) se rechazan.