ftp_chdir

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

    ftp_chdir — Modifie le dossier FTP courant

    Description

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

    ftp_chdir() modifie le dossier courant en directory.

    Liste de paramètres

    ftp

    Une instance de FTP\Connection.

    directory

    Le dossier cible.

    Valeurs de retour

    Cette fonction retourne true en cas de succès ou false si une erreur survient. Si le changement échoue, PHP lancera également une alerte.

    Historique

    Version Description
    8.1.0 La paramètre ftp attend désormais une instance de FTP\Connection ; auparavant, une resource était attendu.

    Exemples

    Exemple #1 Exemple avec ftp_chdir()

    <?php

    // Mise en place d'une connexion basique
    $ftp = ftp_connect($ftp_server)

    // Identification avec un nom d'utilisateur et un mot de passe
    $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

    // Vérification de la connexion
    if ((!$ftp) || (!$login_result)) {
    die(    "Echec de la connexion FTP !");
    }

    echo     "Dossier courant : " . ftp_pwd($ftp) . "\n";

    // Tentative de modification du dossier en "somedir"
    if (ftp_chdir($ftp, "somedir")) {
    echo     "Le dossier courant est maintenant : " . ftp_pwd($ftp) . "\n";
    } else {
    echo     "Impossible de changer de dossier\n";
    }

    // Fermeture de la connexion
    ftp_close($ftp);
    ?>

    Voir aussi

    • ftp_cdup() - Change de dossier et passe au dossier parent
    • ftp_pwd() - Retourne le nom du dossier courant

    Found A Problem?

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

    User Contributed Notes 2 notes

    up
    6
    neil at 11 out of 10
    17 years ago
    Thanks to h3 at valleyfield dot netSame function with some minor changes and comments addedFTP function checks if a directory exists<?phpfunction 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
    3
    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
    To Top