ftp_chdir

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

ftp_chdirModifie 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 ressource é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

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
15 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.]
To Top