PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    ftp_rename

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

    ftp_rename — FTP サーバー上のファイルまたはディレクトリの名前を変更する

    説明

    ftp_rename(FTP\Connection $ftp, string $from, string $to): bool

    ftp_rename() は FTP サーバー上のファイルやディレクトリの 名前を変更します。

    パラメータ

    ftp

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

    from

    現在のファイル/ディレクトリの名前。

    to

    新しい名前。

    戻り値

    成功した場合に true を、失敗した場合に false を返します。 失敗したとき(存在しないファイルを変更しようとしたときなど) は、 E_WARNING レベルのエラーが発生します。

    変更履歴

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

    例

    例1 ftp_rename() の例

    <?php
    $old_file     = 'somefile.txt.bak';
    $new_file = 'somefile.txt';

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

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

    // $old_file を $new_file に変更することを試みる
    if (ftp_rename($ftp, $old_file, $new_file)) {
    echo     "Successfully renamed $old_file to $new_file\n";
    } else {
    echo     "There was a problem while renaming $old_file to $new_file\n";
    }

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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 4 notes

    up
    3
    Hugo locobyte at hotmail dot NO_SPAM dot com
    22 years ago
    Using "ftp_rename" to move files to other directories on server ftp
    ..
    ...
    if(ftp_rename($conn_ftp, $xfiles[$i], "./dirx/".$xfiles[$i])) {
    echo "File $xfiles[$i] moved to ./dirx";
    } else {
    echo "ERROR!!!. The file could not be moved";
    }
    ...
    ..
    #-->>h2m, bye
    up
    2
    alishahnovin at hotmail dot com
    17 years ago
    You want to make sure you check the existence of the new name before renaming files, because otherwise you could risk losing files. Just do a simple check with ftp_size with the new name. If it's !=-1, you're going to want to throw some kind of error, otherwise you'll be losing a file...
    up
    2
    Hazem dot Khaled at gmail dot com
    18 years ago
    to rename the file or folder you should use ftp_chdir to select the current directory on ftp server or you should write the full path to file in old name and in new name

    Ex. 1
    <?php
    // open the folder that have the file
    ftp_chdir($conn_id, '/www/ftp-filemanager/');

    // rename the file
    ftp_rename($conn_id, 'file1.jpg', 'new_name_4_file.jpg');
    ?>

    or write full path Ex. 2
    <?
    // rename the file
    ftp_rename($conn_id, '/www/ftp-filemanager/file1.jpg', '/www/ftp-filemanager/new_name_4_file.jpg');
    ?>
    up
    -1
    aventaria at hotmxxx dot com
    17 years ago
    This function isn't only able to rename files, but also folders. And it is not only able to rename them, but also move them, and, in the case of folders, their contents as well (so folders don't have to be empty to move). For example:

    <?php
    ftp_rename    ($conn_id, "./dir1/dir2/", "./dir3/");
    ?>

    Now the folder dir2 (which prevously was in folder dir1) has moved to the same folder as dir1, and it has kept its original contents (the content just moved along).
    ＋add a note
    To Top