(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
ftp_nb_put — Armazena um arquivo no servidor FTP (sem bloqueio)
$ftp,$remote_filename,$local_filename,$mode = FTP_BINARY,$offset = 0ftp_nb_put() armazena um arquivo local no servidor FTP.
A diferença entre esta função e ftp_put() é que esta função envia o arquivo de forma assíncrona, para que a aplicação possa realizar outras operações enquanto o arquivo está sendo enviado.
ftpUma instância de FTP\Connection.
remote_filenameO caminho do arquivo remoto.
local_filenameO caminho do arquivo local.
mode
O modo de transferência. Deve ser FTP_ASCII ou
FTP_BINARY.
offsetA posição no arquivo remoto para iniciar o envio.
Retorna FTP_FAILED ou FTP_FINISHED
ou FTP_MOREDATA, ou false em caso de falha ao abrir o arquivo local.
| Versão | Descrição |
|---|---|
| 8.1.0 |
O parâmetro ftp agora espera uma instância de FTP\Connection;
anteriormente, um resource era esperado.
|
| 7.3.0 |
O parâmetro mode agora é opcional. Antigamente
era obrigatório.
|
Exemplo #1 Exemplo de ftp_nb_put()
<?php
// Inicia o envio
$ret = ftp_nb_put($ftp, "test.remote", "test.local", FTP_BINARY);
while ($ret == FTP_MOREDATA) {
// Faz alguma coisa
echo ".";
// Continua o envio...
$ret = ftp_nb_continue($ftp);
}
if ($ret != FTP_FINISHED) {
echo "Houve um erro ao enviar o arquivo...";
exit(1);
}
?>Exemplo #2 Continuando um envio com ftp_nb_put()
<?php
// Inicia
$ret = ftp_nb_put($ftp, "test.remote", "test.local",
FTP_BINARY, ftp_size("test.remote"));
// OU: $ret = ftp_nb_put($ftp, "test.remote", "test.local",
// FTP_BINARY, FTP_AUTORESUME);
while ($ret == FTP_MOREDATA) {
// Faz alguma coisa
echo ".";
// Continua o envio...
$ret = ftp_nb_continue($ftp);
}
if ($ret != FTP_FINISHED) {
echo "Houve um erro ao enviar o arquivo...";
exit(1);
}
?>