ftp_put

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_put — FTP サーバーにファイルをアップロードする

説明

ftp_put(
    FTP\Connection $ftp,
    string $remote_filename,
    string $local_filename,
    int $mode = FTP_BINARY,
    int $offset = 0
): bool

ftp_put() ローカルファイルを FTP サーバーに保存します。

パラメータ

ftp

FTP\Connection クラスのインスタンス

remote_filename

リモートファイルのパス。

local_filename

ローカルファイルのパス。

mode

転送モード。FTP_ASCII または FTP_BINARY のどちらかを指定する必要があります。

offset

リモートファイル内での、アップロード開始位置。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン 説明
8.1.0 引数 ftp は、FTP\Connection のインスタンスを期待するようになりました。 これより前のバージョンでは、リソース を期待していました。
7.3.0 mode パラメータはオプションになりました。 これより前のバージョンでは、このパラメータは必須でした。

例

例1 ftp_put() の例

<?php
$file = 'somefile.txt';
$remote_file = 'readme.txt';

// 接続を確立する
$ftp = ftp_connect($ftp_server);

// ユーザー名とパスワードでログインする
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// ファイルをアップロードする
if (ftp_put($ftp, $remote_file, $file, FTP_ASCII)) {
 echo "successfully uploaded $file\n";
} else {
 echo "There was a problem while uploading $file\n";
}

// 接続を閉じる
ftp_close($ftp);
?>

参考

  • ftp_pasv() - パッシブモードをオンまたはオフにする
  • ftp_fput() - オープン中のファイルを FTP サーバーにアップロードする
  • ftp_nb_fput() - オープン中のファイルを FTP サーバーに保存する（非ブロッキング）
  • ftp_nb_put() - FTP サーバーにファイルを保存する（非ブロッキング）

関連キーワード: 　サーバー, put, ファイル, filename, 保存, Connection, バージョン, mode, パラメータ, オープン