XXVIII. FTP functions

The functions in this extension implement client access to file servers speaking the File Transfer Protocol FTP as defined in http://www.faqs.org/rfcs/rfc959.html.

The following constants are defined when using the FTP module: FTP_ASCII and FTP_BINARY.

In order to use FTP functions with your PHP configuration, you should add the --enable-ftp option when installing PHP 4, and --with-ftp when using PHP 3.

Example 1. ftp() example


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

// check connection
if ((!$conn_id) || (!$login_result)) { 
        echo "Ftp connection has failed!";
        echo "Attempted to connect to $ftp_server for user $ftp_user_name"; 
        die; 
    } else {
        echo "Connected to $ftp_server, for user $ftp_user_name";
    }

// upload the file
$upload = ftp_put($conn_id, "$destination_file", "$source_file", FTP_BINARY); 

// check upload status
if (!$upload) { 
        echo "Ftp upload has failed!";
    } else {
        echo "Uploaded $source_file to $ftp_server as $destination_file";
    }

// close the FTP stream 
ftp_quit($conn_id); 
?>
     

Table of Contents
ftp_connect -- Opens up an FTP connection
ftp_login -- Logs in an FTP connection
ftp_pwd -- Returns the current directory name
ftp_cdup -- Changes to the parent directory
ftp_chdir -- Changes directories on a FTP server
ftp_mkdir -- Creates a directory
ftp_rmdir -- Removes a directory
ftp_nlist -- Returns a list of files in the given directory.
ftp_rawlist --  Returns a detailed list of files in the given directory.
ftp_systype --  Returns the system type identifier of the remote FTP server.
ftp_pasv -- Turns passive mode on or off.
ftp_get -- Downloads a file from the FTP server.
ftp_fget -- Downloads a file from the FTP server and saves to an open file.
ftp_put -- Uploads a file to the FTP server.
ftp_fput -- Uploads from an open file to the FTP server.
ftp_size -- Returns the size of the given file.
ftp_mdtm -- Returns the last modified time of the given file.
ftp_rename -- Renames a file on the ftp server.
ftp_delete -- Deletes a file on the ftp server.
ftp_site -- Sends a SITE command to the server.
ftp_quit -- Closes an FTP connection