ftp_pasv

Turns passive mode on or off

&reftitle.description; `bool` `ftp_pasv` `FTP\Connection` `ftp` `bool` `enable`

`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 successful login or otherwise it will fail.

&reftitle.parameters;

`ftp`

- &ftp.parameter.ftp;

`enable`

- If &true;, the passive mode is turned on, else it's turned off.

&reftitle.returnvalues;

&return.success;

&reftitle.changelog;

&Version; | &Description;
&ftp.changelog.ftp-param;

&reftitle.examples;

### `ftp_pasv` example

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

    // set up basic connection
    $ftp = ftp_connect($ftp_server);

    // login with username and password
    $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

    // turn passive mode on
    ftp_pasv($ftp, true);

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

    // close the connection
    ftp_close($ftp);
    ?>