# Explorer FTP (explorerftp) — Documentazione

> Explorer FTP (explorerftp) è un file manager integrato nel back office di PrestaShop. Consente di esplorare l'albero dei file del negozio, modificare file di testo e di codice con un…

- Pagina: <https://www.datafirefly.com/it/documentation/explorerftp/>
- Lingua: it
- Aggiornato il: 2026-07-09
- Altre lingue: [fr](https://www.datafirefly.com/documentation/explorerftp/index.md), [en](https://www.datafirefly.com/en/documentation/explorerftp/index.md), [es](https://www.datafirefly.com/es/documentation/explorerftp/index.md), [de](https://www.datafirefly.com/de/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)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

**Explorer FTP** (`explorerftp`) è un file manager integrato nel back office di PrestaShop. Consente di esplorare l'albero dei file del negozio, modificare file di testo e di codice con un editor integrato, caricare e scaricare file ed esportare cartelle in formato ZIP, senza un client FTP esterno. Questa documentazione copre l'installazione, l'utilizzo completo, il modello di sicurezza e la risoluzione dei problemi.

## Panoramica

Explorer FTP aggiunge una voce in _Parametri avanzati_ del back office. Da questa interfaccia, un dipendente con i permessi necessari può esplorare i file del negozio, aprire un editor di codice con evidenziazione della sintassi, creare cartelle, rinominare, copiare, spostare o eliminare elementi, caricare file tramite trascinamento e generare archivi ZIP. Tutti gli accessi sono rigorosamente limitati alla directory radice di PrestaShop.

## Requisiti

- PrestaShop 8.0 o superiore (compatibile con 9.x).
- PHP 8.0 o superiore.
- Estensione PHP `ZipArchive` per le funzioni di esportazione ZIP.

## Installazione

### Dal back office

1. Vai su _Moduli > Gestore dei moduli_.
2. Fai clic su _Carica un modulo_ e seleziona l'archivio `explorerftp.zip`.
3. Il modulo si installa automaticamente e crea la sua scheda di amministrazione.

### Tramite FTP

1. Decomprimi l'archivio e inserisci la cartella `explorerftp` nella directory `/modules` del tuo negozio.
2. In _Moduli > Gestore dei moduli_, cerca «Explorer FTP» e fai clic su _Installa_.

Dopo l'installazione, la voce **Explorer FTP** compare nel menu _Parametri avanzati_.

## Accesso al modulo

Apri _Parametri avanzati > Explorer FTP_. L'accesso è riservato ai profili che dispongono del permesso sulla scheda _AdminExplorerFtp_: puoi limitarne l'uso a determinati profili dipendente da _Team > Permessi_.

## Interfaccia

### Barra degli strumenti

- **Indietro / Cartella superiore / Aggiorna**: navigazione nell'albero.
- **Percorso di navigazione**: mostra il percorso corrente e consente di risalire a qualsiasi livello.
- **Ricerca**: ricerca per nome di file o cartella nella directory corrente e nelle sue sottocartelle (le directory pesanti come `vendor`, `var`, `cache`, `node_modules` e `.git` vengono ignorate).
- **Carica** e **Nuova cartella**: aggiungere file o creare directory.

### Albero ed elenco

Il pannello laterale mostra l'albero delle cartelle; il pannello principale elenca gli elementi della cartella corrente con dimensione, data di modifica e permessi. Le colonne sono ordinabili (nome, dimensione, data). Un clic destro su un elemento apre il menu contestuale completo.

## Editor di codice

Un clic sull'icona di modifica (o su _Modifica_ nel menu contestuale) apre il file in un editor a schermo intero basato su CodeMirror, con evidenziazione della sintassi per PHP, HTML, Smarty (.tpl), Twig, CSS/SCSS/LESS, JavaScript, JSON, XML, YAML, SQL e Markdown. Sono supportati la ricerca, il ripiegamento del codice e l'abbinamento delle parentesi.

- Sono modificabili solo i tipi di file di testo e di codice (php, tpl, twig, css, js, json, xml, yml, md, sql, ecc.).
- La dimensione massima modificabile è di 5 MB per file.
- Fai clic su _Salva_ per scrivere le modifiche.

A ogni salvataggio viene creata una copia di backup con marca temporale del file in `var/explorer_backups`. Vengono conservati i 50 backup più recenti; quelli più vecchi vengono eliminati automaticamente.

## Caricamento di file

Carica i file trascinandoli nell'apposita zona o tramite il pulsante _Carica_. I file vengono collocati nella cartella corrente, purché sia scrivibile.

Per motivi di sicurezza, i tipi di file eseguibili lato server (`php`, `phtml`, `phar`, `cgi`, `sh`, ecc.) vengono rifiutati al caricamento. Sono accettati solo formati sicuri (documenti, immagini, font, archivi, file di testo e web). I file PHP esistenti restano modificabili tramite l'editor.

## Download e archivi ZIP

- **Scaricare un file**: scarica il file selezionato.
- **Scaricare ZIP**: comprime una cartella e la scarica come archivio ZIP con marca temporale.
- **Salvare ZIP sul server**: genera l'archivio e lo salva direttamente in una cartella di destinazione del negozio, senza download.

## Operazioni sui file

Il menu contestuale (clic destro) e le azioni di riga consentono di:

- **Rinominare** un file o una cartella.
- **Copiare** o **Spostare** un elemento in un'altra cartella tramite l'albero di destinazione.
- **Eliminare** un file o una cartella (in modo ricorsivo).
- **Proprietà**: mostra il percorso, la dimensione, le date, i permessi, il proprietario e il tipo MIME.

## Modello di sicurezza

Explorer FTP applica diversi livelli di protezione:

- **Ambito radice**: tutte le operazioni sono limitate alla directory radice di PrestaShop. I percorsi forniti vengono normalizzati con `realpath()` e quindi verificati per impedire qualsiasi attraversamento di directory («path traversal»).
- **Token di sicurezza**: ogni richiesta AJAX è convalidata con un token di amministrazione, confrontato a tempo costante.
- **Cartelle protette**: le directory critiche (`app`, `bin`, `classes`, `config`, `controllers`, `override`, `src`, `tools`, `var`, `vendor`) non possono essere eliminate.
- **Caricamento limitato**: whitelist di estensioni e blocco dei tipi eseguibili (vedi «Caricamento di file»).
- **Intestazioni di sicurezza**: anti-clickjacking (`X-Frame-Options`) e anti-sniffing MIME (`X-Content-Type-Options`) nelle risposte del controller.

Explorer FTP è un potente strumento di amministrazione. Riservane l'accesso a profili dipendente affidabili e assicurati che il tuo back office sia servito tramite HTTPS.

## Risoluzione dei problemi

### «La directory non è scrivibile» durante il caricamento o la creazione

La cartella di destinazione non dispone dei permessi di scrittura. Regola i permessi della cartella interessata sul tuo server.

### Le funzioni ZIP non sono disponibili

L'estensione PHP `ZipArchive` non è installata o attivata sul server. Chiedi al tuo provider di hosting di attivarla.

### Non è possibile caricare un file PHP

È il comportamento previsto: il caricamento di file eseguibili è bloccato. Per modificare un file PHP esistente, utilizza l'editor integrato.

Se un file viene modificato per errore, ripristina la versione precedente da `var/explorer_backups`.

## Disinstallazione

Da _Moduli > Gestore dei moduli_, fai clic su _Disinstalla_ accanto a Explorer FTP. La scheda di amministrazione viene rimossa. I file del negozio e i backup presenti in `var/explorer_backups` non vengono eliminati.