ftp_nb_put
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
ftp_nb_put — FTP サーバーにファイルを保存する（非ブロッキング）
説明
ftp_nb_put(
FTP\Connection
string
string
int
int
): int|false
FTP\Connection
$ftp,string
$remote_filename,string
$local_filename,int
$mode = FTP_BINARY,int
$offset = 0): int|false
ftp_nb_put() はローカルファイルを FTP サーバーに保存します。
ftp_put() との違いは、この関数が 非同期処理でファイルをアップロードするということです。そのため、 ファイルをアップロードしている最中に別の処理を行うことができます。
パラメータ
ftp-
FTP\Connection クラスのインスタンス
remote_filename-
リモートファイルのパス。
local_filename-
ローカルファイルのパス。
mode-
転送モード。
FTP_ASCIIまたはFTP_BINARYのどちらかを指定する必要があります。 offset-
リモートファイル内での、アップロード開始位置。
戻り値
FTP_FAILED、FTP_FINISHED
あるいは FTP_MOREDATA を返します。
ローカルファイルのオープンに失敗した場合、false を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 8.1.0 |
引数 ftp は、FTP\Connection
のインスタンスを期待するようになりました。
これより前のバージョンでは、リソース を期待していました。
|
| 7.3.0 |
mode パラメータはオプションになりました。
これより前のバージョンでは、このパラメータは必須でした。
|
例
例1 ftp_nb_put() の例
<?php
// アップロードを開始する
$ret = ftp_nb_put($ftp, "test.remote", "test.local", FTP_BINARY);
while ($ret == FTP_MOREDATA) {
// 何かお好みの動作を
echo ".";
// アップロードを継続する…
$ret = ftp_nb_continue($ftp);
}
if ($ret != FTP_FINISHED) {
echo "There was an error uploading the file...";
exit(1);
}
?>例2 ftp_nb_put() でアップロードを再開する
<?php
// 開始
$ret = ftp_nb_put($ftp, "test.remote", "test.local",
FTP_BINARY, ftp_size("test.remote"));
// あるいは: $ret = ftp_nb_put($my_connection, "test.remote", "test.local",
// FTP_BINARY, FTP_AUTORESUME);
while ($ret == FTP_MOREDATA) {
// 何かお好みの動作を
echo ".";
// アップロードを継続する…
$ret = ftp_nb_continue($ftp);
}
if ($ret != FTP_FINISHED) {
echo "There was an error uploading the file...";
exit(1);
}
?>参考
- ftp_nb_fput() - オープン中のファイルを FTP サーバーに保存する（非ブロッキング）
- ftp_nb_continue() - ファイルの取得/送信を継続する（非ブロッキング）
- ftp_put() - FTP サーバーにファイルをアップロードする
- ftp_fput() - オープン中のファイルを FTP サーバーにアップロードする
＋add a note
User Contributed Notes 6 notes
ted at hostleft dot com ¶
19 years ago
If you receive an error like:
Warning: ftp_nb_put(): Unable to service PORT commands in /path/to/file.php on line 27
verify whether you need to be in PASV mode. You can go into PASV mode by declaring
> ftp_pasv($cnx,TRUE);
manu at manux dot org ¶
19 years ago
When using non blocking functions if you try to disconnect while your non blocking operation is in progress the disconnect command will not work until the operation is not finished.
Ariel asphp at dsgml dot com ¶
18 years ago
Don't add a sleep() inside the loop. If you do you will severely slow down the upload.
In my tests, each time through the loop it send about 2.5K, looping about 220 times per second. (Which is very little.)
You won't necessarily get the same numbers as me per loop, but clearly PHP does it's own management of the loop so that you don't consume all the CPU on the server.
WebSee.ru ¶
15 years ago
How to realize the possibility of transferring data from one FTP-server to another via FXP:
<?php
// ...
$ansver = ftp_raw($ftp_conn1, 'PASV');
if (intval($ansver[0]) == 227) {
ftp_raw($ftp_conn2, 'PORT '.substr($ansver[0], $n = strpos($ansver[0], '(') + 1, strpos($m[0], ')', $n) - $n));
ftp_raw($ftp_conn1, 'STOR '.$filename); // need asynchronously (non-blocking)
ftp_raw($ftp_conn2, 'RETR '.$filename);
}
?>
kaiohken1982 at hotmail dot com ¶
18 years ago
Hi,
I tried to use both ftp_put() and ftp_nb_put() adding the
variable $start = date("Y:m:d h:i:s"); at the begin of the script and the variable $end = date("Y:m:d h:i:s"); at its end, after the file upload function.
With the gprs connection I'm now using and trying to upload a .jpg file of 67,5 kb the time difference between $start and $end was 40 seconds in both cases, so I can suppose that there is no difference between these upload function.
The difference comes if you put anything inside the while ($ftp_upload == FTP_MOREDATA) loop.
I hope this note can help.
Regards
brandon dot farber at gmail dot com ¶
18 years ago
I couldn't see this noted anywhere...
ftp_nb_put apparently takes a much much longer time to upload the file than ftp_put (I haven't done any packet sniffing or logging tests to find out why). I was using a script, nearly identical to the example above, and a 100KB file had only uploaded 3.99KB after about 8 minutes! The php script naturally timed out before it was complete.
I changed my function to use ftp_put, got rid of the loop to check FTP_MOREDATA (as you will see in the example above), and the same script uploaded 2.2MB within 30 seconds with no other changes.
If you're using this function instead of ftp_put *purely to try to speed up your script* and it's taking a long time, you might want to try ftp_put instead.