Como transferir e sincronizar arquivos via FTP no Sublime Text

O protocolo FTP (File Transfer Protocol) é um dos meios mais populares para fazer upload de arquivos para servidores web. Portanto, é natural que a integração do Sublime Text com um cliente de FTP seja uma funcionalidade bastante desejada.

Neste post veremos em detalhes como usar o FTPSync, um dos plugins mais populares para acessar sistemas de arquivos remotos via FTP sem precisar sair do Sublime Text.

Como o próprio nome sugere, o FTPSync serve para sincronizar seu projeto com seus arquivos remotos.

A sincronização é feita a cada vez que um arquivo do projeto é salvo.

Configurando o FTPSync

Após instalar o FTPSync (de preferência usando o Package Control), você vai precisar configurar pelo menos uma conexão FTP remota.

Para isso, vá em Sublime Text > Preferences > Package Settings > FTPSync > Setup FTPSync in this folder.

Este comando cria um arquivo chamado ftpsync.settings na mesma pasta em que o arquivo que está sendo editado estiver localizado.

O arquivo ftpsync.settings armazena as configurações necessárias para a sincronização dos arquivos com o servidor FTP remoto.

Abaixo temos um exemplo de configuração mínima requerida para a sincronização:

{
    'primary': {
        host: 'ftp.meusite.com',
        username: 'fulano',
        password: 'senhasecreta',
        path: '/www/',

        upload_on_save: true,
        tls: true
    }
}

ATENÇÃO: Se você preferir não armazenar sua senha de FTP no arquivo de configurações, recomenda-se atribuir o valor null à opção password. Dessa forma, o FTPSync perguntará pela senha no momento do upload.

Como podemos notar no arquivo de opções que o FTPSync cria, usamos // antes de uma opção quando queremos desconsiderá-la ou inserir comentários no arquivo. Nesses casos, o FTPSync assume o valor padrão do arquivo de configuração global.

Como usar o FTPSync

Uma vez configurada a conexão, o upload dos arquivos é feito automaticamente a cada vez que um deles é salvo, a menos que a opção upload_on_save esteja desabilitada.

Também é possível acessar os comandos do FTPSync pelo seu menu de contexto (clique com o botão direito) ou pela Command Palette.

Parâmetros de configuração do FTPSync

• host: Endereço do servidor FTP remoto.
• username: Usuário para login no servidor FTP. Usar null para FTP anônimo.
• password: Senha de acesso ao servidor. Usar null para quer o FTPSync pergunte pela senha a cada acesso.
• path: Pasta raiz do projeto no servidor.
• upload_on_save: Define se o upload é feito ao salvar cada arquivo (true) ou se apenas manualmente (false).
• download_on_open: Verifica se existe um arquivo mais recente no servidor remoto ao abrir um arquivo (true ou false).
• overwrite_newer_prevention: Previne que arquivos mais recentes no servidor sejam sobrescritos ao salvar (true ou false).
• upload_delay: Intervalo de tempo (em segundos) entre o salvamento de um arquivo e o início do upload.
• use_tempfile: Define se deve ser usado primeiro um arquivo temporário de download a ser substituído ao final da operação (true ou false).
• encoding: Define qual o encoding a ser utilizado para os nomes de arquivo no servidor FTP.
• port: Porta do servidor remoto, geralmente é a porta 21 quando se trata de FTP.
• tls: Define o uso de transferência segura, caso o servidor remoto tenha suporte (true ou false).
• passive: Define se deve ser utilizada conexão passiva ou ativa (true ou false).
• timeout: Tempo em segundos para invalidar a conexão (default é 30s)
• ignore: Expressão regular que serve para determinar quais tipos de arquivos cujo upload deve ser ignorado
• time_offset: Tempo em segundos para ajustar em relação ao fuso horário do servidor (default é 0)
• set_remote_lastmodified: Nos casos em que a extensão MFMT estiver disponível, a data de última modificação é baseada no arquivo local (true ou false).
• default_folder_permissions: Define as permissões de acesso para novas pastas criadas no servidor (default é 755).
• default_local_permissions: Define as permissões de acesso para os arquivos baixados (default é “auto”, que significa manter as mesmas permissões do servidor).
• always_sync_local_permissions: Sincroniza as permissões dos arquivos baixados, mesmo se eles já existirem (true ou false).
• after_save_watch: Define um conjunto de pastas ou arquivos que devem ser “marcados” para upload caso tenham sido modificados após o upload automático de qualquer outro arquivo. Útil nos casos em que há algum tipo de compilação ou preprocessamento no qual os arquivos gerados também devem ser copiados para o servidor (ex.: .less -> .css)
• debug_extras: Configurações específicas para quem precisa descobrir informações específicas durante a execução do FTPSync. Mais detalhes no wiki do plugin.

Desvantagens do FTPSync

O plugin FTPSync é muito útil quando precisamos simplesmente sincronizar um projeto local com uma pasta remota via FTP. No entanto, existem alguns cenários ainda não suportados por ele, tais como:

• Conexão via SFTP (SSH File Transfer Protocol ou Secure File Transfer Protocol);
• Uso de SSL/TLS em servidores que obrigam SSL_REUSE
• Monitoramento e sincronização contínua. A sincronização é condicionada a uma ação manual, tal como salvar um arquivo ou via menu;
• Conexões através de proxy;
• Diff remoto (comparação entre arquivos);
• Caracteres especiais no caminho remoto.