XXXIII. 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.

Requirements

The FTP-extension has no special requirements. It's completely contained in PHP.

Installation

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.

Configuration

Toto roz╣φ°enφ nemß definovßno ╛ßdnΘ konfiguraΦnφ direktivy.

Resource types

This extension uses one resource-type, which is the link-identifier of the ftp-connection.

Constants

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

Example

P°φklad 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_close($conn_id); 
?>

Obsah
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_close — Closes an FTP connection
ftp_quit — Closes an FTP connection
ftp_exec — Request execution of a program on the FTP server
ftp_set_option — Set miscellaneous runtime FTP options
ftp_get_option — Retrieves various runtime behaviours of the current FTP stream