Edit Report a Bug

    ftp_chdir

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

    ftp_chdir — Wechselt das Verzeichnis auf einem FTP-Server

    Beschreibung

    ftp_chdir(FTP\Connection $ftp, string $directory): bool

    Wechselt vom aktuellen Verzeichnis in das angegebene Verzeichnis.

    Parameter-Liste

    ftp

    Eine FTP\Connection-Instanz.

    directory

    Das Verzeichnis, in das gewechselt werden soll.

    Rückgabewerte

    Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben. Wenn der Verzeichniswechsel fehlschlägt, wird eine PHP-Warnung ausgegeben.

    Changelog

    Version Beschreibung
    8.1.0 Der Parameter ftp erwartet nun eine FTP\Connection-Instanz; vorher wurde eine Ressource erwartet.

    Beispiele

    Beispiel #1 ftp_chdir()-Beispiel

    <?php

    // Verbindung aufbauen
    $ftp = ftp_connect($ftp_server);

    // Login mit Benutzername und Passwort
    $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

    // Verbindung überprüfen
    if ((!$ftp) || (!$login_result)) {
    die(    "FTP-Verbindungsaufbau ist fehlgeschlagen!");
    }

    echo     "Aktuelles Verzeichnis: " . ftp_pwd($ftp) . "\n";

    // Versuche in das Verzeichnis "irgendwo" zu wechseln
    if (ftp_chdir($ftp, "irgendwo")) {
    echo     "Aktuelles Verzeichnis: " . ftp_pwd($ftp) . "\n";
    } else {
    echo     "Verzeichniswechsel ist fehlgeschlagen.\n";
    }

    // Verbindung schließen
    ftp_close($ftp);
    ?>

    Siehe auch

    • ftp_cdup() - Wechselt in das darüberliegende Verzeichnis
    • ftp_pwd() - Liefert den aktuellen Verzeichnisnamen

    add a note add a note

    User Contributed Notes 2 notes

    up
    9
    neil at 11 out of 10
    16 years ago
    Thanks to h3 at valleyfield dot net

    Same function with some minor changes and comments added

    FTP function checks if a directory exists

    <?php
    function ftp_is_dir( $dir ) {
        global     $ftpcon;
            // get current directory
            $original_directory = ftp_pwd( $ftpcon );
            // test if you can change directory to $dir
        // suppress errors in case $dir is not a file or not a directory
            if ( @ftp_chdir( $ftpcon, $dir ) ) {
                // If it is a directory, then change the directory back to the original directory
                ftp_chdir( $ftpcon, $original_directory );
            return     true;
        }
        else {
            return     false;
        }       
    }
    ?>
    up
    1
    info at swiftyexpress dot com
    16 years ago
    Works like the other functions in this page's notes, but this one doesn't make use of a global FTP connection, so it takes parameters like the other functions in the extension

    <?php
    function ftp_directory_exists($ftp, $dir)
    {
            // Get the current working directory
            $origin = ftp_pwd($ftp);
       
            // Attempt to change directory, suppress errors
            if (@ftp_chdir($ftp, $dir))
        {
                // If the directory exists, set back to origin
                ftp_chdir($ftp, $origin);   
            return     true;
        }

            // Directory does not exist
            return false;
    }
    ?>


    [NOTE BY danbrown AT php DOT net: As the contributor mentions, the original function was noted here by (h3 AT valleyfield DOT net) on 13-JUL-2007.]
    add a note add a note
    To Top