PHP ftp_cdup() Function

The ftp_cdup() function is used to change the current directory to the parent directory. This function was introduced in PHP 4.

Syntax:

Parameter	Description	Is compulsory
ftp_stream	The link identifier of the FTP connection.	compulsory

Returns

The ftp_cdup( ) function returns TRUE on success or FALSE on failure.

Example 1

<?php
// set up basic connection
$conn_id = ftp_connect($ftp_server);
// login with username and password
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
// change the current directory to html
ftp_chdir($conn_id, 'html');
echoftp_pwd($conn_id); // /html 
// return to the parent directory
if (ftp_cdup($conn_id)) 
{ 
echo "cdup successful\n";
} 
else
{
echo "cdup not successful\n";
}
echoftp_pwd($conn_id); // /
ftp_close($conn_id);
?>

Explanation

In the above example, by using the ftp_cdup() function we change the current directory to the parent directory.

Example 2

<?php
$conn = ftp_connect("ftp.testftp.com") or die("Could not connect");
ftp_login($conn,"admin","ert456");
//Outputs the current directory
echo "Dir: ".ftp_pwd($conn);
echo "<br />";
//Change to the images directory
ftp_chdir($conn,"images");
echo "Dir: ".ftp_pwd($conn);
echo "<br />";
//Change current directory to parent directory
ftp_cdup($conn);
echo "Dir: ".ftp_pwd($conn);
ftp_close($ftp_server);
?>

Explanation

In the above example, by using ftp_chdir( ) function we change the directory and after that by using ftp_cdup( ) function we change the directory to the parent.

Example 3

<?php
// connect and login to FTP server
$ftp_server = "ftp.example.com";
$ftp_conn = ftp_connect($ftp_server) or die("Could not connect to $ftp_server");
$login = ftp_login($ftp_conn, $ftp_username, $ftp_userpass);
// change the current directory to php
ftp_chdir($ftp_conn, "php");
// change to the parent directory
if (ftp_cdup($ftp_conn))
	{ 
echo "Successfully changed to parent directory.";
	}
else
	{
echo "cdup failed.";
	}
// output current directory name
echoftp_pwd($ftp_conn);
// close connection
ftp_close($ftp_conn);
?>