PHP 8.4.1 Released!

ftp_pasv

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_pasvSchaltet den passiven Modus ein oder aus

Beschreibung

ftp_pasv(FTP\Connection $ftp, bool $enable): bool

ftp_pasv() schaltet den passiven Modus ein oder aus. Im passiven Modus werden Datenverbindungen durch den Client initiiert und nicht durch den Server. Dies kann notwendig sein, wenn sich der Client hinter einer Firewall befindet.

Bitte beachten Sie, dass ftp_pasv() nur nach einem erfolgreichen Login aufgerufen werden kann. Andernfalls wird der Aufruf fehlschlagen.

Parameter-Liste

ftp

Eine FTP\Connection-Instanz.

enable

Wenn true, wird der passive Modus aktiviert, sonst wird er deaktiviert.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.1.0 Der Parameter ftp erwartet nun eine FTP\Connection-Instanz; vorher wurde eine Ressource erwartet.

Beispiele

Beispiel #1 ftp_pasv()-Beispiel

<?php
$file
= 'somefile.txt';
$remote_file = 'readme.txt';

// Verbindung aufbauen
$ftp = ftp_connect($ftp_server);

// Login mit Benutzername und Passwort
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// Schalte passiven Modus ein
ftp_pasv($ftp, true);

// Lade eine Datei hoch
if (ftp_put($ftp, $remote_file, $file, FTP_ASCII)) {
echo
"$file erfolgreich hochgeladen\n";
} else {
echo
"Ein Fehler trat beim Hochladen von $file auf\n";
}

// Verbindung schließen
ftp_close($ftp);
?>

add a note

User Contributed Notes 8 notes

up
49
carda at two-wings dot net
10 years ago
It should be noted that ftp_pasv has to be called AFTER ftp_login (not after ftp_connect). May seem obvious to many but it took me three hours to find out...
up
4
rrehbein at officesupply dot com
6 years ago
For some FTP servers, it seems the sequence of passive and other commands matters more than for other FTP servers. Sorry, I don't know what vendor or version specifically.

<?php
ftp_pasv
($handle, true);
echo
"System type: ".ftp_systype($handle).PHP_EOL;
ftp_fput($handle, 'example.txt', $stream, FTP_BINARY);
?>

> PHP Warning: ftp_fput(): STOR out of sequence.

<?php
echo "System type: ".ftp_systype($handle).PHP_EOL;
ftp_pasv($handle, true);
ftp_fput($handle, 'example.txt', $stream, FTP_BINARY);
?>

> no issue
up
0
sameg14 at gmail dot com
10 years ago
If you are running filezilla in passive mode, on windows, and try to connect using PHP, you might encounter an error that reads "425 Can't open data connection for transfer of ..."
This error is not indicative of a passive mode issue, but can be resolved by using
<?php
ftp_pasv
($conn, true);
?>
up
0
marc at gutt dot it
11 years ago
If you are still having problems after choosing ftp_pasv() you should refresh the connection through ftp_close() / ftp_connect() after x files and/or y GB have been transfered.

It solved several (random) occurring problems like:

ftp_get(): Opening BINARY mode data connection

ftp_get(): Entering Passive Mode

Hint: fopen() created a file so don't forget to delete it if an error occurred ;)
up
0
Anonymous
22 years ago
PASV: For ftp users behind firewall, the server LISTEN for a connection.

Non-PASV: The client LISTEN for a connection from server.
up
-2
Anonymous
15 years ago
If you find that you are receiving "Illegal PORT command" errors you may want to try enabling passive mode.
up
-4
mac at codegreene dot com
14 years ago
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 <#>

or

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.
up
-2
ybourbeau at edison dot ca
22 years ago
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.)
To Top