ftp_connect

(PHP 4, PHP 5)

ftp_connect — Opens an FTP connection

Opis

resource ftp_connect ( string $host [, int $port [, int $timeout ]] )

ftp_connect() otwiera połączenie z serwerem FTP podanym jak argument.

Parametry

host: Adres serwera ftp. Wartość tego argumentu nie powinna mieć żadnych znaków przed nazwą hosta, jak również nie powinien zaczynać się od ftp://.
port: Argument ten określa port, z którym ma nastąpić połączenie. Jeśli argument ten zostanie pominięty, albo podana zostanie wartość zero, użyty zostanie domyślny port usługi FTP, czyli 21.
timeout: Argument ten określa maksymalny czas, jaki mogą zająć wszystkie następujace po sobie operacje sieciowe. Jeśli argument ten zostanie pominięty, uznana zostanie domyślna wartość 90 sekund. Wartość ta może być później odczytana i zmieniona za pomocą funkcji ftp_set_option() i ftp_get_option().

Zwracane wartości

W przypadku powodzenia zwraca strumień FTP lub FALSE w przypadku błędu.

Przykłady

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


<?php

$ftp_server = "ftp.example.com";

// nawiąż połączenie lub zakończ pracę.
$conn_id = ftp_connect($ftp_server) or die("Nie można nawiązać połączenia z $ftp_server"); 

?>

Rejestr zmian

Wersja	Opis
4.2.0	Dodany parametr `timeout`.

Zobacz też:

ftp_close() - Zamyka połączenie FTP
ftp_ssl_connect() - Opens an Secure SSL-FTP connection

ftp_delete

ftp_close

[edit] Last updated: Fri, 10 Feb 2012

add a note User Contributed Notes ftp_connect

jcornell att chapter zero dot com 19-Aug-2010 10:48


Although an FTP port is always a number, if you specify it as one like this:





<?php $ftp = ftp_connect('example.com',210); ?>





You'll get a non-intuitive error. This, however, works [note the quotes]:





<?php $ftp = ftp_connect('example.com','210'); ?>

sean at boyercentral dot net 24-Mar-2009 05:05


Ever needed to create an FTP connection resource defaulted to a particular dir from a URI? Here's a simple function that will take a URI like ftp://username:password@subdomain.example.com/path1/path2/, and return an FTP connection resource.





<?php


function getFtpConnection($uri)


{


    // Split FTP URI into:


    // $match[0] = ftp://username:password@sld.domain.tld/path1/path2/


    // $match[1] = ftp://


    // $match[2] = username


    // $match[3] = password


    // $match[4] = sld.domain.tld


    // $match[5] = /path1/path2/


    preg_match("/ftp:\/\/(.*?):(.*?)@(.*?)(\/.*)/i", $uri, $match);





    // Set up a connection


    $conn = ftp_connect($match[1] . $match[4] . $match[5]);





    // Login


    if (ftp_login($conn, $match[2], $match[3]))


    {


        // Change the dir


        ftp_chdir($conn, $match[5]);





        // Return the resource


        return $conn;


    }





    // Or retun null


    return null;


}


?>

brandon dot farber at gmail dot com 10-Oct-2005 12:06


In testing, I have been unable to establish any socket connections (including FTP connections) on shutdown.  This is important if you are trying to save the FTP transfer to run after the php script has been executed (using register_shutdown_function).  I am unaware of any configuration options that control this, and I have found this affects any socket connections I have tried to establish after shutdown.



The same code works fine if it is executed at runtime, rather than on shutdown.  Since I found no documentation of this behavior, I felt it important to note somewhere.  May also be useful if this was crosslinked to fsockopen comments as well.

rainer at justchords dot com 11-Nov-2003 03:07


Connecting through a firewall also depends on the type. This is an example for the Secure Gateway FTP. First you have to connect to the firewall, then open a session to the destination ftp server. This looks like this:



// Connect to firewall

$conn_id = ftp_connect("firewall.yournet.com"); 



// Open a session to an external ftp site

$login_result = ftp_login ($conn_id, "userid@externalhost.com", "password"); 



// Check open

if ((!$conn_id) || (!$login_result)) { 

        echo "Ftp-connect failed!"; die; 

    } else {

        echo "Connected.";

    }



// turn on passive mode transfers

ftp_pasv ($conn_id, true) ;



... and go on ...

thomas g. 03-Mar-2003 03:35


always keep an eye on the ftp_pasv function, if you are behind a firewall or nat'ed and your scripts won't do a listing or put files to the ftp

add a note