# Explorer FTP (explorerftp): documentação

> O Explorer FTP (explorerftp) é um gestor de ficheiros integrado no back-office do PrestaShop. Permite percorrer a árvore de ficheiros da loja, editar os ficheiros de texto e de código…

- Página: <https://www.datafirefly.com/pt/documentation/explorerftp/>
- Idioma: pt
- Atualizado em: 2026-09-03
- Outros idiomas: [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), [it](https://www.datafirefly.com/it/documentation/explorerftp/index.md), [pl](https://www.datafirefly.com/pl/documentation/explorerftp/index.md), [nl](https://www.datafirefly.com/nl/documentation/explorerftp/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

O **Explorer FTP** (`explorerftp`) é um gestor de ficheiros integrado no back-office do PrestaShop. Permite percorrer a árvore de ficheiros da loja, editar os ficheiros de texto e de código graças a um editor integrado, importar e descarregar ficheiros, e exportar pastas em formato ZIP, sem passar por um cliente FTP externo. Esta documentação cobre a instalação, a utilização completa, o modelo de segurança e a resolução de problemas.

## Apresentação

O Explorer FTP acrescenta uma entrada em _Parâmetros avançados_ do back-office. A partir desta interface, um colaborador com os direitos necessários pode navegar nos ficheiros da loja, abrir um editor de código com realce de sintaxe, criar pastas, renomear, copiar, mover ou eliminar elementos, importar ficheiros por arrastar e largar e gerar arquivos ZIP. O conjunto dos acessos é estritamente limitado ao diretório raiz do PrestaShop.

## Pré-requisitos

- PrestaShop 8.0 ou superior (compatível com 9.x).
- PHP 8.0 ou superior.
- Extensão PHP `ZipArchive` para as funções de exportação ZIP.

## Instalação

### A partir do back-office

1. Vá a _Módulos > Gestor de módulos_.
2. Clique em _Carregar um módulo_ e selecione o arquivo `explorerftp.zip`.
3. O módulo instala-se automaticamente e cria o seu separador de administração.

### Via FTP

1. Descompacte o arquivo e coloque a pasta `explorerftp` no diretório `/modules` da loja.
2. Em _Módulos > Gestor de módulos_, procure « Explorer FTP » e clique em _Instalar_.

Depois da instalação, a entrada **Explorer FTP** aparece no menu _Parâmetros avançados_.

## Acesso ao módulo

Abra _Parâmetros avançados > Explorer FTP_. O acesso é reservado aos perfis com permissão no separador _AdminExplorerFtp_: pode restringir a sua utilização a certos perfis de colaboradores a partir de _Equipa > Permissões_.

## Interface

### Barra de ferramentas

- **Voltar / Pasta superior / Atualizar**: navegação na árvore.
- **Trilho de navegação**: mostra o caminho atual e permite subir a qualquer nível.
- **Pesquisa**: pesquisa por nome de ficheiro ou de pasta no diretório atual e nas suas subpastas (os diretórios pesados como `vendor`, `var`, `cache`, `node_modules` e `.git` são ignorados).
- **Carregar** e **Nova pasta**: adição de ficheiros ou criação de diretórios.

### Árvore e lista

O painel lateral mostra a árvore de pastas; o painel principal lista os elementos da pasta atual com o seu tamanho, data de modificação e permissões. As colunas são ordenáveis (nome, tamanho, data). Um clique direito num elemento abre o menu de contexto completo.

## Editor de código

Um clique no ícone de edição (ou em _Modificar_ no menu de contexto) abre o ficheiro num editor de ecrã inteiro baseado no CodeMirror, com realce de sintaxe para PHP, HTML, Smarty (.tpl), Twig, CSS/SCSS/LESS, JavaScript, JSON, XML, YAML, SQL e Markdown. A pesquisa, o dobrar de código e o emparelhamento de chavetas são suportados.

- Só os tipos de ficheiro de texto e de código são editáveis (php, tpl, twig, css, js, json, xml, yml, md, sql, etc.).
- O tamanho máximo de edição é de 5 MB por ficheiro.
- Clique em _Guardar_ para escrever as alterações.

A cada gravação, é criada uma cópia de segurança datada do ficheiro em `var/explorer_backups`. São conservadas as 50 cópias mais recentes; as mais antigas são eliminadas automaticamente.

## Importação de ficheiros

Importe ficheiros por arrastar e largar na zona dedicada ou através do botão _Carregar_. Os ficheiros são colocados na pasta atual, desde que esta tenha permissão de escrita.

Por razões de segurança, os tipos de ficheiro executáveis do lado do servidor (`php`, `phtml`, `phar`, `cgi`, `sh`, etc.) são recusados na importação. Só os formatos seguros (documentos, imagens, tipos de letra, arquivos, ficheiros de texto e web) são aceites. Os ficheiros PHP existentes continuam modificáveis através do editor.

## Descarregamento e arquivos ZIP

- **Descarregar um ficheiro**: descarrega o ficheiro selecionado.
- **Descarregar ZIP**: comprime uma pasta e descarrega-a sob a forma de um arquivo ZIP datado.
- **Guardar ZIP no servidor**: gera o arquivo e guarda-o diretamente numa pasta de destino da loja, sem descarregamento.

## Operações nos ficheiros

O menu de contexto (clique direito) e as ações de linha permitem:

- **Renomear** um ficheiro ou uma pasta.
- **Copiar** ou **Mover** um elemento para outra pasta através da árvore de destino.
- **Eliminar** um ficheiro ou uma pasta (recursivamente).
- **Propriedades**: mostra o caminho, o tamanho, as datas, as permissões, o proprietário e o tipo MIME.

## Modelo de segurança

O Explorer FTP aplica várias camadas de proteção:

- **Perímetro raiz**: todas as operações estão confinadas ao diretório raiz do PrestaShop. Os caminhos fornecidos são normalizados via `realpath()` e depois verificados para impedir qualquer travessia de diretório (« path traversal »).
- **Token de segurança**: cada pedido AJAX é validado por um token de administração, comparado em tempo constante.
- **Pastas protegidas**: os diretórios críticos (`app`, `bin`, `classes`, `config`, `controllers`, `override`, `src`, `tools`, `var`, `vendor`) não podem ser eliminados.
- **Importação restrita**: lista branca de extensões e bloqueio dos tipos executáveis (ver « Importação de ficheiros »).
- **Cabeçalhos de segurança**: anti-clickjacking (`X-Frame-Options`) e anti-sniffing MIME (`X-Content-Type-Options`) nas respostas do controlador.

O Explorer FTP é uma ferramenta de administração poderosa. Reserve o seu acesso aos perfis de colaboradores de confiança e assegure-se de que o seu back-office é servido em HTTPS.

## Resolução de problemas

### « Diretório sem permissão de escrita » na importação ou na criação

A pasta de destino não tem direitos de escrita. Ajuste as permissões da pasta em causa no seu servidor.

### As funções ZIP estão indisponíveis

A extensão PHP `ZipArchive` não está instalada ou ativada no servidor. Ative-a junto do seu alojamento.

### Um ficheiro PHP não pode ser importado

É o comportamento esperado: a importação de ficheiros executáveis está bloqueada. Para modificar um ficheiro PHP existente, use o editor integrado.

Em caso de alteração infeliz de um ficheiro, recupere a versão anterior a partir de `var/explorer_backups`.

## Desinstalação

A partir de _Módulos > Gestor de módulos_, clique em _Desinstalar_ em frente do Explorer FTP. O separador de administração é retirado. Os ficheiros da loja e as cópias de segurança presentes em `var/explorer_backups` não são eliminados.