Hoje vou falar um pouco sobre as funções para manipulação (no PHP) do protocolo FTP, que permite o envio de arquivos entre servidores.

Falarei sobre quatro cinco tarefas básicas: abrir a conexão, fazer o login, enviar um arquivo, receber um arquivo e desconectar o FTP.

Faremos um arquivo que conterá todas essas tarefas, então vai ficar fácil entender como tudo funciona.

> Conectando-se ao FTP

Para se conectar a um servidor FTP você deve usar a função ftp_connect(), que tem três possíveis argumentos:

1. O servidor ao qual estamos tentando conexão (geralmente um ip ou domínio)
2. A porta por onde será tentada a conexão, por padrão o PHP já usa a porta 21. (opcional)
3. O timeout, que é o tempo máximo para tentar a conexão (opcional)

Então, começaremos o nosso arquivo:

< ?php
/**
* Conexão via FTP com o PHP
* 05 de maio de 2009
* Thiago Belem ~ http://blog.thiagobelem.net/
*/

// Dados do servidor
$servidor = 'thiagobelem.net'; // Endereço

// Abre a conexão com o servidor FTP
$ftp = ftp_connect($servidor); // Retorno: true ou false
?>

Até aqui, nada de misterioso… Vamos continuar.

» Veja também: Documentação da função ftp_connect()

> Fazendo login no FTP

Para fazer o login você vai usar a função ftp_login(), que tem três argumentos obrigatórios:

1. O identificador da conexão, definido no uso do ftp_connect()
2. Usuário
3. Senha

Então, fazendo algumas alterações no nosso arquivo:

< ?php
/**
* Conexão via FTP com o PHP
* 05 de maio de 2009
* Thiago Belem ~ http://blog.thiagobelem.net/
*/

// Dados do servidor
$servidor = 'thiagobelem.net'; // Endereço
$usuario = 'usuario'; // Usuário
$senha = 'senha'; // Senha

// Abre a conexão com o servidor FTP
$ftp = ftp_connect($servidor); // Retorno: true ou false

// Faz o login no servidor FTP
$login = ftp_login($ftp, $usuario, $senha); // Retorno: true ou false
?>

Vale lembrar que não estou criando nenhuma rotina de debug ou de manipulação de erros, estou partindo da premissa que os dados estão corretos e o servidor FTP está rodando, no ar.

A partir deste ponto já estamos conectados e logados no servidor FTP e podemos começar a pegar e enviar arquivos.

» Veja também: Documentação da função ftp_login()

> Enviando arquivos para o FTP (upload)

Para fazer upload de arquivos você vai usar a função ftp_put(), que tem quatro argumentos obrigatórios:

1. O identificador da conexão, definido no uso do ftp_connect()
2. Onde e com qual nome o arquivo será salvo no FTP
3. O arquivo que será enviado (local)
4. O modo de envio, pode ser FTP_ASCII ou FTP_BINARY

Então, fazendo algumas alterações no nosso arquivo:

< ?php
/**
* Conexão via FTP com o PHP
* 05 de maio de 2009
* Thiago Belem ~ http://blog.thiagobelem.net/
*/

// Dados do servidor
$servidor = 'thiagobelem.net'; // Endereço
$usuario = 'usuario'; // Usuário
$senha = 'senha'; // Senha

// Abre a conexão com o servidor FTP
$ftp = ftp_connect($servidor); // Retorno: true ou false

// Faz o login no servidor FTP
$login = ftp_login($ftp, $usuario, $senha); // Retorno: true ou false

// Define variáveis para o envio de arquivo
$local_arquivo = './arquivos/documento.doc'; // Localização (local)
$ftp_pasta = '/public_html/arquivos/'; // Pasta (externa)
$ftp_arquivo = 'documento.doc'; // Nome do arquivo (externo)

// Envia o arquivo pelo FTP em modo ASCII
$envio = ftp_put($ftp, $ftp_pasta.$ftp_arquivo, $local_arquivo, FTP_ASCII); // Retorno: true / false

?>

Com isso você já vai poder conectar-se a um FTP e enviar arquivos dinamicamente, o que é muito útil.

» Veja também: Documentação da função ftp_put()

> Recebendo arquivos pelo FTP (download)

Para fazer download de arquivos você vai usar a função ftp_get(), que tem quatro argumentos obrigatórios, os mesmos do ftp_put():

