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

See Also