ftp_close
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;
}
?>
ftp_connect
(PHP 4, PHP 5)
ftp_connect — Stellt eine FTP-Verbindung her
Beschreibung
resource ftp_connect
( string
$host
[, int $port = 21
[, int $timeout = 90
]] )
ftp_connect() stellt eine FTP-Verbindung zum angegebenen
host her.
Parameter-Liste
-
host -
Die Adresse des FTP-Servers. Dieser Parameter sollte keinen abschließenden Schrägstrich und kein vorangestelltes ftp:// haben.
-
port -
Gibt einen alternativen Port für die Verbindung an. Fehlt er oder wird er auf 0 gesetzt, wird der Standard-FTP-Port 21 benutzt.
-
timeout -
Dieser Parameter bestimmt den Timeout für alle nachfolgenden Netzwerktätigkeiten. Falls er fehlt, wird er auf den Standardwert von 90 Sekunden gesetzt. Der Timeout kann jederzeit mittels ftp_set_option() gesetzt und mittels ftp_get_option() abgefragt werden.
Rückgabewerte
Gibt bei Erfolg einen FTP-Stream zurück oder FALSE, falls ein Fehler
auftrat.
Beispiele
Beispiel #1 ftp_connect()-Beispiel
<?php
$ftp_server = "ftp.example.com";
// stelle eine Verbindung her
$verbindungskennung = ftp_connect($ftp_server) or die("Konnte keine Verbindung zu $ftp_server aufbauen");
?>
Changelog
| Version | Beschreibung |
|---|---|
| 4.2.0 |
timeout hinzugefügt.
|
Siehe auch
- ftp_close() - Schließt eine FTP-Verbindung
- ftp_ssl_connect() - Öffnet eine sichere SSL-FTP-Verbindung
add a note
User Contributed Notes
ftp_connect - [5 notes]
sean at boyercentral dot net ¶
4 years ago
rainer at justchords dot com ¶
9 years ago
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 ...
jcornell att chapter zero dot com ¶
2 years ago
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'); ?>
brandon dot farber at gmail dot com ¶
7 years ago
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.