FTP Functions
Online : zh en
PHP Manual


(PHP 4, PHP 5)

ftp_pasvTurns passive mode on or off


bool ftp_pasv ( resource $ftp_stream , bool $pasv )

ftp_pasv() turns on or off passive mode. In passive mode, data connections are initiated by the client, rather than by the server. It may be needed if the client is behind firewall.

Please note that ftp_pasv() can only be called after a successfull login or otherwise it will fail.



The link identifier of the FTP connection.


If TRUE, the passive mode is turned on, else it's turned off.

Return Values

Returns TRUE on success or FALSE on failure.


Example #1 ftp_pasv() example

$remote_file 'readme.txt';

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

// turn passive mode on

// upload a file
if (ftp_put($conn_id$remote_file$fileFTP_ASCII)) {
"successfully uploaded $file\n";
} else {
"There was a problem while uploading $file\n";

// close the connection

FTP Functions
Online : zh en
PHP Manual
PHP ÷≤Š - N: Turns passive mode on or off

User contributed notes:

mac at codegreene dot com (09-Jul-2010 11:20)

I found one place that required passive mode to function properly, but the initial error manifested itself in an odd way:

PHP Warning:  ftp_put(): TYPE is now ASCII in <file.php> on line <#>


PHP Warning:  ftp_put(): TYPE is now 8 BIT BINARY in <file.php> on line <#>

The other symptom is that it was taking a long time, perhaps the 90 seconds that the timeout was set to. No errors occurred upon connect, just when I tried ftp_put().

Once I turned on ftp_pasv() it worked, both in the place where active mode worked, and on the server where active mode wouldn't work.

Anonymous (04-Sep-2009 06:45)

If you find that you are receiving "Illegal PORT command" errors you may want to try enabling passive mode.

ybourbeau at edison dot ca (08-Apr-2002 11:28)

Directly from bsd FTP manual pages:

The PASV command requests that the remote server open a port for the data connection and return the address of that port.  The remote server listens on that port and the client connects to it.

                 When using the more traditional PORT command, the client listens on a port and sends that address to the remote server, who connects back to it.  Passive mode is useful when using ftp through a gateway router or host that controls the directionality of traffic.  (Note that though ftp servers are required to support the PASV command by RFC 1123, some do not.)

(04-Apr-2002 12:19)

PASV: For ftp users behind firewall, the server LISTEN for a connection.

Non-PASV: The client LISTEN for a connection from server.