# Explorer FTP (explorerftp) — Documentación

> Explorer FTP (explorerftp) es un gestor de archivos integrado en el back office de PrestaShop. Permite explorar el árbol de archivos de la tienda, editar archivos de texto y de…

- Página: <https://www.datafirefly.com/es/documentation/explorerftp/>
- Idioma: es
- Actualizado el: 2026-07-09
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/explorerftp/index.md), [en](https://www.datafirefly.com/en/documentation/explorerftp/index.md), [de](https://www.datafirefly.com/de/documentation/explorerftp/index.md), [it](https://www.datafirefly.com/it/documentation/explorerftp/index.md), [pl](https://www.datafirefly.com/pl/documentation/explorerftp/index.md), [pt](https://www.datafirefly.com/pt/documentation/explorerftp/index.md), [nl](https://www.datafirefly.com/nl/documentation/explorerftp/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

**Explorer FTP** (`explorerftp`) es un gestor de archivos integrado en el back office de PrestaShop. Permite explorar el árbol de archivos de la tienda, editar archivos de texto y de código con un editor integrado, subir y descargar archivos, y exportar carpetas en formato ZIP, sin necesidad de un cliente FTP externo. Esta documentación cubre la instalación, el uso completo, el modelo de seguridad y la resolución de problemas.

## Presentación

Explorer FTP añade una entrada en _Parámetros avanzados_ del back office. Desde esta interfaz, un empleado con los permisos necesarios puede explorar los archivos de la tienda, abrir un editor de código con resaltado de sintaxis, crear carpetas, renombrar, copiar, mover o eliminar elementos, subir archivos mediante arrastrar y soltar, y generar archivos ZIP. Todos los accesos se limitan estrictamente al directorio raíz de PrestaShop.

## Requisitos

- PrestaShop 8.0 o superior (compatible con 9.x).
- PHP 8.0 o superior.
- Extensión PHP `ZipArchive` para las funciones de exportación ZIP.

## Instalación

### Desde el back office

1. Ve a _Módulos > Gestor de módulos_.
2. Haz clic en _Subir un módulo_ y selecciona el archivo `explorerftp.zip`.
3. El módulo se instala automáticamente y crea su pestaña de administración.

### Mediante FTP

1. Descomprime el archivo y coloca la carpeta `explorerftp` en el directorio `/modules` de la tienda.
2. En _Módulos > Gestor de módulos_, busca «Explorer FTP» y haz clic en _Instalar_.

Tras la instalación, la entrada **Explorer FTP** aparece en el menú _Parámetros avanzados_.

## Acceso al módulo

Abre _Parámetros avanzados > Explorer FTP_. El acceso está reservado a los perfiles con permiso sobre la pestaña _AdminExplorerFtp_: puedes restringir su uso a determinados perfiles de empleado desde _Equipo > Permisos_.

## Interfaz

### Barra de herramientas

- **Atrás / Carpeta superior / Actualizar**: navegación por el árbol.
- **Ruta de navegación**: muestra la ruta actual y permite volver a cualquier nivel.
- **Búsqueda**: busca por nombre de archivo o carpeta en el directorio actual y sus subcarpetas (se omiten los directorios pesados como `vendor`, `var`, `cache`, `node_modules` y `.git`).
- **Subir** y **Nueva carpeta**: añadir archivos o crear directorios.

### Árbol y lista

El panel lateral muestra el árbol de carpetas; el panel principal lista los elementos de la carpeta actual con su tamaño, fecha de modificación y permisos. Las columnas se pueden ordenar (nombre, tamaño, fecha). Al hacer clic derecho sobre un elemento se abre el menú contextual completo.

## Editor de código

Al hacer clic en el icono de edición (o en _Editar_ del menú contextual) se abre el archivo en un editor a pantalla completa basado en CodeMirror, con resaltado de sintaxis para PHP, HTML, Smarty (.tpl), Twig, CSS/SCSS/LESS, JavaScript, JSON, XML, YAML, SQL y Markdown. Se admiten la búsqueda, el plegado de código y el emparejamiento de llaves.

- Solo son editables los tipos de archivo de texto y código (php, tpl, twig, css, js, json, xml, yml, md, sql, etc.).
- El tamaño máximo editable es de 5 MB por archivo.
- Haz clic en _Guardar_ para escribir los cambios.

En cada guardado se crea una copia de seguridad con marca de tiempo del archivo en `var/explorer_backups`. Se conservan las 50 copias más recientes; las más antiguas se eliminan automáticamente.

## Subida de archivos

Sube archivos arrastrándolos a la zona correspondiente o mediante el botón _Subir_. Los archivos se colocan en la carpeta actual, siempre que tenga permisos de escritura.

Por motivos de seguridad, los tipos de archivo ejecutables en el servidor (`php`, `phtml`, `phar`, `cgi`, `sh`, etc.) se rechazan en la subida. Solo se aceptan formatos seguros (documentos, imágenes, fuentes, archivos comprimidos, archivos de texto y web). Los archivos PHP existentes siguen siendo editables desde el editor.

## Descarga y archivos ZIP

- **Descargar un archivo**: descarga el archivo seleccionado.
- **Descargar ZIP**: comprime una carpeta y la descarga como archivo ZIP con marca de tiempo.
- **Guardar ZIP en el servidor**: genera el archivo y lo guarda directamente en una carpeta de destino de la tienda, sin descargarlo.

## Operaciones con archivos

El menú contextual (clic derecho) y las acciones de fila permiten:

- **Renombrar** un archivo o una carpeta.
- **Copiar** o **Mover** un elemento a otra carpeta mediante el árbol de destino.
- **Eliminar** un archivo o una carpeta (de forma recursiva).
- **Propiedades**: muestra la ruta, el tamaño, las fechas, los permisos, el propietario y el tipo MIME.

## Modelo de seguridad

Explorer FTP aplica varias capas de protección:

- **Ámbito raíz**: todas las operaciones se limitan al directorio raíz de PrestaShop. Las rutas proporcionadas se normalizan con `realpath()` y se verifican para impedir cualquier salto de directorio («path traversal»).
- **Token de seguridad**: cada solicitud AJAX se valida con un token de administración, comparado en tiempo constante.
- **Carpetas protegidas**: los directorios críticos (`app`, `bin`, `classes`, `config`, `controllers`, `override`, `src`, `tools`, `var`, `vendor`) no se pueden eliminar.
- **Subida restringida**: lista blanca de extensiones y bloqueo de los tipos ejecutables (ver «Subida de archivos»).
- **Cabeceras de seguridad**: anti-clickjacking (`X-Frame-Options`) y anti-sniffing MIME (`X-Content-Type-Options`) en las respuestas del controlador.

Explorer FTP es una potente herramienta de administración. Reserva su acceso a perfiles de empleado de confianza y asegúrate de que tu back office se sirva por HTTPS.

## Resolución de problemas

### «El directorio no tiene permisos de escritura» al subir o crear

La carpeta de destino no tiene permisos de escritura. Ajusta los permisos de la carpeta correspondiente en tu servidor.

### Las funciones ZIP no están disponibles

La extensión PHP `ZipArchive` no está instalada o activada en el servidor. Solicita a tu proveedor de alojamiento que la active.

### No se puede subir un archivo PHP

Es el comportamiento esperado: la subida de archivos ejecutables está bloqueada. Para modificar un archivo PHP existente, utiliza el editor integrado.

Si un archivo se edita por error, recupera la versión anterior desde `var/explorer_backups`.

## Desinstalación

Desde _Módulos > Gestor de módulos_, haz clic en _Desinstalar_ junto a Explorer FTP. Se elimina la pestaña de administración. Los archivos de la tienda y las copias de seguridad presentes en `var/explorer_backups` no se eliminan.