1. O identificador da conexão, definido no uso do ftp_connect()
2. Onde e com qual nome o arquivo está salvo no FTP
3. Onde o arquivo que será salvo (local)
4. O modo de envio, pode ser FTP_ASCII ou FTP_BINARY

Então, fazendo algumas alterações no nosso arquivo:

< ?php
/**
* Conexão via FTP com o PHP
* 05 de maio de 2009
* Thiago Belem ~ http://blog.thiagobelem.net/
*/

// Dados do servidor
$servidor = 'thiagobelem.net'; // Endereço
$usuario = 'usuario'; // Usuário
$senha = 'senha'; // Senha

// Abre a conexão com o servidor FTP
$ftp = ftp_connect($servidor); // Retorno: true ou false

// Faz o login no servidor FTP
$login = ftp_login($ftp, $usuario, $senha); // Retorno: true ou false

// ======

// Define variáveis para o envio de arquivo
$local_arquivo = './arquivos/documento.doc'; // Localização (local)
$ftp_pasta = '/public_html/arquivos/'; // Pasta (externa)
$ftp_arquivo = 'documento.doc'; // Nome do arquivo (externo)

// Envia o arquivo pelo FTP em modo ASCII
$envia = ftp_put($ftp, $ftp_pasta.$ftp_arquivo, $local_arquivo, FTP_ASCII); // Retorno: true / false

// ======

// Define variáveis para o recebimento de arquivo
$local_arquivo = './arquivos/planilha.xls'; // Localização (local)
$ftp_pasta = '/public_html/arquivos/'; // Pasta (externa)
$ftp_arquivo = 'planilha.xls'; // Nome do arquivo (externo)

// Recebe o arquivo pelo FTP em modo ASCII
$recebe = ftp_get($ftp, $ftp_pasta.$ftp_arquivo, $local_arquivo, FTP_ASCII); // Retorno: true / false

?>

» Veja também: Documentação da função ftp_get()

> Desconectando-se do FTP

Para se desconectar (faça isso, sempre) você vai usar a função ftp_close(), que tem apenas um argumento: o identificador da conexão.

Então, finalizando o no nosso arquivo:

< ?php
/**
* Conexão via FTP com o PHP
* 05 de maio de 2009
* Thiago Belem ~ http://blog.thiagobelem.net/
*/

// Dados do servidor
$servidor = 'thiagobelem.net'; // Endereço
$usuario = 'usuario'; // Usuário
$senha = 'senha'; // Senha

// Abre a conexão com o servidor FTP
$ftp = ftp_connect($servidor); // Retorno: true ou false

// Faz o login no servidor FTP
$login = ftp_login($ftp, $usuario, $senha); // Retorno: true ou false

// ======

// Define variáveis para o envio de arquivo
$local_arquivo = './arquivos/documento.doc'; // Localização (local)
$ftp_pasta = '/public_html/arquivos/'; // Pasta (externa)
$ftp_arquivo = 'documento.doc'; // Nome do arquivo (externo)

// Envia o arquivo pelo FTP em modo ASCII
$envia = ftp_put($ftp, $ftp_pasta.$ftp_arquivo, $local_arquivo, FTP_ASCII); // Retorno: true / false

// ======

// Define variáveis para o recebimento de arquivo
$local_arquivo = './arquivos/planilha.xls'; // Localização (local)
$ftp_pasta = '/public_html/arquivos/'; // Pasta (externa)
$ftp_arquivo = 'planilha.xls'; // Nome do arquivo (externo)

// Recebe o arquivo pelo FTP em modo ASCII
$recebe = ftp_get($ftp, $ftp_pasta.$ftp_arquivo, $local_arquivo, FTP_ASCII); // Retorno: true / false

// Encerra a conexão ftp
ftp_close($ftp);

?>

Com esse arquivo você tem exemplos simples de como usar as tarefas básicas de uma conexão via protocolo FTP. É claro que existem várias outras funções relacionadas ao tamanho de arquivos, CHMOD (permissões), pastas e etc… Por isso vale a pena dar uma olhada na lista de funções FTP do PHP.

» Veja também: Lista de funções FTP

Você também vai gostar de ler:

• Conexão MySQL – Servidor Local e Externo
• Como criar um Sistema de Login com Níveis de Permissão
• Criando um sistema de login com PHP e MySQL
• Enviar e-mails pelo PHP usando o PHPMailer
• Orientação a Objetos – Material Básico

Gostou desse artigo?

Não se esqueça de assinar o RSS e divulgue-o para o mundo: