ftp_pasv

(PHP 4, PHP 5)

ftp_pasv — Włącza lub wyłącza tryb pasywny

Opis

bool ftp_pasv ( resource $strumień_ftp , bool $pasv )

ftp_pasv() włącza lub wyłącza tryb pasywny, w którym połączenia danych inicjowane są przez klienta, a nie przez serwer. Tryb taki może być niezbędny, jeśli klient jest za firewallem.

Proszę zauważyć, że ftp_pasv() może być wywołana wyłącznie po prawidłowym zalogowaniu się w innym przypadku zawiedzie.

Parametry

strumień_ftp: Identyfikator połączenia z serwerem FTP.
pasv: Jeśli argument ten ma wartośc TRUE, tryb pasywny jest włączany. Jeśli nie, zostaje wyłączony.

Zwracane wartości

Zwraca TRUE w przypadku powodzenia, FALSE w przypadku błędu.

Przykłady

Przykład #1 Przykład użycia ftp_pasv()


<?php
$plik = 'plik.txt';
$plik_zdalny = 'readme.txt';

// nawiązanie połączenia
$conn_id = ftp_connect($ftp_server);

// logowanie
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// włączenie trybu pasywnego
ftp_pasv($conn_id, true);

// przesłanie pliku
if (ftp_put($conn_id, $plik_zdalny, $plik, FTP_ASCII)) {
 echo "Plik $plik został pomyślnie przesłany\n";
} else {
 echo "Napotkano problemy w czasie przesyłania pliku $plik\n";
}

// zamknięcie połączenia
ftp_close($conn_id);
?>

ftp_put

ftp_nlist

[edit] Last updated: Fri, 23 Mar 2012

add a note User Contributed Notes ftp_pasv

mac at codegreene dot com 09-Jul-2010 06: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 <#>



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.

Anonymous 04-Sep-2009 01: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 05: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.)

03-Apr-2002 06:19


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



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

add a note