ftp_chdir

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

ftp_chdir — Changes the current directory on a FTP server

Description

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

Changes the current directory to the specified one.

Parameters

ftp: An FTP\Connection instance.
directory: The target directory.

Return Values

Returns true on success or false on failure. If changing directory fails, PHP will also throw a warning.

Changelog

Version	Description
8.1.0	The `ftp` parameter expects an FTP\Connection instance now; previously, a resource was expected.

Examples

Example #1 ftp_chdir() example

<?php

// set up basic connection
$ftp = ftp_connect($ftp_server); 

// login with username and password
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass); 

// check connection
if ((!$ftp) || (!$login_result)) {
 die("FTP connection has failed !");
}

echo "Current directory: " . ftp_pwd($ftp) . "\n";

// try to change the directory to somedir
if (ftp_chdir($ftp, "somedir")) {
 echo "Current directory is now: " . ftp_pwd($ftp) . "\n";
} else { 
 echo "Couldn't change directory\n";
}

// close the connection
ftp_close($ftp);
?>