(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.
ftp
Uma instância de FTP\Connection.
remote_filename
O caminho do arquivo remoto.
local_filename
O caminho do arquivo local.
mode
O modo de transferência. Deve ser FTP_ASCII
ou
FTP_BINARY
.
offset
A 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);
}
?>