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

Found A Problem?

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

＋add a note

User Contributed Notes 2 notes

down

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;
    }        
} 
?>

down

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