PHP 8.1.24 Released!
    Submit a Pull Request Report a Bug

    ftp_connect

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

    ftp_connect — Opens an FTP connection

    Descrição

    ftp_connect(string $hostname, int $port = 21, int $timeout = 90): FTP\Connection|false

    ftp_connect() opens an FTP connection to the specified hostname.

    Parâmetros

    hostname

    The FTP server address. This parameter shouldn't have any trailing slashes and shouldn't be prefixed with ftp://.

    port

    This parameter specifies an alternate port to connect to. If it is omitted or set to zero, then the default FTP port, 21, will be used.

    timeout

    This parameter specifies the timeout in seconds for all subsequent network operations. If omitted, the default value is 90 seconds. The timeout can be changed and queried at any time with ftp_set_option() and ftp_get_option().

    Valor Retornado

    Returns an FTP\Connection instance on success, ou false em caso de falha.

    Changelog

    Versão Descrição
    8.1.0 Returns an FTP\Connection instance now; previously, a resource was returned.

    Exemplos

    Exemplo #1 ftp_connect() example

    <?php

    $ftp_server     = "ftp.example.com";

    // set up a connection or die
    $ftp = ftp_connect($ftp_server) or die("Couldn't connect to $ftp_server");

    ?>

    Veja Também

    ＋add a note

    User Contributed Notes 3 notes

    up
    14
    sean at boyercentral dot net
    14 years ago
    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;
    }
    ?>
    up
    -9
    edouard at e-gaulue dot com
    2 years ago
    On server with multiple network card, is there a way to choose the interface to use ?
    up
    -14
    rafael at gawenda dot es
    3 years ago
    Sean's example is wrong, because it includes the protocol match, so result would be php_network_getaddresses: getaddrinfo failed: Name or service not known
    ＋add a note
    To Top