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 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.

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.

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.

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.

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.

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.