XXXIII. FTP functions

Introduction

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

These functions are available as part of the standard module , which is always available .

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 .

Runtime Configuration

This extension does not define any configuration directives .

Resource Types

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

Predefined Constants

These constants are defined by this extension , and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime .

FTP_ASCII ( integer )

FTP_TEXT ( integer )

FTP_BINARY ( integer )

FTP_IMAGE ( integer )

FTP_TIMEOUT_SEC ( integer )

Examples

דוגמה 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)

 
;

 
/

 
/

 
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)

 
;

 
?





תוכן העניינים:
ftp_cdup -- Changes to the parent directory
ftp_chdir -- Changes directories on a FTP server
ftp_close -- Closes an FTP connection
ftp_connect -- Opens up an FTP connection
ftp_delete -- Deletes a file on the FTP server
ftp_exec -- Request execution of a program on the FTP server
ftp_fget -- Downloads a file from the FTP server and saves to an open file
ftp_fput -- Uploads from an open file to the FTP server
ftp_get -- Downloads a file from the FTP server
ftp_get_option -- Retrieves various runtime behaviours of the current FTP stream
ftp_login -- Logs in an FTP connection
ftp_mdtm -- Returns the last modified time of the given file
ftp_mkdir -- Creates a directory
ftp_nlist -- Returns a list of files in the given directory
ftp_pasv -- Turns passive mode on or off
ftp_put -- Uploads a file to the FTP server
ftp_pwd -- Returns the current directory name
ftp_quit -- Closes an FTP connection
ftp_rawlist -- Returns a detailed list of files in the given directory
ftp_rename -- Renames a file on the FTP server
ftp_rmdir -- Removes a directory
ftp_set_option -- Set miscellaneous runtime FTP options
ftp_site -- Sends a SITE command to the server
ftp_size -- Returns the size of the given file
ftp_systype -- Returns the system type identifier of the remote FTP server